Installation

Setup Twilio

Step 1: Purchase a Twilio phone number compatible with Programmable Messaging

To get started, you will need to create a Twilio account and purchase a phone number in the country of your choice. Twilio has a documentation on this topic. The only point of attention is that you must make sure that the number you purchase has Messaging capabilities. Please keep in mind that depending on your country of origin, the requirements may differ, and Twilio may ask you for business verification. Keep track of this phone number (including the country code) as you are going to need to add it later to CSML Studio!

Step 2: Configure the messaging webhook

To configure the webhook, you can either use a TwiML app, or directly set a webhook in the messaging configuration panel. Either way, you will need to set the HTTP POST webhook to https://clients.csml.dev/v1/twilio/sms/request, for example like so:

Step 3: Security and Authorization

The last step is to provide CSML Studio with means to make sure that the requests that are sent to the Twilio Voice endpoint are indeed coming from Twilio. To do so, visit your Twilio Project Settings and copy your Account SID and Auth Token, found under API Credentials:

Setup CSML Studio

To setup your Twilio SMS channel in CSML Studio, you will simply need to visit the Channels section and create a new Twilio SMS channel. Then simply fill the required fields with the information you gathered earlier.

Once you click on Submit, your bot is ready to use!

Last updated