Telnyx SMS

The Telnyx integration powers the SMS and Dial modes plus inbound webhooks for delivery receipts and replies.

Telnyx is configured directly in Settings, not via Composio — Telnyx runs through dedicated Supabase Edge Functions (telnyx-webhooks, telnyx-sms-admin) for tighter control over compliance and delivery.

Buy a phone number

1. ⌘K → Settings → Phone Numbers.
2. Search the inventory by area code, capability (SMS / voice / MMS), and monthly cost.
3. Click Buy on a number to provision it to your org.

The list of owned numbers shows capability badges, assignment (workspace or agent), and monthly cost. Reassign by clicking through to the number's detail.

Register for 10DLC (US)

US outbound SMS requires 10DLC brand + campaign registration. Settings → SMS has a stepper:

1. Brand info — legal entity, EIN, address, contact, vertical.
2. Campaign settings — use case, sample messages, opt-in / opt-out flow.
3. Compliance keywords — STOP, HELP, etc. (defaults set; editable).
4. Auto-reply messages — the keyword responses (e.g. STOP → "You've been unsubscribed").
5. Quiet hours — time window where outbound is paused.
6. Link tracking — toggle for tracking shortener.

Until your brand and campaign are approved, outbound SMS is rate-limited and may be filtered by carriers.

Contact tags

Contacts in the People table support a tags text array. The Campaigns mode reads from these tags when you target an audience — define tags as you import or edit contacts, then select them when composing a campaign.

Webhooks

The telnyx-webhooks Edge Function receives:

• Inbound SMS — creates a message row, updates the contact's last_contacted_at and conversation_count
• Delivery receipts — updates message status (queued, sending, sent, failed)
• Inbound calls / call status for the Dial mode

The telnyx-sms-admin Edge Function handles outbound sends — agents and campaigns call it via the proxy.

Tools for agents

Agents can use Telnyx tools to:

• Send an SMS
• List recent SMS conversations
• Read inbound messages

The Phone Agent template is wired with these by default.

Where to next

• SMS mode
• Dial mode
• Campaigns mode