Genesys Cloud - Developer Community!

Hi!

due to request of our customers we would like to implement sending/receiving sms messages (yes, it's doubled wording) with European providers using REST-API.

Beside the integrated US messaging providers Facebook, Instagram and WhatsApp, there is also an "Open Messaging" platform at Genesys Cloud Admin > Message > Platforms.

I've setup a new "Open Messaging" integration for sms Provider "Link Mobility" with 
- Outbound Notification Webhook URL: https://api.linkmobility.eu/rest/smsmessaging/simple
- Outbound Notification Webhook Signature Secret Token: <the token created at the Link Mobility website>
- Supported Content Profile: Link Mobility Content Profile (like the "default")
- Platform Config: Link Mobility Platform Settings

When I try to send a message as an agent with type "Open Messaging", on behalf of a queue and a destination number, an "Open Messaging Interaction" window appears where I can send a message. With sending the message, the message never reaches my cell phone.

Using Postman to check the Link Mobility API setup, I can send and receive sms without any problem.

I've tried to understand the documentation at Genesys Cloud Resource Center - About open messaging and Genesys Cloud Developer Center - Open Messaging, but I couldn't figure out how to setup the required data structure for the API call to the provider.
E.g. sending the recipient number and the message content/body as Header or query parameters.

Does anyone has any experience using "Open Messaging"???

THANKS!!!

BR, Robert

#openmessaging #sms #SMSMessage #SMSProviders #HowTo #Link

#API/Integrations
#DigitalChannels
#Implementation

Hello Robert,

I've moved your post over to our new Genesys Cloud - Developer Community. Hopefully someone will have an idea of how you can accomplish this via API.

------------------------------
Jason Kleitz
Online Community Manager/Moderator
------------------------------

Hello,

I am not familiar with Link Mobility API and its Authentication/Authorization process.

But I think you may be confusing what the Outbound Notification Webhook Signature Secret Token is. It is not an API Key equivalent - I mean it is not sending the secret token in an HTTP Header. Its purpose is not about authorization (like an API Key sent via a specific HTTP Header name).

Each webhook notification with its message will contain a signature (sent through X-Hub-Signature-256 header). Along with the secret token that you have set in the Open Messaging configuration, it will allow to validate the message with its signature. You can find a code description here: https://developer.genesys.cloud/commdigital/digital/openmessaging/validate#validate-a-notification-from-an-outbound-open-message

So you'd likely need a gateway (API gateway or equivalent) to extract info from the webhook notification and propagate this to Link Mobility adding the necessary authorization headers.

Regards,

------------------------------
Jerome Saint-Marc
Senior Development Support Engineer
------------------------------

Hi @Jerome Saint-Marc and @Jason Kleitz,

THANKS for your feedback!

I've found a pretty good Youtube video "DevCast Tutorial 18 | Introduction to the Genesys Cloud Open Messaging API" at the Genesys channel that helped me a lot to undestand the way it's working.

Now I am setting up a proxy with connections to both participants.

BR, Robert

Hi @Jerome Saint-Marc and @Jason Kleitz,

thanks for your feedback!
I've found a pretty good Youtube video "DevCast Tutorial 18 | Introduction to the Genesys Cloud Open Messaging API" by Genesys which helped me a lot to understand the way it's working and what else I need to create a communication to a third party provider.

As a short summary:
I need a middleware/proxy that can...
- receive request from Genesys (authenticated by the X-Hub-Signature-256 header) and send requests with OAuth authentication
- receive and send request from/to third party sms provider
- translate messages Genesys -> 3rd party provider and the other way 3rd party provider -> Genesys

I asked Link Mobility if they are willing to implement a direct Genesys Cloud support. There might be some more customers out there in Europe who want to use a European provider.
Let's wait for their feedback.

Else it might be a good Github project to create a middleware/proxy with support for different sms providers.

BR, Robert