Speko Docs
SMS

Agent send_sms tool

Bind a sender to an agent and queue compliant SMS from tool calls.

Bind the send_sms builtin to an agent with a fixed fromPhoneNumberId. The model only supplies to and text; it cannot choose a different sender or spoof a campaign.

{
  "name": "send_confirmation_text",
  "description": "Send the customer the confirmation they requested.",
  "parameters": {
    "type": "object",
    "required": ["to", "text"],
    "properties": {
      "to": { "type": "string" },
      "text": { "type": "string", "maxLength": 1600 }
    }
  },
  "executionMode": "builtin",
  "source": {
    "kind": "builtin",
    "name": "send_sms",
    "config": { "fromPhoneNumberId": "8f0e9a96-..." }
  }
}

At execution Speko verifies that the bound number belongs to the same workspace and agent, then applies the same readiness, consent, suppression, quiet-hour, idempotency, and credit-reservation pipeline as the public API. The tool returns the durable message ID and current status. It never claims immediate delivery.

Inbound auto-replies use the same central send service and incur both the existing LLM charge and SMS segment charge. They remain off until explicitly enabled on the organization, number, and conversation.