Send MessageBird (Bird) SMS

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 id and a status of accepted, which means queued rather than 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

Headers

• Content-Typeapplication/json
• AuthorizationBearer YOUR_BIRD_API_KEY

Body

{
  "to": "{{toNumber}}",
  "from": "YOUR_BIRD_SENDER",
  "text": "{{message}}",
  "category": "service"
}

Parameters

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

{
  "source": "VOICE_AI",
  "tool": {
    "id": "870edc35-742c-4485-9971-0a99e8f8dea0",
    "type": "HTTP_REQUEST",
    "label": "Send MessageBird (Bird) SMS",
    "name": "send_messagebird_bird_sms",
    "customName": false,
    "description": "Send an SMS to a customer. Ask for their mobile number if you do not have it. Returns a message id and a status of accepted, which means queued rather than 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://YOUR_BIRD_REGION.platform.bird.com/v1/sms/messages"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Bearer YOUR_BIRD_API_KEY"
        }
      ],
      "body": "{\n  \"to\": \"{{toNumber}}\",\n  \"from\": \"YOUR_BIRD_SENDER\",\n  \"text\": \"{{message}}\",\n  \"category\": \"service\"\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.