Getting started
Organization Management
Integrations
Channels
Chatlayer API
Tips & Best practices
Tutorials
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
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
Make sure that the region of your app is EU.
​
​
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
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.channelIdentity variable. The possible values for the channel are:
1
internal.sinchConversationAPI.channelIdentifier:
2
"CHANNEL_UNSPECIFIED"
3
"WHATSAPP"
4
"RCS"
5
"SMS"
6
"MESSENGER"
7
"VIBER"
8
"VIBERBM"
9
"MMS"
10
"TELEGRAM"
11
"LINE"
12
"INSTAGRAM"
Copied!
Furthermore, there are a few other variables that store data coming from the Sinch Conversation API that might be useful to guide your flow:
1
internal.sinchConversationAPI.channelIdentity: 'USER_PHONE_NUMBER_OR_ID',
2
internal.sinchConversationAPI.contactId: 'CONTACT_ID_CONV_API',
3
internal.sinchConversationAPI.appId: 'APP_ID_CONV_API',
4
internal.sinchConversationAPI.conversationId: 'CONVERSATION_ID_CONV_API',
Copied!
You can learn more about how to use variables to guide your flow here:
​
Last modified 1mo ago