Use Twilio Messaging as a Channel

To trigger your AI Assistant via incoming messages, you will configure an incoming message webhook on your Twilio phone number to forward messages to your AI Assistant.

You only have to deploy this webhook into your Twilio account once, regardless of how many AI Assistants or phone numbers you intend to use.

To deploy the webhooks, clone the AI Assistants Samples repository and deploy the Twilio Functions into your Twilio account.

1
git clone git@github.com:twilio-labs/ai-assistants-samples.git
2
cd ai-assistants-samples
3
npm install
4
cp .env.example .env
5
# you can ignore editing the .env if you don't intend to use other tools in the project
6

7
twilio serverless:deploy

After running the above commands, your output should look similar to this:

1
Deployment Details
2
Domain: ai-assistants-samples-1111-dev.twil.io
3
Service:
4
   ai-assistants-samples (ZSf3510841424c854e3f3b282550211111)
5
Environment:
6
   dev (ZE94900e7f2a2c330b15cf6e1c9fd11111)
7
Build SID:
8
   ZB2743d62d52d42ccd55873a0bcd511111
9
Runtime:
10
   node18
11
View Live Logs:
12
   https://www.twilio.com/console/functions/editor/ZSf3510841424c854e3f3b282550211111/environment/ZE94900e7f2a2c330b15cf6e1c9fd11111
13
Functions:
14
   [protected] https://ai-assistants-samples-1111-dev.twil.io/channels/conversations/messageAdded
15
   https://ai-assistants-samples-1111-dev.twil.io/channels/messaging/incoming
16
   [protected] https://ai-assistants-samples-1111-dev.twil.io/channels/conversations/response
17
   https://ai-assistants-samples-1111-dev.twil.io/channels/messaging/response
18
   https://ai-assistants-samples-1111-dev.twil.io/tools/flex-handover
19
   https://ai-assistants-samples-1111-dev.twil.io/tools/google-maps
20
   https://ai-assistants-samples-1111-dev.twil.io/tools/internet-search
21
   https://ai-assistants-samples-1111-dev.twil.io/tools/studio-handover
22
Assets:

Make sure you take note of the output behind Domain; this is your Functions URL.

If you use the Twilio Console, open your SMS-capable phone number of choice or Messaging Service in the Twilio Console and configure the When a message comes in webhook to point to: https://<your-functions-domain>.twil.io/channels/messaging/incoming?AssistantSid=<your-assistant-sid>. You can find your Assistant's SID in the Twilio Console under your Assistant's configuration.

Alternatively, you can use the Twilio CLI to configure the webhook by running the following command:

1
twilio phone_number <your-twilio-number> \
2
    --sms-url=https://<your-functions-domain>.twil.io/channels/messaging/incoming?AssistantSid=<your-assistant-sid>

Make sure you replace <your-functions-domain> and <your-assistant-sid> with the respective values from the steps above. You can find your Assistant's SID in the AI Assistants section of the Twilio Console.

If you are using the WhatsApp Sandbox for this guide, configure your When a message comes in webhook in the WhatsApp Sandbox Settings to point to https://<your-functions-domain>.twil.io/channels/messaging/incoming?AssistantSid=<your-assistant-sid>

Make sure you replace <your-functions-domain> and <your-assistant-sid> with the respective values from the steps above.

Send a message to your Twilio phone number or WhatsApp sandbox, and you should receive a response from your AI Assistant.

• Learn how to connect your AI Assistant to Twilio Conversations