SIP Voice
Connect a voice agent to any phone system that supports SIP. It answers calls to the line, places calls of its own and transfers callers to numbers you allow.
- Modes
- Sync, Outbound
- Set up in
- Dashboard or connectors/*.yaml
- Documentation
- SIP Voice docs
- Publisher
- By connic
Connect the phone system you already have
Choose how connic and your phone system reach each other, then link one voice agent. Every call to the line starts a run, and the agent answers with your knowledge and tools.
- connic signs in like a phone
- Create a SIP account or extension for connic on your phone system and enter the server, username and password. connic keeps the line signed in and tries again after a failed sign-in.
- Or your phone system sends the calls
- connic creates a SIP address, username and password for the connector. Copy them into a new SIP trunk and route the numbers or extensions the agent should answer to it. They stay the same when you edit the connector.
- Encryption and codecs
- TLS is the default transport, and SRTP encrypts the call audio by default. Choose what your phone system supports. Calls prefer G.722 for HD voice, then G.711.
The caller dials your number
Your phone system routes the call to the line: the SIP account connic signs in with, or the trunk to connic.
connic takes the call
With allowed callers set, calls from other and hidden numbers are turned away before they're answered. The caller hears a ringing tone until the agent is ready to speak.
The agent talks
The run starts with the caller's number and the number or extension they called. The agent greets the caller, listens and uses its tools.
The call ends or moves on
The agent hangs up after its farewell or transfers the caller through your phone system. If the run fails, the call goes to your fallback number.
Set the voice, the greeting and the turn-taking
Configure the conversation in voice_config, next to the prompt and tools the agent already has.
- Realtime models
- Use connic/gemini-3.8-live without provider credentials, billed from Project credit. With your provider credentials in the project, use a Gemini native audio model through Google Gemini or Vertex AI, or an OpenAI or Azure OpenAI realtime model.
- Transcripts
- Gemini and Vertex AI transcribe the caller natively. For OpenAI and Azure OpenAI, set transcription_model to see the caller's speech as text in the run.
- Waiting on tools
- A quiet tone plays while a tool runs and pauses whenever someone speaks. Set thinking_sound to false to turn it off.
- What voice agents leave out
- Guardrails, human approvals, structured output and fallback_model are rejected for voice agents. A call is one run, so the agent's timeout caps its length.
version: "1.0"
name: service-line
type: llm
model: connic/gemini-3.8-live
description: Answers calls on the service line
system_prompt: |
Keep replies short and natural.
Before you use a tool, say what you are checking.
Say goodbye before you end the call.
tools:
- retrieval_query
- tickets.create_ticket
voice_config:
language: en
greeting: "Hello, this is the service line. How can I help?"
thinking_sound: true
turn_detection:
silence_ms: 600
interruptions:
enabled: true
idle_timeout_seconds: 90See who is calling and route them onward
Each run starts with the call details. Transfers go through your phone system to numbers you allow on the connector, and callers wait in line while the agent is busy.
- Call details
- from is the caller's number and to the number or extension they called. Middleware and tools read them from context["payload"], for example to identify the caller.
- Transfers
- A tool raises TransferCall with one of up to 100 transfer numbers on the connector, and connic asks your phone system to transfer the call, which it must allow from the line. Map the tool to a key in voice_config, and a key press transfers right away, even during the greeting.
- Waiting callers
- The agent takes as many calls at once as its max_concurrent_runs allows. Further callers wait in the order they called and hear a ringing tone or your hold audio, an MP3 or WAV file from your project up to 10 minutes long.
- Fallback number
- Callers still waiting after the maximum wait, 30 seconds by default, and accepted calls the agent can't finish go to this number. Without one, the call ends. It doesn't apply to transfers.
{
"call_id": "1730900000.42",
"from": "+4915112345678",
"to": "200",
"provider": "sip"
}from connic import TransferCall
def transfer_to_sales(context: dict) -> str:
"""Transfer the caller to the sales team."""
raise TransferCall("+4930123456780")
def transfer_to_operator(context: dict) -> str:
"""Transfer the caller to an operator."""
raise TransferCall("+4930123456781")tools:
- phone.transfer_to_sales
- phone.transfer_to_operator
voice_config:
keypad:
"1": phone.transfer_to_sales
"0": phone.transfer_to_operatorLet the agent place calls
In outbound mode, every run of the linked agent is a call through the line. Start the runs any way you like, for example from a webhook connector or from another agent with trigger_agent.
- Who the agent calls
- connic calls the number in the input's to field, or the connector's default number when the input has none. caller_id sets the number or extension the call comes from.
- Who speaks first
- With a greeting, the agent speaks first once someone answers. Without one, it waits for the other side to speak.
- Phone menus and hold
- The agent gets through phone menus with press_keys. With wait_on_hold_allowed, it waits on hold until a person answers.
- When nobody answers
- The run fails when nobody picks up within the ring time, 30 seconds by default, the line is busy or the call can't be connected, and its error says which. If a mailbox answers, the agent hears its greeting like a person's, so tell it in the prompt what to do then.
type: sip
mode: outbound
name: Reminder calls
config:
setup: register
server: pbx.example.com
transport: tls
username: "201"
password: ${PBX_OUTBOUND_PASSWORD}
caller_id: "+4930123456789"
ring_seconds: 45
agents:
- reminder-callsDeclare the line next to the agent
Add a file to connectors/ and keep the password in a variable. Quote phone numbers and extensions, or YAML reads them as numbers and the deploy fails. Each SIP Voice connector links exactly one voice agent.
type: sip
name: Service line
config:
setup: register
server: pbx.example.com
transport: tls
username: "200"
password: ${PBX_LINE_PASSWORD}
transfer_numbers:
- "+4930123456780"
- "+4930123456781"
fallback_number: "+4930123456782"
max_wait_seconds: 120
hold_audio_path: assets/hold.mp3
agents:
- service-lineWhat a voice agent on your phone system handles
Pick a setup to see the call path and the agent YAML behind it.
Callers name their device, and the agent walks them through the steps from your manuals.
version: "1.0"
name: setup-helper
type: llm
model: connic/gemini-3.8-live
description: Walks callers through device setup
system_prompt: |
Ask which model the caller has.
Read one step at a time from the manual you retrieve.
tools:
- retrieval_query
voice_config:
greeting: "Hi! Which device are you setting up?"
interruptions:
enabled: trueThe agent asks about the error and what the caller already tried, then opens a ticket with the details.
version: "1.0"
name: ticket-intake
type: llm
model: connic/gemini-3.8-live
description: Opens support tickets from phone calls
system_prompt: |
Ask for the device, the error and what the caller
already tried. Read the summary back, then open
the ticket and give the caller its number.
tools:
- tickets.create_ticket
voice_config:
greeting: "Hi! What seems to be the problem?"Your booking system posts each appointment with the customer's number in to, and the agent calls to confirm or move it.
version: "1.0"
name: reminder-calls
type: llm
model: connic/gemini-3.8-live
description: Calls customers to confirm their appointment
system_prompt: |
The input names the customer and the appointment.
Confirm the time, or move it if it doesn't suit.
If a mailbox answers, leave a short message
after the tone and hang up.
tools:
- calendar.move_appointment
voice_config:
greeting: "Hi, this is a reminder about your appointment tomorrow."SIP Voice FAQ
More connectors
AWS S3
Run an agent the moment a file lands in a bucket, with the file itself when you turn on Include Content.
Inbound
Gmail
Run an agent on new email in a Google Workspace mailbox and reply in the same thread. connic signs in with your own service account. Attachments included.
Inbound · Outbound
PostgreSQL
Use LISTEN/NOTIFY to trigger an agent from new rows, without polling or a CDC pipeline.
Inbound
Slack
Connect a Slack bot to connic. Trigger agents from mentions or send agent outputs to Slack channels.
Inbound · Outbound
Twilio Messaging
Receive SMS, MMS, WhatsApp, and RCS messages with an agent. Send replies, media, and WhatsApp templates through your Twilio account.
Inbound · Outbound
WhatsApp
Answer WhatsApp messages to your business number with an agent, files included. Reply within 24 hours or reach people with approved templates.
Inbound · Outbound