Twilio SMS Integration

Follow these steps to enable Twilio SMS integration.

	Steps	Details
1	Get a Twilio account	Signup for a trial/paid account from Twilio Navigate to WhatsApp sandbox using the link.
2	Get a Twilio Phone Number	On Twilio dashboard, under All Products and Services, select Super Networks > Phone Numbers. Get an SMS capable Phone Number.
3	Configure Webhook	Click the number to specify Hybrid Chat web hook against Messaging > A Message Comes In. 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 (3.15 ) Customer Channel Manager (CCM) Environment Variables, 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.

Environment Variables for Twilio Integration

Following CCM environment variables must be configured for Twilio integration. See (3.15 ) Customer Channel Manager (CCM) Environment Variables for a complete list of all environment variables.

Variable Name Description

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.

TWILIO_WHATSAPP_FROM_NUMBER

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,

CSS

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

Specify the exact callback API URL according to your host IP/FQDN and the port the connector is running on.
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.

DEFAULT	No directive from Channel Manager for the Hybrid Chat bot or chat-server. HybridChat will route requests either to the bot or the agent based on the Bot training and chat-server configurations.
BOT_ONLY	Chat requests should not be routed to the agent even if the Bot's confidence level for a response is below confidence threshold.