Instant - Twilio Provider Setup

Owned by Product Knowledge
Last updated: Jan 25, 2024
2 min read

 

In the following section you find how to setup the Twilio Solution Provider.

General Requirements

This integration requires:

a valid WhatsApp Solution Provider account with a positive balance. In fact consider that to use WhatsApp, on XCALLY side you need to enable the connector, while for interactions management you need to consult the official documentation of the selected provider to check prices: find out Twilio documentation about inbound interactions at this link

the WhatsApp API enabled on your the WhatsApp Solution Provider account

a business sender number profile approved by WhatsApp in advance (For more information, please visit the official Twilio Web Guide)

The Motion instance must have a public address accessible via HTTPS. For security reasons we strongly recommend to use a Reverse Proxy → find out more

 

What to do on Twilio Account

Voice IP Migration Schedule Update - Action Required before December 5, 2023.
You need to allowlist the full IP and port ranges following the steps here: https://www.twilio.com/docs/voice/voice-ip-migration-schedule-update#what-do-you-need-to-do

The message status (checkmark) is automatically updated on the Agent Motion Interface when the positive delivery report is received. 

The message status (checkmark) is not updated on the sender WA device when the Agent receives/opens/reads the message. 

Twilio does not support read receipts for inbound (user-initiated) WhatsApp messages. This means it is not possible for the business to set the status of a message it received to "read" (i.e., changing the checkmark colour on the end user's application). 

 

  • Copy Account Sid and Auth Token values from the Twilio Account: they must be entered on the XCALLY Motion WhatsApp Connector Account

  • Get WhatsApp Number from WhatsApp Enabled Senders section

  • You need to Configure Webhook, by inserting your receive URL in the fields and HTTP Post