Plivo

Send Plivo SMS

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

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 you can use to check status later. 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.plivo.com/v1/Account/YOUR_PLIVO_AUTH_ID/Message/

Headers

  • Content-Typeapplication/json
  • AuthorizationBasic YOUR_BASE64_PLIVO_AUTH_ID_AND_AUTH_TOKEN

Body

{
  "src": "YOUR_PLIVO_SENDER_NUMBER",
  "dst": "{{toNumber}}",
  "text": "{{message}}"
}

Parameters

  • toNumber stringThe customer's mobile number in E.164 format, including the leading plus.
  • message stringThe text of the SMS.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "671653be-e7d1-481b-ae33-088f625c79e9",
    "type": "HTTP_REQUEST",
    "label": "Send Plivo SMS",
    "name": "send_plivo_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 you can use to check status later. 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 customer's mobile number in E.164 format, including the leading plus."
      },
      {
        "name": "message",
        "type": "string",
        "description": "The text of the SMS."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.plivo.com/v1/Account/YOUR_PLIVO_AUTH_ID/Message/"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Basic YOUR_BASE64_PLIVO_AUTH_ID_AND_AUTH_TOKEN"
        }
      ],
      "body": "{\n  \"src\": \"YOUR_PLIVO_SENDER_NUMBER\",\n  \"dst\": \"{{toNumber}}\",\n  \"text\": \"{{message}}\"\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.