Sinch - Instant Messaging

Sinch provides the ability to send messages to a wide range of messaging channels. With Sinch’s Conversation API, you can build stronger customer relationships through conversations. Sinch can handle multi-channel queries on one thread, create personalized experiences at scale, and automate customer care through self-serve bots.

Using Blueshift's Cloud App integration with Sinch, you can send messages to your customers on different instant messaging platforms like Whatsapp, Facebook Messenger, Telegram, and so on.

Prerequisites

Before you can set up integration with Blueshift, you must have your Sinch account set up.

Complete the following settings in Sinch before you set up integration with Blueshift:

• Set up your Sinch account and get access to their Conversation API
• Obtain the information required for integration with Blueshift
• Set up a webhook in Sinch to send events data to Blueshift

Set up your Sinch account and get access to their Conversation API

Before you add an adapter in Blueshift for integration with Sinch, you must have your Sinch account set up and you must get access to their Conversation API.

For a detailed step-by-step instructions, visit Sinch’s Conversation API Getting Started page.

The Sinch Conversation API supports multiple channels. For the integration with Blueshift, you must configure the specific instant messaging channel for the app you add in Sinch.

Obtain the information required for integration with Blueshift

Log into your Sinch account and obtain the following information required for integration with Blueshift:

1. Project UUID - This is the UUID of the project that you create in Sinch.
2. Client ID and Client Secret - This is the Access Key ID and Key Secret. 

• You can create a new Access Key by going to the Dashboard > Settings and clicking Access Keys in the left navigation.
• Ensure that you note down the Key Secret when you create the key since you cannot retrieve the Secret later.

Set up a webhook to send events data to Blueshift

Log into your Sinch account and set up a webhook in Sinch using the following information so that you can send events data from Sinch to Blueshift.

• Target type - Set as HTTP.
• Target URL - Contact support@blueshift.com for the URL.
• Secret Token - Leave this field blank.
• Triggers - Select the required triggers.

Set up integration

To set up Sinch integration with Blueshift, complete the following steps:

1. Sign in to the Blueshift app, and click App Hub in the left navigation menu.
2. Go to All Apps, search for, and select Sinch Instant Messaging.
3. You can also go to Instant Messaging Apps and select Sinch Instant Messaging.
4. Click Configure to view all the configured adapters.
5. Click +ADAPTER to add an adapter.
6. Add a Name for the adapter. If you have multiple adapters, the adapter name helps you to identify the integration.
7. Provide the following details for integration that you saved from your Sinch account:
   
   

   

   Field	Description
   Client ID	This is the Access Key ID that you copied from Sinch.
   Client Secret	The Key Secret from Sinch.
   Scopes	Leave this field blank.

8. Click Log in to Sinch Instant Messaging. The Client ID and Client Secret are used by Blueshift to connect to Sinch.
9. Save to add the adapter.

Next steps

1. Create a Sinch cloud app template to send a payload from a campaign.
2. In your campaign journey, add a Sinch trigger. Select the template that you created.

Create a Sinch Cloud App template

A Cloud App template is required to send a payload to Sinch from a campaign. You can include personalizations and recommendations in the template content. For more information, see Cloud Apps templates.

To add a Sinch Cloud App template, complete the following steps:

1. Go to Templates > Cloud App.
2. Click +TEMPLATES on the Cloud App Templates page. Select the Sinch app.

   Note: Only apps that support Cloud Apps templates and have atleast one adapter configured are displayed on the Cloud App Templates page.

3. Go to the Properties tab and configure the template name, tags and other relevant information.
4. Add the following information:
   1. In the API Endpoint field, add the <PROJECT_UUID> that you copied from Sinch.

      Note: If your Sinch service is in the EU, replace “https://us” with “https://eu”.

   2. Select the Adapter that is to be used to send the message.
5. Go to the Content tab.
   

   

6. Go to the Schema tab and configure the schema for the form.

   Add the fields for the following information:

   1. The App ID for the app in Sinch that is to be used to send the message.
   2. The Channel in Sinch that you are using to send the message. For example, WHATSAPP or MESSENGER. 
   3. The corresponding Identity for the channel. For example, the Identity is the phone number if you are sending a WhatsApp message.
   4. Add callback URLs for click and impression tracking.
7. Go to the Content Form tab and fill the data in the form.
8. In the preview tab, you can also switch to JSON and view the content in JSON format.