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!
First, you need to create channels in the Sinch dashboard. Depending on the channel you want to set-up, the instructions will be different.
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.
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.
After creating an App, you can view the App ID in the App table.
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.
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 modified 8mo ago