Getting started with an SMS Channel

This article details the steps required to set up an SMS channel for use with the Sinch Conversation API.

Prerequisites

Before you can set up an SMS channel on the Conversation API, you need to do the following:

General requirements

1. Sign up for the Sinch Customer Dashboard.
2. Get access to the Conversation API.
3. Create your app.
4. Create your access key. Any API calls you make will require authentication information provided by your access key.

Refer to the Conversation API Getting started section for more information on any of these steps.

SMS Requirements

You must ensure that you have at least one service plan associated with your Sinch account. You must also have a virtual number assigned to that service plan.

For more information on creating an SMS service account, see How do I create an SMS service plan?. For more information on assigning a virtual number to an SMS service account, see How do I assign a virtual number to an SMS service plan?.

Configuring the Conversation API and SMS integration

After ensuring that you meet the above prerequisites, you must enable the SMS integration for your Conversation API app. You can do so using the Sinch Customer Dashboard, or using the API.

Enabling the SMS integration using the Sinch Customer Dashboard

When enabling the SMS channel through the Sinch Customer Dashboard, select your app and click SET UP CHANNEL next to the relevant SMS channel. Then, select your configured service plan from the drop-down box and confirm the integration.

You must also configure at least one Conversation API webhook which will trigger POST callbacks to the given URL. For more information on how to do this using the Customer Dashboard, see How to add a webhook to a Conversation API app.

Enabling the SMS integration using the API

To setup the SMS integration programmatically, use the following snippet to configure the channel credentials for the app with the SMS channel:

{
  "channel_credentials": [
    {
      "channel": "SMS",
      "static_bearer": {
        "claimed_identity": "{{SERVICE_PLAN_ID}}",
        "token": "{{API_TOKEN}}"
      }
    }
  ]
}

Replace {{SERVICE_PLAN_ID}} and {{API_TOKEN}} with your Sinch SMS service plan ID and API token.

You must also configure at least one Conversation API webhook which will trigger POST callbacks to the callback URL. For more information on how to do this programmatically, click here.

Next steps

After configuring the channel, you need to set the channel priority in your app. Also, when sending messages, you'll need to make sure you have the identity of the contact to which you are sending the message. For SMS, that's just the contact's phone number.

If you already know how to set channel priority, or your channel priority is already established, you can begin sending and receiving messages in your preferred language: