Telnyx Voice

Set up

1. 1

   Add voice_config and a supported realtime model to an LLM agent, save the model provider's credentials in the project if the model requires them, and deploy the agent to the environment. See connic voice.

2. 2

   In Telnyx, pick an existing active number and turn off its call forwarding.

3. 3

   Open the agent. In Connector Flow, click Add inbound connector, then Create New Connector, and select Telnyx Voice. Under Connection, pick a Telnyx Connection or create one with the API key and the account's public key.

4. 4

   Choose the Phone number. Numbers the connector can't use, such as a number with call forwarding turned on or one another connic voice connector holds, are listed but disabled, with the reason. Optionally add Transfer numbers and a Fallback number, and click Create. connic links the agent, creates a Call Control application, and assigns the number to it; see Provider setup for what it replaces.

5. 5

   Call the number and open the run to check the transcript, tool calls, timings, and errors.

type: telnyx
connection: support-telnyx
config:
  phone_number: "+4930123456"
  transfer_numbers:
    - "+4930123456789"
  allowed_callers:
    - "+4915112345678"
  fallback_number: "+4930987654321"
  max_wait_seconds: 60
  hold_audio_path: assets/hold.mp3
agents:
  - support-voice

Configuration

The fields of a Telnyx Voice connector, the same in connectors/*.yaml, the REST API, and connic MCP. The descriptions name the matching setting in the dashboard. Connectors in code describes the fields every connector shares, such as agents and environments. A Telnyx Voice connector needs its voice agent from the start: the dashboard links the agent you create it from, or asks for one under Voice agent, and a create request through the REST API or connic MCP must name an agent deployed with voice_config in agent_name.

Agent input

Each call starts a run with the call details:

{
  "call_id": "<call-control-id>",
  "from": "+4915112345678",
  "to": "+4930123456",
  "provider": "telnyx",
  "caller_name": "Alex Example",
  "raw": {
    "call_control_id": "<call-control-id>",
    "connection_id": "<application-id>",
    "direction": "incoming",
    "from": "+4915112345678",
    "to": "+4930123456",
    "caller_id_name": "Alex Example"
  }
}

• call_id is the Telnyx call control ID.
• caller_name comes from caller_id_name.
• raw holds the payload of the call.initiated event, including custom_headers and sip_headers.
• forwarded_from is never set. Telnyx passes forwarding information as a Diversion entry in sip_headers.

Calls

In sync mode, Telnyx Voice answers calls to the number. connic answers each call through Telnyx and streams the audio between Telnyx and the agent in both directions. The caller hears a ringing tone until the agent is ready to speak. When the conversation ends, connic hangs up through Telnyx. Keypad input, interruptions, and hang-up follow the agent's voice settings.

type: telnyx
mode: outbound
connection: support-telnyx
config:
  phone_number: "+4930123456"
  outbound_voice_profile_id: "1293384261075731499"
  ring_seconds: 40
agents:
  - reminder-calls

{
  "to": "+4915112345678",
  "customer": "Alex Example",
  "reason": "Confirm tomorrow's appointment at 10:00"
}

Provider setup

When you create the connector, connic creates a Call Control application for the number with the connector's webhook URL, clears the number's technical prefix and destination rewrite, and assigns the number to the application. It doesn't change the number's messaging settings. connic refuses a number with call forwarding turned on and a number that another connic voice connector holds.

In outbound mode, connic creates its own Call Control application with the connector's webhook URL and the chosen outbound voice profile, and changes nothing on the number. Deleting the connector deletes that application.

Telnyx routes call audio through the AnchorSite set on the application. To keep it in Europe, choose a European site on the connector's application in the Telnyx portal. connic leaves this setting unchanged; an application connic creates for a new number starts with Telnyx's default.

• Edit the Connection to rotate the credentials. Edit the connector to choose another Connection or number.
• When you switch numbers, connic creates a new application for the new number and detaches the previous number. After the change is saved, it deletes the old application if it still belongs to this connector and has no numbers assigned.
• Deleting the connector detaches the number only if it is still assigned to the unchanged connic application, then deletes that application once it has no numbers. Changes you made in Telnyx after setup are kept.

Limits and errors