Skip to main content

Twilio

Prerequisite​

  • An HTTPS Endpoint to your bot

    • Set the externalUrl field in botpress.config.json.
    • Create an HTTPS tunnel to your machine using Ngrok.
    • Using Nginx and Let's Encrypt.

  • Create a Twilio account and create a phone number

Get your API Credentials​

  1. Go to you Twilio console dashboard.
  2. Go to the settings tab.
  3. Scroll down and copy your Account SID and Auth Token from the LIVE credentials section.

Configure Your Bot​

  1. Edit data/bots/<YOUR_BOT_ID>/bot.config.json. In the messaging.channels.twilio section write this configuration:

  • enabled: set to true

  • accountSID: paste your account SID

  • authToken: paste your auth token

    Your bot.config.json should look like this:

{
  // ... other data
  "messaging": {
    "channels": {
      "twilio": {
        "enabled": true,
        "accountSID": "your_account_sid",
        "authToken": "your_auth_token"
      }
      // ... other channels can also be configured here
    }
  }
}
  1. Restart Botpress.
  2. You should see your webhook endpoint in the console on startup.

Configure Webhook​

  1. Go to the phone numbers section and click Manage, then Active Numbers.
  2. Click on your registered phone number. If you don't have one, click Buy a new number.
  3. Scroll down to the messaging webhook section.
  4. Set 'A Message Comes In' to <EXTERNAL_URL>/api/v1/messaging/webhooks/<YOUR_BOT_ID/twilio.