Sinch_logo.png

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.

Note

It is important that all your customer phone numbers are saved in the E.164 standard.

Tracked events

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

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:

  1. Project UUID - This is the UUID of the project that you create in Sinch.
  2. App ID - This is the ID of the App that you set up in Sinch and will use to send SMS messages.
  3. 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.
  4. Region - This is the region that you have selected for the App in Sinch.
  5. Virtual number or Short Code - This is the virtual number in Sinch that is used to send the messages.

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.

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.

Note

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:

  1. Sign in to the Blueshift app, and click Apps in the left navigation menu.
  2. Go to All Apps, search for, and select Sinch - SMS.
  3. You can also go to SMS Apps and select Sinch - SMS.
  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:

    sinch_sms_adapter.png

    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.
  8. Click Log in to Sinch. The Client ID and Client Secret are used by Blueshift to connect to Sinch.
  9. Save to add the adapter.

Next steps

  1. Create an SMS template for your messages.
  2. In your campaign journey, add an SMS trigger. On the SMS tab of the trigger, go to Send Settings and specify Sinch as the App and select the adapter that you just created.
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.