Talkative
Vonage

Send Vonage SMS

Sends a text message to a customer's mobile number with the Vonage Messages API.

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_uuid. 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.

Request

POSThttps://api.nexmo.com/v1/messages

Headers

  • Content-Typeapplication/json
  • AuthorizationBasic YOUR_BASE64_VONAGE_API_KEY_AND_SECRET

Body

{
  "channel": "sms",
  "message_type": "text",
  "to": "{{toNumber}}",
  "from": "YOUR_VONAGE_SENDER",
  "text": "{{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": "cb03aad9-7050-4b1b-9d29-7030cde45171",
    "type": "HTTP_REQUEST",
    "label": "Send Vonage SMS",
    "name": "send_vonage_sms",
    "customName": false,
    "description": "Send an SMS to a customer. Ask for their mobile number if you do not have it. Returns a message_uuid. 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.",
    "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.nexmo.com/v1/messages"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Basic YOUR_BASE64_VONAGE_API_KEY_AND_SECRET"
        }
      ],
      "body": "{\n  \"channel\": \"sms\",\n  \"message_type\": \"text\",\n  \"to\": \"{{toNumber}}\",\n  \"from\": \"YOUR_VONAGE_SENDER\",\n  \"text\": \"{{message}}\"\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.