Flux d'événements

Pour comprendre les relations entre les différents composants du système et entre les API de Vonage, examinons le flux du système de Dispatch API.

Pour illustrer ce propos, prenons l'exemple d'un appel passé depuis un téléphone à un utilisateur d'application.

Ce flux est résumé ici :

  1. Un appel téléphonique est lancé.
  2. Vonage reçoit l'appel et rappelle sur le answer_url webhook.
  3. Un NCCO est exécuté.
  4. Un appel est créé et les utilisateurs y sont connectés.
  5. Les événements sont déclenchés.

Remarque : dans le cas d'utilisation mentionné, le point d'entrée est un appel téléphonique vers un numéro Vonage. Cependant, le diagramme ci-dessous et la manière dont les événements sont distribués dans le système fonctionnent de manière similaire pour tous les autres types d'événements.

Ceci est illustré dans le diagramme suivant :

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

La séquence est la suivante :

  1. Un appel est passé à un Numéro Vonage, qui était assigné à une Applications Vonage.

  2. Vonage reçoit l'appel et déclenche l'appel de votre application Vonage. answer_url webhookque votre backend expose.

  3. Cela answer_url détermine comment traiter un appel et à qui le connecter. Pour ce faire, il exécute un NCCO, qui utilise de nombreuses capacités de l'application Voice API.

  4. A appel est créé et les utilisateurs demandés y sont connectés. Un appel, comme pour les événements de communication de Vonage, se produit dans une période de Conversation objet.

À la suite de answer_url l'exécution, une nouvelle Conversation est créée, ou un modèle existant est récupéré, et les utilisateurs demandés y sont ajoutés pour se connecter à l'appel. Notez que tous les événements passent par la Conversation API et vous sont accessibles par son intermédiaire. C'est pourquoi les conversations sont très puissantes, car elles contiennent tous les événements de communication de tous les canaux par utilisateur, ce qui vous permet de conserver le contexte de la communication et d'offrir à vos utilisateurs des expériences de communication meilleures et plus intelligentes.

  1. Tous les événements correspondants sont envoyés à votre application. Ces événements peuvent être envoyés au backend ou à l'application cliente :

    a. et b. Vers votre backend via event_url webhooksque vous pouvez assigner à votre application Vonage. Il existe des événements vocaux et des événements RTC. Vous pouvez assigner des Applications à votre application Vonage. voix event_url webhook sont dispatchés par Voice API. Applications à la capacité RTC de votre application Vonage event_url sont envoyés par la Conversation API.

    c. Vers votre application côté clientqui est intégré au Client SDK. Ces événements peuvent être reçus via des rappels que les Client SDK déclenchent si un utilisateur est connecté au SDK. Ils peuvent également être reçus via des notifications push, s'ils ont été activéeset l'application est en arrière-plan.

Remarque : Seuls les événements sélectionnés sont envoyés aux SDK clients. Pour recevoir tous les événements, assurez-vous de fixer event_url webhooks pour votre Applications Vonage. La mise en place de webhooks d'événements n'est pas obligatoire, mais elle est fortement recommandée.

Référence

Pour plus d'informations, voir la documentation suivante :

Guides

Références API