Zum Hauptinhalt springen
connic
Starte kostenlos

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.
  1. 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.

  2. 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.

  3. 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.

  4. 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.
agents/service-line.yaml
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: 90

Erkenne, 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.
context["payload"]
{
  "call_id": "1730900000.42",
  "from": "+4915112345678",
  "to": "200",
  "provider": "sip"
}
tools/phone.py
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")
agents/service-line.yaml
tools:
  - phone.transfer_to_sales
  - phone.transfer_to_operator
voice_config:
  keypad:
    "1": phone.transfer_to_sales
    "0": phone.transfer_to_operator

Lass 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.
connectors/reminder-calls.yaml
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-calls

Deklariere 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.

connectors/service-line.yaml
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-line
create: connectors/service-line.yaml (sip)

Was 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.

Anrufer
SIP Voice
setup-helper
Schritte aus deinen Handbüchern
agents/setup-helper.yaml
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: true

Der Agent fragt nach dem Fehler und den bereits versuchten Lösungen und legt dann ein Ticket mit allen Angaben an.

Anrufer
SIP Voice
ticket-intake
Ticket im Helpdesk
agents/ticket-intake.yaml
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.

Anrufer
SIP Voice
phone-menu
Weiterleitung an Vertrieb oder Zentrale
agents/phone-menu.yaml
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_operator

Dein 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.

Buchungssystem
Inbound Webhook
reminder-calls
Anruf über SIP Voice
agents/reminder-calls.yaml
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

Jede Telefonanlage und jeder Anbieter mit SIP. Entweder meldet sich connic mit einem SIP-Konto oder einer Nebenstelle an, die du dafür anlegst, oder deine Telefonanlage schickt die Anrufe über einen SIP-Trunk an connic.

Nein. Deine Nummern und Nebenstellen bleiben in deiner Telefonanlage. Die Anlage leitet die Anrufe, die der Agent annehmen soll, an die Leitung und übernimmt auch die Weiterleitungen.

Ja. Lege eine SIP-Voice-Verbindung im Outbound-Modus an, dann ist jeder Run ihres Agenten ein Anruf an die Nummer im Feld to der Eingabe. Der Modus lässt sich nach dem Anlegen nicht mehr ändern, deshalb brauchst du für eingehende und ausgehende Anrufe je eine eigene Verbindung. Beide können dasselbe SIP-Konto nutzen, weil die Verbindung für ausgehende Anrufe die Leitung nicht anmeldet.

Ja. Trag bis zu 100 erlaubte Anrufer im E.164-Format ein. Anrufe von allen anderen und von unterdrückten Nummern weist connic ab, bevor sie angenommen werden. Solche Anrufe starten keinen Run, und die Logs der Verbindung zeigen jeden einzelnen. Anrufernummern lassen sich fälschen. Verlass dich zum Schutz sensibler Daten deshalb nicht allein auf diese Liste.

connic meldet die Leitung ab und lehnt Anrufe deiner Telefonanlage ab.