Geschäftskommunikation, einfach gemacht
Apps für Mobilgeräte und ComputerEntwicklerIllyVoIP-StatusHilfe-Center

Voice API

Ihre Logik.
Ihr Anruf.
Ihre Kontrolle.

Integrieren Sie Telefonie in Ihre Anwendung. Erstellen und beantworten Sie Anrufe, spielen Sie Audio ab, erfassen Sie Eingaben und steuern Sie die nächsten Schritte über die IllyVoIP-API.

API entdeckenAnfrage ansehen

Die Bausteine
für Ihr Gesprächserlebnis.

Nutzen Sie einzelne Aktionen zur Live-Steuerung oder führen Sie eine geordnete Aktionskette mit einer Anfrage aus.

Erstellen und annehmen

Starten Sie ausgehende Anrufe oder beantworten Sie eingehende Anrufe, die an Voice API Control geleitet werden.

Dokumentation ansehen

Sprechen und zuhören

Spielen Sie Audio ab, lassen Sie Text sprechen und erfassen Sie Sprach- oder Tasteneingaben des Anrufers.

Dokumentation ansehen

Das Gespräch lenken

Leiten Sie weiter, halten Sie, setzen Sie fort, senden Sie DTMF oder beenden Sie den Anruf entsprechend Ihrer Anwendung.

Dokumentation ansehen

Eine Aktionskette in der Praxis

Sprechen.
Zuhören.
Darauf aufbauen.

Diese Anfrage spielt in einem bestehenden Gespräch eine Begrüßung ab und erfasst eine gesprochene Antwort. Ihre Anwendung entscheidet, wie das Ergebnis genutzt wird.

Authentifizierung
X-Api-Key
Anfrageformat
application/json
Für diesen Endpunkt erforderlich
Idempotency-Key

Ersetzen Sie die Platzhalter durch Ihre serverseitigen Zugangsdaten und eine gültige Anrufsteuerungssitzung. Verwenden Sie einen Idempotenzschlüssel nur für eine identische Anfrage erneut.

Referenz zu Aktionsketten lesen
Anfrageinhalt · JSON
POST/api/v1/voice/call-control/execute
{
  "call_control_id": "YOUR_CALL_CONTROL_ID",
  "actions": [
    {
      "type": "speak",
      "text": "Welcome to our support line."
    },
    {
      "type": "gather",
      "input": "speech",
      "prompt_text": "How can we help?",
      "speech_language": "en-US",
      "timeout_ms": 8000,
      "save_as": "request"
    }
  ]
}

Eingehende Anrufe

Ihre Rufnummer.
Die Antwort Ihrer Anwendung.

Leiten Sie eine IllyVoIP-Rufnummer an Voice API Control. Abonnieren Sie das Klingelereignis, beantworten Sie den dafür geeigneten Anruf und nutzen Sie anschließend die zurückgegebene Anrufsteuerungs-ID für weitere Aktionen.

Anleitung für eingehende Anrufe lesen
RufnummerRouting an Voice API Control
Klingelereigniscall_ringing
Ihre AnwendungAnnehmen → Anruf steuern

Webhooks

Lassen Sie Anrufereignisse
Ihre Abläufe anstoßen.

Empfangen Sie Ereignisse aus dem Anrufverlauf am Endpunkt Ihrer Anwendung. Aktualisieren Sie Datensätze, verfolgen Sie den Gesprächsfortschritt oder lösen Sie den nächsten Schritt in Ihrem System aus.

Webhooks entdecken
call_initiatedcall_ringingcall_answeredcall_completed

Prüfen Sie Signaturen, bestätigen Sie Zustellungen zügig und erkennen Sie Duplikate anhand der Ereignis-ID. Erneute Zustellversuche können ein Ereignis wiederholen.

Wählen Sie,
wie Sie entwickeln möchten.

Nutzen Sie die Anrufsteuerung für Ihre Anwendungslogik und verbinden Sie die weiteren Werkzeuge, die Ihr Gesprächserlebnis benötigt.

Rufnummern-APIs

Suchen, bestellen und konfigurieren Sie Rufnummern als Teil Ihres Plattformablaufs.

Rufnummern entdecken

Webphone SDK

Ergänzen Sie Ihre Oberfläche um Browser-Telefonie mit dem dokumentierten SDK und kurzlebiger Token-Authentifizierung.

SDK-Dokumentation lesen

KI-Sprachassistenten

Konfigurieren Sie im Portal einen Assistenten für eingehende Anrufe mit Wissen und visuellen Anrufabläufen.

KI-Sprachassistenten entdecken

Vor Ihrer
ersten Integration.

Unser Team fragen
Ist die Voice API dasselbe wie ein SIP-Trunk?+

Nein. SIP-Konnektivität verbindet eine Telefonanlage oder Plattform. Die Voice API stellt Aktionen zur Anrufsteuerung bereit, die Ihre Anwendung anfordern kann, etwa Text sprechen, Eingaben erfassen und Anrufe weiterleiten.

Kann sie eingehende und ausgehende Anrufe verarbeiten?+

Ja. Die Dokumentation umfasst das Erstellen ausgehender und das Annehmen eingehender Anrufe. Leiten Sie für eingehende Anrufe eine Rufnummer an Voice API Control und folgen Sie dem dokumentierten Ablauf für Klingelereignis und Annahme.

Kann ich Sprach- und Tasteneingaben erfassen?+

Ja. Der gather-Endpunkt unterstützt Sprache und DTMF. Wählen Sie anhand der Endpunktdokumentation die unterstützten Eingabeoptionen, die Sprache und das Zeitlimit für Ihren Ablauf.

Kann ich Sprachdienste außerhalb eines laufenden Gesprächs nutzen?+

Ja. Die API-Referenz enthält eigenständige Endpunkte für Spracherkennung und Sprachsynthese. Nutzen Sie diese für Audio-zu-Text- oder Text-zu-Audio-Abläufe und die Voice-API-Aktionen gather und speak innerhalb eines Gesprächs.

Wie werden Sprachfunktionen berechnet?+

Das Portal veröffentlicht aktuelle Tarife für Spracherkennung und Sprachsynthese. Die Voice API nutzt diese für gather- und speak-Aktionen. Prüfen Sie die aktuellen Tarife und die für Ihre Einrichtung anfallenden Gesprächsgebühren.

Wo sollte der API-Schlüssel gespeichert werden?+

Bewahren Sie Kunden-API-Schlüssel in Ihrer serverseitigen Anwendung auf. Browser-Telefonie verwendet stattdessen den dokumentierten Ablauf mit kurzlebigen Tokens des Webphone SDKs, ohne einen Konto-API-Schlüssel offenzulegen.

Kann ich die API erkunden, bevor ich meine Anwendung verbinde?+

Das Portal bietet Endpunktreferenzen, Anfragebeispiele, Beispielantworten, eine OpenAPI-Spezifikation und einen API-Playground. Playground-Anfragen können echte Aktionen ausführen. Prüfen Sie die gewählte Anfrage vor der Ausführung.

Entwickeln Sie den Anrufablauf,
den Ihre Anwendung braucht.

Beginnen Sie mit der Endpunktreferenz und aktuellen Anfragebeispielen.

Voice-API-Dokumentation öffnenMit unserem Team sprechen