Ereignisfluss

Um die Beziehungen zwischen den verschiedenen Komponenten im System und zwischen den Vonage-APIs zu verstehen, betrachten Sie den Systemfluss der Ereignisabwicklung.

Zur Veranschaulichung betrachten wir den Anwendungsfall eines Anrufs von einem Telefon zu einem App-Benutzer.

Dieser Ablauf ist hier zusammengefasst:

  1. Ein Telefonanruf wird eingeleitet.
  2. Vonage nimmt den Anruf entgegen und ruft auf der answer_url Webhook.
  3. Ein NCCO wird ausgeführt.
  4. Ein Anruf wird erstellt und die Benutzer werden mit ihm verbunden.
  5. Ereignisse werden versendet.

Anmerkung: In dem genannten Anwendungsfall ist der Einstiegspunkt ein Telefonanruf an eine Vonage-Nummer. Das nachstehende Diagramm und die Art und Weise, wie Ereignisse im System weitergeleitet werden, funktioniert jedoch für alle anderen Ereignistypen auf ähnliche Weise.

Dies wird in der folgenden Abbildung veranschaulicht:

BackendVoice APIConversation APIApplicationClientBackendVoice APIConversation APIApplicationClientEstablish ConversationHandle events1. Calls Vonage number2. Establishes `answer_url `and `event_url` webhooks3. `answer_url` returns NCCO4. Call is created and Users added5a. Voice API events trigger`event_url`5b. RTC events trigger `event_url`5c. Events sent to your app via Client SDK

Die Reihenfolge ist wie folgt:

  1. Ein Anruf wird an eine Vonage-Nummerdas war einer Vonage-Applikation zugewiesen.

  2. Vonage empfängt den Anruf und löst die von Ihrer Vonage Application ausgelöste answer_url Webhookdie Ihr Backend zur Verfügung stellt.

  3. Das answer_url bestimmt, wie ein Anruf zu behandeln ist und mit wem der Anruf verbunden werden soll. Dies geschieht durch die Ausführung eines NCCO, der zahlreiche Funktionen des Voice API.

  4. A aufrufen erstellt, und die angeforderten Benutzer werden mit ihm verbunden. Ein Anruf erfolgt, wie bei Vonage-Kommunikationsereignissen, innerhalb einer Konversation Objekt.

Als Ergebnis von answer_url Ausführung, eine neue Konversation erstellt oder ein vorhandener abgerufen und die angeforderten Benutzer werden hinzugefügt, um eine Verbindung mit dem Anruf herzustellen. Beachten Sie, dass alle Ereignisse über die Conversation API laufen und für Sie über diese zugänglich sind. Aus diesem Grund sind Konversationen sehr leistungsfähig, da sie alle Kommunikationsereignisse aller Kanäle pro Benutzer enthalten, so dass Sie den Kommunikationskontext beibehalten und Ihren Benutzern bessere und intelligentere Kommunikationserlebnisse bieten können.

  1. Alle entsprechenden Ereignisse werden an Ihre Anwendung weitergeleitet. Diese Ereignisse können sowohl an das Backend als auch an die Client-Anwendung gesendet werden:

    a. und b. Zu Ihrem Backend über event_url Webhaken, die Sie Ihrer Vonage-Anwendung zuweisen können. Es gibt sowohl Sprachereignisse als auch RTC-Ereignisse. Ereignisse für Ihre Vonage-Anwendung Stimme event_url Webhook werden von Voice API versendet. Ereignisse für die RTC-Fähigkeit Ihrer Vonage-Anwendung event_url Webhook werden von der Conversation API versendet.

    c. Zu Ihrer Client-seitigen Anwendungdas ist integriert mit dem Client SDK. Diese Ereignisse können über Callbacks empfangen werden, die die Client SDKs auslösen, wenn ein Benutzer beim SDK angemeldet ist. Sie können auch über Push-Benachrichtigungen empfangen werden, wenn sie aktiviert worden sindund die App ist im Hintergrund.

Anmerkung: Nur ausgewählte Ereignisse werden an die Client-SDKs weitergeleitet. Um alle Ereignisse zu erhalten, stellen Sie sicher, dass Sie einstellen. event_url Webhooks für Ihre Vonage-Applikation. Die Einrichtung von Ereignis-Webhooks ist nicht obligatorisch, wird aber dringend empfohlen.

Referenz

Weitere Informationen finden Sie in der folgenden Dokumentation:

Leitfäden

API-Referenzen