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. If you use Sinch integrated with Blueshift, we can track:   

  • SMS’s sent from a campaign journey
  • Customers who unsubscribe/subscribe from marketing SMS
  • SMS’s delivered to a customer

Set up integration

Integrating your Sinch account with Blueshift includes the following steps:

Note: To send an SMS using Sinch, select the Sinch (cloud app) trigger in the journey builder.

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 this app.

The following information is required for the 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 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.
  3. App ID - This is the ID of the App that you set up in Sinch and will use to send SMS messages.

Configure the Sinch app in Blueshift

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.
  3. You can also go to SMS Apps and select Sinch.
  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_adapter.png

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

Create a Sinch Cloud App template

A Cloud App template is required to send a payload to Sinch from a campaign.

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

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

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

  4. Configure the template including the name, tags and other relevant information. For more information, see Cloud Apps templates.
  5. On the General tab, 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.

      sinch_general_aug2022.png

  6. On the Content tab, add the following information:
    1. Add the App_ID for your app that you copied from Sinch.
    2. For the Identity, add the phone number of the user. You can also use a Liquid expression here. For example, {{user.phone_number}}.
    3. Add the text for the message that is to be sent.
    4. Set the Channel as SMS.
    5. Set the Channel Priority Order as SMS.
    6. For the SMS Sender, add the phone number or short code that is to be used as the Sender for the message.

      sinch_content_aug2022.png

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.