Send and receive global SMS, MMS, and chat messages from any app, and ensure deliverability using intelligent delivery features that Twilio's APIs provide.


If you use Twilio integrated with Blueshift, we can track: 

  • SMSes sent from a campaign journey
  • Users who unsubscribe/subscribe from marketing SMS
  • SMSes delivered to a user
  • SMSes not delivered to a customer
    (this can happen in-cases such as: your customer's phone is switched off or it's out of network coverage area)
  • Links clicked in an SMS

Set up integration

Integrating your Twilio account with Blueshift includes the following steps:

  • Set up your Twilio account.
  • Configure the Twilio app in Blueshift.
  • Set up Automatic subscription management in Twilio.

Set up your Twilio account

Before you add an adapter in Blueshift for integration with Twilio, you must have your Twilio account set up. You will require the following information for the integration with Blueshift.

  1. Sign in to your Twilio account.
  2. From the Dashboard, copy the Account SID and the Twilio phone number that you will use for the integration.


  3. Go to Account > Keys & Credentials > API keys & tokens and click Create API key.
  4. Copy the API key SID and API Secret. Ensure that you save the SID and Secret in a secure location since you cannot retrieve the Secret later.


  5. From the Dashboard, go to Messaging > Services. Create a Messaging Service and provide the Messaging Service SID or copy the Messaging Service SID of an existing service.


Configure the Twilio app in Blueshift

To set up Twilio 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 Twilio.
  3. You can also go to SMS Apps and select Twilio.
  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 Twilio account:


    Field Description
    From You can either provide an alphanumeric short code (that corresponds to your brand) or the Twilio phone number. 
    API Key SID Specify the API Key SID.
    API Secret  Provide the API Secret.
    Account SID The account SID for your Twilio project.
    Auth Token Provide the authentication token if you have one.
    Messaging Service SID The messaging service SID from Twilio.
    Status callback URL Leave this field blank.
  8. Click Save to add the adapter.

Automatic subscription management

When a user responds to an SMS with an opt-out word (such as STOP, BLOCK, CANCEL, STOPALL, UNSUBSCRIBE, QUIT, or END), we automatically unsubscribe the user from the SMS channel. Similarly, when a user responds to an SMS with an opt-in word (START, YES, UNSTOP), we automatically subscribe the user to the SMS Channel.

Automatic subscription management for the SMS channel is currently available only for Twilio. Subscribes and unsubscribes to the SMS channel are handled at a user level and we cannot attribute them to any template or campaign.

To handle such requests from your customers, complete the following steps:

  1. From the Dashboard, go to Messaging > Services and select the messaging service that you are using for the integration with Blueshift.
  2. In the Integration settings, for Incoming Messages, select Send a webhook and specify as the REQUEST URL.
  3. Save this configuration.


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



Please sign in to leave a comment.