Text messages

SMS and MMS are in preview and are outside the first Pro voice release. On an eligible configured number, AgentOwl can receive messages and deliver each as an event to your chosen destination through a published route. Use your messaging provider to send replies. Sending business messages from US local numbers requires messaging registration and approval. A funded outbound SMS/MMS API is implemented in the source, but requires released live billing, carrier approval and explicit outbound enablement; it is not currently available on the hosted service.

Get a number

Phone numbers require an active paid entitlement. Check number availability in Admin and purchase or upgrade availability for your account. Available setup actions depend on account and provider eligibility. If number setup is unavailable for your account, contact support@agentowl.dev.

When number setup is available for your account, connect an eligible number with the CLI:

# Get a new number with SMS and MMS
agentowl messaging bind acme --capability sms mms

Add voice to the capabilities to receive calls on the same number; see Voice. Then route the binding to an endpoint and publish:

agentowl route create --tenant acme --binding <binding_id> --endpoint <endpoint_id>
agentowl config publish acme

Event payload

Text messages have channel: "sms" and provider: "telnyx". provider_event_type is message.received.sms, or message.received.mms when the message has media.

{
  "channel": "sms",
  "provider": "telnyx",
  "provider_event_type": "message.received.mms",
  "subject": { "from": "+12125550183", "to": "+12125550142", "phone_number": "+12125550183" },
  "payload": {
    "inline": {
      "text": "Here's the damaged box",
      "subject": null,
      "type": "MMS",
      "media_count": 1,
      "media": [
        { "url": "https://...", "content_type": "image/jpeg", "size": 204811 }
      ]
    }
  }
}

Media links

MMS media URLs point to the carrier's storage and expire. Download any media you need to keep as soon as you receive the event. The dashboard Inbox shows MMS attachments while their links are valid.

What isn't delivered

Only messages received on your number become events. Delivery receipts and other status callbacks from the carrier are acknowledged and dropped.

Blocking senders

A sender-deny policy drops messages from listed numbers before they're delivered. See Policies.