Phony

Trigger an outbound phone call via Twilio

List and filter call history (active and completed calls)

Get the current transcript and details of a specific call

Get detailed Twilio event logs for a specific call

Place an active call on hold

Resume a call that is on hold

Hangup an active call

Inject additional context or instructions into an active call

List all context templates

Get a specific context template by ID

Create a new context template

Update an existing context template

Delete a context template

List all available Twilio phone numbers that can be configured

List all incoming call handler configurations

Create a new incoming call handler for a phone number

Update an existing incoming call handler

Delete an incoming call handler

Create an outbound phone call with an ElevenLabs AI voice assistant. Two modes: "advanced" (default) — Phony hosts a WebSocket bridge with mid-call control (DTMF for IVR navigation, mid-call context injection); works on the typical business number that has an IVR. "native" — ElevenLabs hosts the cal…

List call history with optional filtering

Get detailed information about a specific call including transcript and events

Put an active call on hold

Resume a call that is on hold

End an active call

Inject additional instructions/context into an active call

Put the call on hold and request additional context from the human operator. The call will remain on hold until the operator provides the requested information.

Send DTMF (phone keypad) tones to an active call. Useful for navigating IVR menus, entering codes, or pressing phone buttons.

Get the conversation transcript for a call

Delete a call record from the database by its call SID

Delete multiple call records from the database matching the given filters. At least one filter is required.

Search call records by text content. Searches call context, system instructions, and conversation transcripts.

EMERGENCY: Terminate ALL active calls immediately. Use this as a safety measure if calls are running uncontrolled or consuming excessive credits.

List saved context templates for reusable call configurations

Get a specific context template by ID

Create a new reusable context template

Update an existing context template

Delete a context template

Get detailed Twilio event logs from a call for debugging

Get the system and call instructions that were used for a specific call

Get system health and statistics

List all Twilio phone numbers and their configuration status

List all configured incoming call handlers

Configure a phone number to handle incoming calls. Supports three modes: AI conversation (default), message-only (play message and hang up), or voicemail (record and transcribe messages).

Update an existing incoming call configuration

Remove incoming call configuration from a phone number

Register (or update) the dtmfPreflight Twilio sendDigits string for a target phone number. phony_create_call will auto-apply this preflight when called against that number without an explicit dtmfPreflight. Use for barge-in-disabled IVRs that need precisely-timed carrier-level DTMF (e.g. Petco 603-8…

Get the registered dtmfPreflight for a specific phone number (if any).

List all registered IVR preflights (enabled + disabled).

Delete the registered preflight for a phone number. phony_create_call will no longer auto-apply it.

Soft-disable a registered preflight (entry kept, but no longer auto-applied). Use phony_ivr_preflight_set to re-enable.

Look up line type (mobile/landline/voip/tollFree/...) and carrier for one or more phone numbers via Twilio Lookup v2. USE THIS BEFORE ANY BULK SMS: landlines silently bounce (30005/30006) and repeated undeliverable sends hurt carrier reputation. Returns per-number {lineType, carrier, smsViable} plus…

Get the active smart-route thread for a proxy-target sender (Ben/Laura). Returns null if no active thread. Used by the phony session to decide whether to reuse the last-routed agent or pick a new one when a fresh sms.needs_routing event arrives.

Upsert the active smart-route thread for a proxy-target sender. Sets targetSession, resets expiresAt, optionally records topic + appends latest inbound body to recentMessages (trimmed to last 10). Call after each routing decision.

List all active smart-route threads (i.e. all Ben/Laura threads currently routed to an agent). Sorted by most-recently-updated first. Useful when an agent DMs the phony session back with a reply — phony looks up which fromNumber to SMS the reply to.

Delete the active smart-route thread for a proxy-target sender. Use when a conversation is explicitly closed, or when the routed agent tells phony "I'm done" and you want the next inbound to re-route fresh.

List all available Twilio phone numbers in the account

Search SMS messages by text content using full-text search

Send an SMS/MMS message to a phone number. Supports text and media (images, files, etc.)

List SMS message history with optional filtering

Get detailed information about a specific SMS message

Get all SMS messages between two phone numbers (conversation history)

Create a true group MMS conversation via the Twilio Conversations API. The Twilio number (Phony) joins as a projectedAddress system participant; each external phone number joins as a native SMS participant. Messages posted into the resulting Conversation fan out to all externals as a single native g…

List conversations this Phony instance is tracking. Returns a unified view of both group MMS Conversations (stored with a Twilio CH-SID and slug) and 1-on-1 internal conversation pairings. Groups include participant list, slug, and last activity timestamp.

Get full details for a specific conversation. Accepts a Twilio Conversation SID (CH…) for group conversations, a group slug (with or without braces, e.g. "{9630-grp}" or "9630-grp"), or the internal 1-on-1 conversationId (conv_…). Returns participants, friendlyName, slug, message count, and last act…

Get all messages in a conversation, in chronological order. Accepts the same reference formats as phony_get_conversation_details (CH-SID, slug, or conv_…). For group conversations this pulls every inbound from any external participant plus every outbound Phony posted into the thread.

Add an external phone number to a group Conversation. The new participant immediately joins the native group MMS thread — Twilio notifies them on next message. Updates the group's stored participant list and slug metadata.

Remove an external phone number from a group Conversation. They will no longer receive group messages; the other externals see them leave via their native Messages app. Updates the group's stored participant list.

Update a group Conversation's friendlyName in Twilio. This is an internal label (visible in Twilio Console and the Phony UI); participant phones do NOT see the name because native Messages groups have no shared name field.

Delete a single SMS message from the database by its message SID

Delete multiple SMS messages from the database matching the given filters. At least one filter is required.

Post a message into a group Conversation. Twilio fans this out as native group MMS to every external participant as a single thread on their phones (authored by Phony's number). The message does NOT go to Phony's internal proxy targets (Ben/Laura) if they are already in the group — they see it nativ…

Add tags to a call, SMS, or voicemail record. Tags are normalized to lowercase. Duplicates are ignored.

Remove tags from a call, SMS, or voicemail record

Find calls, SMS messages, and/or voicemails by tags. Can search across all record types or a specific type.

List voicemail messages with optional filtering by phone number, read status, date range, etc.

Get detailed information about a specific voicemail including transcription

Mark a voicemail as read

Mark a voicemail as unread

Delete a voicemail message

Delete multiple voicemail messages from the database matching the given filters. At least one filter is required.

Get the count of unread voicemails for a phone number

Search voicemails by transcription text

Create an outbound webhook for phony events. Fires HTTP POST to `url` when an event matches `eventTypes` AND `filters`. Events are POSTed as a stable envelope: `{event, event_id, occurred_at, source, data, reply?}`. If `hmacSecret` is set, body is signed with HMAC-SHA256 in `X-Hub-Signature-256`. Se…

List all configured phony webhook routes. Optionally filter by eventType or enabled state.

Get full details of a single webhook config by name.

Update fields on an existing webhook config.

Delete a webhook config by name.

Fire a synthetic event through the real dispatcher path against the named webhook config. Verifies HMAC, headers, and retry path end-to-end. If `sampleEvent` is omitted, uses the webhook's first eventType with all required fields filled with `test-*` sentinels.

Return the live catalog of every phony event type and its payload shape. Use this to discover what you can subscribe to and what fields each event carries.

Return the most recent delivery attempts (status_code, duration, error) for a webhook config — or all configs if `name` is omitted. Powers operator debugging without log access.