SIP 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

   Choose how your phone system and connic reach each other. Either connic signs in like a phone: create a SIP account or extension for connic on the phone system. Or your phone system sends calls to connic: you set up a SIP trunk to connic in the last step.

3. 3

   Open the agent. In Connector Flow, click Add inbound connector to answer calls or Add outbound connector to place them, then Create New Connector, and select SIP Voice.

4. 4

   Pick the Setup from step 2 and fill in the server and, when connic signs in, the account's username and password. Choose the Transport and Media encryption your phone system supports, and click Create.

5. 5

   When your phone system sends calls to connic, open the connector and copy its SIP address, Username, and Password into a new SIP trunk on the phone system. Route the numbers or extensions the agent should answer to that trunk. Then call one of them and open the run.

type: sip
config:
  setup: register
  server: pbx.example.com
  transport: tls
  username: "200"
  password: ${PBX_LINE_PASSWORD}
  transfer_numbers:
    - "+4930123456789"
  allowed_callers:
    - "+4915112345678"
  fallback_number: "+4930987654321"
agents:
  - support-voice

Configuration

The fields of a SIP Voice connector, the same in connectors/*.yaml, the REST API, and connic MCP. The descriptions name the matching setting in the dashboard. Link one deployed agent with voice_config to receive or place calls. The dashboard links the agent you create the connector from, or asks for one under Voice agent. REST API and connic MCP create requests can link the agent through the optional agent_name field.

Agent input

An incoming call starts the run with the caller's number and the number or extension they called:

{
  "call_id": "1730900000.42",
  "from": "+4915112345678",
  "to": "200",
  "provider": "sip"
}

Calls

In sync mode, SIP Voice answers calls to the line and streams the audio between your phone system and the agent in both directions. The caller hears a ringing tone until the agent is ready to speak. Keypad input and hang-up follow the agent's voice settings.

type: sip
mode: outbound
config:
  setup: register
  server: pbx.example.com
  transport: tls
  username: "201"
  password: ${PBX_OUTBOUND_PASSWORD}
  caller_id: "+4930123456"
agents:
  - reminder-calls

Phone system setup

connic reaches your phone system from sip.connic.co: SIP on port 5060 over UDP or TCP and 5061 over TLS, and call audio on UDP ports 10000 to 20000. If the phone system only accepts known addresses, allow that address. With register, connic keeps the line signed in and tries again every 30 seconds after a failed sign-in, or every 5 minutes after the server refused it. A connector for outgoing calls doesn't sign the line in; it authenticates each call it places, so it can use the same account as a connector for incoming calls.

Limits and errors