Sinch provides the ability to send 1-way and 2-way SMS messages globally. 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.
It is important that all your customer phone numbers are saved in the E.164 standard.
If you use Sinch integrated with Blueshift, we can track:
- SMSes sent from a campaign journey
- SMSes delivered to a customer
- SMSes bounced
(messages might not be delivered to a customer in-cases such as: your customer's phone is switched off or it's out of network coverage area)
- Links clicked in an SMS
- Customers who unsubscribe/subscribe from marketing SMS
Note: You must first set up a webhook in Sinch so that Blueshift can receive messaging events.
Before you begin
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. While the Conversation API supports multiple channels, for the integration with Blueshift you must configure an SMS 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:
- Project UUID - This is the UUID of the project that you create in Sinch.
- App ID - This is the ID of the App that you set up in Sinch and will use to send SMS messages.
- 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 webhook in Sinch 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 subscription/un-subscription data from Sinch to Blueshift.
- Target type - Set as HTTP.
- Target URL - Set as https://api.getblueshift.com/api/v1/messaging_events/65a82149-c7bb-4e68-83af-4d40f3bcb557?site_id=<site_id> where <site_id> is the Site ID for your account as displayed on the Account Settings > API Keys tab in Blueshift.
If you are in the EU region, use the following URL: https://api.eu.getblueshift.com/api/v1/messaging_events/65a82149-c7bb-4e68-83af-4d40f3bcb557?site_id=<site_id>
- Secret Token - Leave this field blank.
- Triggers - Select MESSAGE_DELIVERY and MESSAGE_INBOUND.
Subscribing or unsubscribing a customer
When a customer replies to your SMS campaign message with an opt-out keyword, the Sinch webhook will send an SMS unsubscribe event to Blueshift. Blueshift will unsubscribe all customer records that share the same phone number.
When a customer replies with an opt-in keyword, the Sinch webhook will send an SMS subscribe event to Blueshift. Blueshift will subscribe the last messaged customer record matching the phone number.
It is important that all your customer phone numbers are saved in the E.164 standard. Otherwise, Blueshift might not be able to find all the customers that have a given phone number and thus would not be able to unsubscribe all the customers.
Set up integration
To set up Sinch integration with Blueshift, complete the following steps:
- Sign in to the Blueshift app, and click Apps in the left navigation menu.
- Go to All Apps, search for, and select Sinch - SMS.
- You can also go to SMS Apps and select Sinch - SMS.
- Click Configure to view all the configured adapters.
- Click +ADAPTER to add an adapter.
- Add a Name for the adapter. If you have multiple adapters, the adapter name helps you to identify the integration.
- 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. Project ID The UUID of the project in Sinch. App ID The ID of the App in Sinch. Region The region of the app as set in Sinch. From The virtual number in Sinch that identifies the sender.
- Click Log in to Sinch. The Client ID and Client Secret are used by Blueshift to connect to Sinch.
- Save to add the adapter.