Sinch Conversation API

The Sinch Conversation API allows you to connect Chatlayer.ai to multiple channels at the same time, without any additional configuration. The Sinch Conversation API currently supports:

  • SMS

  • MMS

  • RCS

  • Viber

  • Facebook Messenger

  • WhatsApp

  • Telegram

  • Instagram

  • LINE

  • KakaoTalk

  • WeChat

You don't have to think about which type of message works with which channel – the Conversation API transcodes the messages automatically to match the target channel. Easy peasy!

Creating your channels

First, you need to create channels in the Sinch dashboard. Depending on the channel you want to set-up, the instructions will be different.

Linking the channels to the Conversation API app

You can find detailed instructions on how to create a Conversation API app here.

Make sure that the region of your app is the same one of your Chatlayer account. If you don't know which region you are using, you cand find that out here by the URL you access our platform.

Setting up the Conversation API integration in Chatlayer

In the Channels page on our platform, add a new channel that is activated through the Sinch Conversation API.

We'll then ask for a number of fields that are required to set up this connection. Let's go through each of them, one by one.

Project ID

You can find the project ID in the conversation API overview.

App ID

After creating an App, you can view the App ID in the App table.

Client ID & client secret

To get a client ID and client secret, you need to create an access token. Navigate to this page to start the process.

Click on 'New Key' and enter an access key display name:

After confirming, you will be able to copy the client id and client secret to our platform:

Once you've entered all the information in the Chatlayer.ai channel window, click 'Create' and all the channels that are configured in the Sinch Conversation API app will be automatically added to Chatlayer.ai as well.

Variables

If multiple channels are connected to your Conversation API app, it can be useful to be able to send a specific flow depending on the channel the bot user is on. To do that, you can use the internal.sinchConversationAPI.channelIdentifier variable.

The possible values for the channel are:

internal.sinchConversationAPI.channelIdentifier: 
"CHANNEL_UNSPECIFIED"
"WHATSAPP"
"RCS"
"SMS"
"MESSENGER"
"VIBER"
"VIBERBM"
"MMS"
"TELEGRAM"
"LINE"
"INSTAGRAM"

Furthermore, there are a few other variables that store data coming from the Sinch Conversation API that might be useful to guide your flow:

internal.sinchConversationAPI.channelIdentity: 'USER_PHONE_NUMBER_OR_ID',
internal.sinchConversationAPI.contactId: 'CONTACT_ID_CONV_API',
internal.sinchConversationAPI.appId: 'APP_ID_CONV_API',
internal.sinchConversationAPI.conversationId: 'CONVERSATION_ID_CONV_API',
internal.sinchConversationAPI.metadata: string or key + value pair

You can learn more about how to use variables to guide your flow here:

Last updated