Twilio SMS Integration

1

Get a Twilio account

Signup for a trial/paid account from Twilio Navigate to WhatsApp sandbox using the

.

2

Get a Twilio Phone Number

1. On Twilio dashboard, under All Products and Services, select Super Networks > Phone Numbers. 
   

   

2. Get an SMS capable Phone Number.

3

Configure Webhook 

1. Click the number to specify Hybrid Chat web hook against Messaging > A Message Comes In.

2. Specify https://hybrid-chat-public-fqdn/ccm/msg-client/receive, where hybrid-chat-public-fqdn is  the public FQDN of the machine where Hybrid Chat solution is installed. 

Twilio uses this web-hook to push incoming SMS messages to Hybrid Chat.

4

Specify Twilio Phone Number in Hybrid Chat

Under , specify the Twilio phone number for  TWILIO_FROM_NUMBER  environment variable.

5

Add Twilio SSL certificate in Hybrid Chat trust store

If the CCM SSL_TRUST_STORE_PATH environment variable is set, then you will need to add a Twilio SSL certificate to our trust store. Open https://twilio.com in Chrome, export certificate and follow these steps to add the certificate to the trust store.

TWILIO_API_ACCOUNT

Unique 34 character SID of the Twilio Account, e.g., AC496763443da6c75e0f1b5f27ddb3f515

TWILIO_API_TOKEN

Twilio auth token

example: 100865823c710ff641409f5703f50f98

TWILIO_FROM_NUMBER

Number registered with Twilio to send outbound SMS from. Use same format that is mentioned in Twilio dashboard.

Number registered with Twilio to send outbound WhatsApp messages from. It consisting of whatsapp: followed by the sending WhatsApp number (usingE.164 formatting). For example, 

whatsapp:+14155238886

TWILIO_OUTBOUND_API_URL (optional)

Twilio Outbound SMS REST API URL

If this variable is not set the default URL is constructed using TWILIO_API_ACCOUNT. For example, https://api.twilio.com/2010-04-01/Accounts/AC496763443da6c75e0f1b5f27ddb3f515/Messages.json

TWILIO_STATUS_CALLBACK

CCM receives SMS delivery status notification on http[s]://SMS-CONNECTOR-HOST:[PORT]/sms-client/delivery-notification. When this variable is set, it is pushed with every outbound SMS to Twilio and Twilio uses this value a webhook to push SMS delivery notification back to CCM

1. Specify the exact callback API URL according to your host IP/FQDN and the port the connector is running on.

2. Specify the same callback API URL against Twilio statusCallBack

For example, https://<FQDN>/sms-client/delivery-notification, where

(a) sms.hybrid-chat.com is the FQDN of your HOST where CCM is running and

(b) 8080 is the service port.

SMS_ROUTING_POLICY

A directive for Hybrid Chat to decide routing of requests from a Twilio SMS account.