Configuring Sinch Conversation API

When using Sinch Conversation API as a messaging service, you should configure all webhooks with a secret to enable digital signature verification in Sinch Contact Center . You must configure the same webhook secret in Sinch Contact Center to use this secret to verify the digital signature.

In Sinch Conversation API, webhooks are configured per app, and each webhook has its own secret. In the System Configurator (SC) application, only a single webhook secret can be configured per messaging service and it applies to all apps within that messaging service. But if your project extends over multiple messaging services, one webhook secret per service is needed. For example, if you have apps in different landscapes but the project is the same, you need to configure two messaging services.

Note:

(From 16th December 2020)

Regarding the changes introduced by Facebook (applies to Facebook Messenger & WhatsApp) to comply with new privacy rules in Europe, rich content will only be delivered if it contains image file, for any other type of file (audio, video) message will not be sent.

This condition impacts you if:

  • Your app points to messenger bot which is created for a European page.
  • Your app points to messenger bot which is created for a page that has European admins.
  • You send a message to customers in Europe.

Until Facebook restores this feature, you can send a message as a Text Message with plain text URL which points to audio/video file.

Prerequisites

You have created and configured your project and apps API in Sinch Portal (https://dashboard.sinch.com/login). For instructions, see https://developers.sinch.com/docs/conversation.

  1. Go to System Management > Messaging Services.

  2. Choose Add New and sinchconversation.
  3. In the Basics block, enter:
    • Name for your service
    • Service connection which is of format https://[landscape either eu or na].conversation.api.sinch.com/v1beta/projects/[project ID]/messages:send

    You get the Project ID from Conversation API > Apps.

  4. In the Authentication block, define authentication for outbound messaging (consisting of key ID and app ID) and inbound messaging (webhook).
    1. Enter your username and password. The username is of format [Key ID]@[App ID]. You get the Key ID from Settings > Access Keys.

      App ID is in Conversation API > Apps.

      The password is the secret in Settings > Access keys > Access key list.

    2. Enter webhook and then retrieve your app’s secret from Conversation API > Apps > [the app] > Webhook > Secret token.

      Make sure you have chosen MESSAGE_INBOUND as a trigger.

  5. Save your new messaging service.
  6. Go to Queue Management > Queues and create a queue. The queue address is of format [app ID]@[subchannel].sinchconversation.com, for example 01E4556565565ERKYO@whatsapp.sinchconversation.com.