SIP Voice
Schließ einen Sprachagenten an jede Telefonanlage mit SIP an. Er nimmt Anrufe entgegen, ruft selbst an und leitet Anrufer an Nummern weiter, die du freigibst.
- Modi
- Sync, Outbound
- Einrichtung
- Dashboard oder connectors/*.yaml
- Dokumentation
- SIP Voice Docs
- Publisher
- Von connic
Verbinde die Telefonanlage, die du schon hast
Leg fest, wie connic und deine Telefonanlage zueinander finden, und verknüpfe einen Sprachagenten. Jeder Anruf an die Leitung startet einen Run, und der Agent antwortet mit deinem Wissen und deinen Tools.
- connic meldet sich wie ein Telefon an
- Lege in deiner Telefonanlage ein SIP-Konto oder eine Nebenstelle für connic an und trag Server, Benutzername und Passwort ein. connic hält die Leitung angemeldet und versucht es nach einer fehlgeschlagenen Anmeldung erneut.
- Oder deine Telefonanlage schickt die Anrufe
- connic legt für die Verbindung eine SIP-Adresse, einen Benutzernamen und ein Passwort an. Übernimm die drei Werte in einen neuen SIP-Trunk und leite die Nummern oder Nebenstellen, die der Agent annehmen soll, auf diesen Trunk. Die Werte bleiben gleich, wenn du die Verbindung bearbeitest.
- Verschlüsselung und Codecs
- Voreingestellt sind TLS als Transport und SRTP für verschlüsseltes Gesprächsaudio. Wähle, was deine Telefonanlage unterstützt. Anrufe nutzen bevorzugt G.722 für HD-Telefonie, danach G.711.
Der Anrufer wählt deine Nummer
Deine Telefonanlage leitet den Anruf an die Leitung: an das SIP-Konto, mit dem sich connic anmeldet, oder an den Trunk zu connic.
connic nimmt den Anruf entgegen
Sind erlaubte Anrufer eingetragen, weist connic Anrufe anderer und unterdrückter Nummern ab, bevor sie angenommen werden. Bis der Agent sprechen kann, hört der Anrufer ein Freizeichen.
Der Agent spricht
Der Run startet mit der Nummer des Anrufers und der angerufenen Nummer oder Nebenstelle. Der Agent begrüßt den Anrufer, hört zu und nutzt seine Tools.
Das Gespräch endet oder geht weiter
Der Agent legt nach seiner Verabschiedung auf oder leitet den Anrufer über deine Telefonanlage weiter. Schlägt der Run fehl, geht der Anruf an deine Ausweichnummer.
Lege Stimme, Begrüßung und Sprecherwechsel fest
Das Gespräch konfigurierst du in voice_config, direkt neben Prompt und Tools, die der Agent schon hat.
- Echtzeitmodelle
- Nutze connic/gemini-3.8-live ohne Zugangsdaten eines Anbieters, abgerechnet über das Projektguthaben. Mit den Zugangsdaten des Anbieters im Projekt nutzt du ein Gemini-Modell mit nativer Audioverarbeitung über Google Gemini oder Vertex AI oder ein Realtime-Modell von OpenAI oder Azure OpenAI.
- Transkripte
- Gemini und Vertex AI transkribieren den Anrufer nativ. Bei OpenAI und Azure OpenAI setzt du transcription_model, damit das Gesagte als Text im Run erscheint.
- Warten auf Tools
- Während ein Tool läuft, spielt ein leiser Ton, der pausiert, sobald jemand spricht. Mit thinking_sound: false schaltest du ihn ab.
- Was Sprachagenten nicht unterstützen
- Guardrails, menschliche Freigaben, strukturierte Ausgaben und fallback_model lehnt connic für Sprachagenten ab. Ein Anruf ist ein Run, also begrenzt das Timeout des Agenten seine Länge.
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: 90Erkenne, wer anruft, und leite weiter
Jeder Run startet mit den Anrufdaten. Weiterleitungen laufen über deine Telefonanlage an Nummern, die du an der Verbindung freigibst, und ist der Agent ausgelastet, warten weitere Anrufer in einer Warteschlange.
- Anrufdaten
- from ist die Nummer des Anrufers, to die angerufene Nummer oder Nebenstelle. Middleware und Tools lesen beides aus context["payload"], etwa um den Anrufer zu erkennen.
- Weiterleitungen
- Ein Tool löst TransferCall mit einer von bis zu 100 Weiterleitungsnummern der Verbindung aus, und connic bittet deine Telefonanlage, den Anruf zu übergeben. Die Anlage muss Weiterleitungen von der Leitung erlauben. Legst du das Tool in voice_config auf eine Taste, leitet ein Tastendruck sofort weiter, auch während der Begrüßung.
- Wartende Anrufer
- Der Agent führt so viele Anrufe gleichzeitig, wie max_concurrent_runs erlaubt. Alle weiteren Anrufer kommen in der Reihenfolge dran, in der sie angerufen haben, und hören bis dahin das Freizeichen oder deine Warteschleifenmusik, eine MP3- oder WAV-Datei aus deinem Projekt mit bis zu 10 Minuten Länge.
- Ausweichnummer
- Hierher gehen Anrufer, die nach der maximalen Wartezeit von standardmäßig 30 Sekunden noch warten, und angenommene Anrufe, die der Agent nicht zu Ende führen kann. Ohne Ausweichnummer endet der Anruf. Für Weiterleitungen gilt sie nicht.
{
"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_operatorLass den Agenten selbst anrufen
Im Outbound-Modus ist jeder Run des verknüpften Agenten ein Anruf über die Leitung. Die Runs startest du wie jeden anderen, etwa über einen Webhook-Connector oder aus einem anderen Agenten mit trigger_agent.
- Wen der Agent anruft
- connic ruft die Nummer im Feld to der Eingabe an, oder die voreingestellte Nummer der Verbindung, wenn die Eingabe keine enthält. Mit caller_id legst du fest, von welcher Nummer oder Nebenstelle der Anruf kommt.
- Wer zuerst spricht
- Mit greeting spricht der Agent zuerst, sobald jemand abnimmt. Ohne Begrüßung wartet er, bis sein Gegenüber spricht.
- Telefonmenüs und Warteschleifen
- Durch Telefonmenüs kommt der Agent mit press_keys. Mit wait_on_hold_allowed wartet er in der Warteschleife, bis sich jemand meldet.
- Wenn niemand abnimmt
- Der Run schlägt fehl, wenn innerhalb der Klingeldauer von standardmäßig 30 Sekunden niemand abnimmt, besetzt ist oder der Anruf nicht zustande kommt. Die Fehlermeldung nennt den Grund. Nimmt eine Mailbox ab, hört der Agent ihre Ansage wie die einer Person. Schreib deshalb in den Prompt, was er dann tun soll.
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-callsDeklariere die Leitung neben dem Agenten
Lege eine Datei in connectors/ an und halte das Passwort in einer Variablen. Setze Rufnummern und Nebenstellen in Anführungszeichen, sonst liest YAML sie als Zahl und das Deployment schlägt fehl. Jede SIP-Voice-Verbindung verknüpft genau einen Sprachagenten.
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-lineWas ein Sprachagent an deiner Telefonanlage übernimmt
Wähle ein Szenario und sieh den Weg des Anrufs und die Agent-YAML dahinter.
Anrufer nennen ihr Gerät, und der Agent führt sie durch die Schritte aus deinen Handbüchern.
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: trueDer Agent fragt nach dem Fehler und den bereits versuchten Lösungen und legt dann ein Ticket mit allen Angaben an.
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?"Anrufer drücken die 1 für den Vertrieb oder die 0 für die Zentrale, oder sie stellen dem Agenten direkt ihre Frage.
version: "1.0"
name: phone-menu
type: llm
model: connic/gemini-3.8-live
description: Greets callers and routes them by keypad
system_prompt: |
Answer short questions yourself.
Offer the keypad options when the caller hesitates.
tools:
- phone.transfer_to_sales
- phone.transfer_to_operator
voice_config:
greeting: "Welcome. Press 1 for sales or 0 for an operator."
keypad:
"1": phone.transfer_to_sales
"0": phone.transfer_to_operatorDein Buchungssystem schickt jeden Termin mit der Nummer des Kunden im Feld to, und der Agent ruft an, um den Termin zu bestätigen oder zu verschieben.
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."FAQ zu SIP Voice
Weitere Verbindungen
AWS S3
Neue Dateien in einem Bucket lösen Agenten aus, mit Include Content auch zusammen mit der Datei selbst.
Inbound
Gmail
Neue E-Mails in einem Postfach von Google Workspace lösen Agenten aus, die direkt im selben Verlauf antworten. connic meldet sich mit deinem eigenen Dienstkonto an. Anhänge werden unterstützt.
Inbound · Outbound
PostgreSQL
Mit LISTEN/NOTIFY lösen neue Zeilen einen Agenten aus. Polling oder eine CDC-Pipeline sind nicht erforderlich.
Inbound
Slack
Slack-Bots lassen sich mit connic verbinden. Erwähnungen lösen Agenten aus; Ergebnisse gehen an Slack-Channels.
Inbound · Outbound
Twilio Messaging
Lass einen Agenten SMS, MMS, WhatsApp- und RCS-Nachrichten verarbeiten. Sende Antworten, Medien und WhatsApp-Vorlagen über dein Twilio-Konto.
Inbound · Outbound
WhatsApp
Lass einen Agenten WhatsApp-Nachrichten an deine Geschäftsnummer beantworten, auch mit Dateien. Er antwortet innerhalb von 24 Stunden oder erreicht Kunden mit freigegebenen Vorlagen.
Inbound · Outbound