Talkative
Twilio

Send Twilio SMS

Sends a text message to a customer's mobile number through Twilio.

Unverified

What the model is told

Send an SMS to a customer. Ask for their mobile number if you do not have it. Returns a message SID and a status such as queued. Tell the customer the message has been sent, not that it has been delivered. Only send to the number or address the customer gave you in this conversation, and read it back to confirm it, together with the message wording, before calling this tool. Keep the message plain text and avoid the characters & + % # because the request body is form-encoded.

Request

POSThttps://api.twilio.com/2010-04-01/Accounts/YOUR_TWILIO_ACCOUNT_SID/Messages.json

Headers

  • Content-Typeapplication/x-www-form-urlencoded
  • AuthorizationBasic YOUR_BASE64_ACCOUNT_SID_AND_AUTH_TOKEN

Body

To=%2B{{toNumber}}&From=YOUR_TWILIO_FROM_NUMBER&Body={{message}}

Parameters

  • toNumber stringThe number in international format with the country code but WITHOUT the leading plus sign or any spaces.
  • message stringThe text of the SMS.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "585f624e-c708-464e-95ea-9b3bced5c572",
    "type": "HTTP_REQUEST",
    "label": "Send Twilio SMS",
    "name": "send_twilio_sms",
    "customName": false,
    "description": "Send an SMS to a customer. Ask for their mobile number if you do not have it. Returns a message SID and a status such as queued. Tell the customer the message has been sent, not that it has been delivered. Only send to the number or address the customer gave you in this conversation, and read it back to confirm it, together with the message wording, before calling this tool. Keep the message plain text and avoid the characters & + % # because the request body is form-encoded.",
    "parameters": [
      {
        "name": "toNumber",
        "type": "string",
        "description": "The number in international format with the country code but WITHOUT the leading plus sign or any spaces."
      },
      {
        "name": "message",
        "type": "string",
        "description": "The text of the SMS."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.twilio.com/2010-04-01/Accounts/YOUR_TWILIO_ACCOUNT_SID/Messages.json"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/x-www-form-urlencoded"
        },
        {
          "name": "Authorization",
          "value": "Basic YOUR_BASE64_ACCOUNT_SID_AND_AUTH_TOKEN"
        }
      ],
      "body": "To=%2B{{toNumber}}&From=YOUR_TWILIO_FROM_NUMBER&Body={{message}}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.