Anleitungen

SIP

Wenn der Sprachagent und die einfache Weiterleitung nicht ausreichen und Sie eine Nummer mit Ihrem eigenen Softphone oder Ihrer Telefonanlage (PBX) verbinden möchten, brauchen Sie einen SIP-Trunk-Anbieter - volai ist einer. Diese Seite ist eine Schritt-für-Schritt-Anleitung.

1Eingehende Anrufe an Ihren SIP-Server

Stellen Sie die Weiterleitung der Nummer auf mode: "sip" und geben Sie Ihre sipUri an - von dort geht der Anruf direkt zu Ihnen, nicht zu unserem Agenten oder zur Weiterleitung:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:reception@your-server.com"}}'

Berechnet wird nur die eingehende Minute - 0,50 kr/min (≈ 0,02 EUR), kein zusätzlicher Agent - die vollständige Anfragestruktur und die anderen Weiterleitungsmodi stehen in der REST-API-Referenz.

Authentifizierung an Ihrer Telefonanlage

Wir senden den Anruf zuerst als nicht authentifiziertes INVITE an Ihren SIP-Server an sipUri. Eine Telefonanlage, die darauf mit einer Anmeldeaufforderung (401/407) antwortet und den Anruf ohne mehr ablehnt, bekommt ihn in dieser Form nie - es gibt niemanden, der die Aufforderung beantwortet. Ergänzen Sie daher in der Weiterleitung auch sipUsername und sipPassword - sind beide ausgefüllt, beantwortet unser Netz die Aufforderung (SIP Digest) und wählt die angerufene Nummer. Geprüft mit einem echten Anruf an die native SIP-Nummer von Vapi, die Zugangsdaten unabhängig von ihrem Inhalt akzeptiert. Ob auch Ihre eigene Telefonanlage den Anruf verbindet, hängt von ihr ab - sie muss das INVITE tatsächlich mit einer Aufforderung beantworten und den von Ihnen angegebenen Benutzernamen und das Passwort akzeptieren; das garantieren wir nicht für jede Telefonanlage (im Test scheiterte es zum Beispiel an der SIP-Domain von Twilio). Ohne sipUsername und sipPassword bleibt die Weiterleitung in der heutigen, nicht authentifizierten Form. Die Zugangsdaten ergänzen Sie so:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:reception@your-server.com", "sipUsername": "reception", "sipPassword": "supersecret123"}}'

Die angerufene Nummer senden wir immer genau so, wie sie in sipUri vor dem @-Zeichen steht - wir fügen nie ein Präfix oder eine führende Null hinzu und entfernen auch keine, die Ziel-Telefonanlage muss also genau das verarbeiten, was Sie dort angeben.

Weder sipUsername noch sipPassword dürfen einen Doppelpunkt, ein @-Zeichen, Leerzeichen, Anführungszeichen oder einen Backslash enthalten, und jedes darf höchstens 64 Zeichen lang sein.

Wenn nur eines der beiden ausgefüllt ist, wird das abgelehnt - die API liefert "Please fill in both username and password, or leave both empty."

Ein Doppelpunkt im Benutzerteil von sipUri (vor dem @-Zeichen) und ein Port im Host (nach dem Doppelpunkt hinter dem Server, z. B. :5060) werden zusammen mit sipUsername und sipPassword noch nicht unterstützt - beides liefert denselben harten Fehler. Ohne Zugangsdaten funktionieren beide unverändert weiter.

Ausnahme: Ein Vapi-BYO-SIP-Trunk (Adresse <credentialId>.sip.vapi.ai, oder <credentialId>.sip.eu.vapi.ai bei einer Organisation in der EU-Region) nimmt keine Zugangsdaten an. Vapi erkennt unsere Anrufe an der IP in den Gateways des Trunks, und mit ausgefülltem sipUsername und sipPassword wird der Anruf nie verbunden, daher lehnt die API diese Weiterleitung mit dem Validierungscode ab. Die native SIP-Nummer von Vapi (sip:<name>@sip.vapi.ai) ist nicht betroffen.

2SIP-Zugangsdaten für eine Nummer

Rufen Sie die Zugangsdaten der Leitung mit einem einzigen Aufruf ab:

curl "https://volai.eu/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_YOUR_KEY"

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Einrichtung in einem Softphone (Zoiper, Linphone)

Beide Apps fragen im Grunde dasselbe ab, nur unter anderen Namen - suchen Sie nach "Konto hinzufügen" / "SIP-Konto":

Nach dem Speichern sollte sich das Softphone registrieren (Statussymbol "online"/"registriert"), und Anrufe an die Nummer klingeln dann direkt dort.

3Ausgehende Anrufe aus einem SIP-Client

Sobald das Softphone registriert ist, kann es über diese Leitung selbstständig nach außen wählen - dafür müssen Sie keine unserer APIs aufrufen, Sie wählen direkt im Client wie an einem gewöhnlichen Telefonanschluss.

4Limits

• Eine Registrierung pro Leitung - Ein Satz Zugangsdaten unterstützt jeweils ein registriertes Gerät. Melden Sie sich mit einem zweiten Client an, verliert der erste höchstwahrscheinlich seine Registrierung - verlassen Sie sich nicht darauf, mehrere Geräte gleichzeitig an einer Leitung zu betreiben.
• Ausgehend vom eigenen Agenten ja, volles Trunk-Peering nein - Die Zugangsdaten der Leitung lassen IHREN Client sich bei UNS wie ein Telefon registrieren. Ausgehende Anrufe Ihres eigenen Sprachagenten (ElevenLabs oder eine andere Plattform) FUNKTIONIEREN heute aber - über das Relay, siehe Eigenen Agenten mitbringen. Ihre Telefonanlage als gleichberechtigten Carrier mit eigenem Routing für EINGEHENDE Anrufe von außen anzubinden, ist weiterhin nicht möglich - nutzen Sie dafür das forward -Routing auf die Nummer Ihrer Telefonanlage.
• Nur Sprache - kein Video und keine anderen SIP-Erweiterungen.