Flujo de eventos

Para comprender las relaciones entre los distintos componentes del sistema y entre las API de Vonage, considera el flujo del sistema de envío de eventos.

Para ilustrarlo, consideremos el caso de uso de una llamada desde un teléfono a un usuario de una aplicación.

Este flujo se resume aquí:

  1. Se inicia una llamada telefónica.
  2. Vonage recibe la llamada y devuelve la llamada en el answer_url webhook.
  3. Se ejecuta una OCNC.
  4. Se crea una convocatoria y los usuarios se conectan a ella.
  5. Se envían los eventos.

Nota: en el caso de uso mencionado, el punto de entrada es una llamada telefónica a un número de Vonage. Sin embargo, el siguiente diagrama y la forma en que se envían los eventos en el sistema, funciona de manera similar para todos los demás tipos de eventos.

Esto se ilustra en el siguiente diagrama:

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 secuencia es la siguiente:

  1. Se realiza una llamada a un Número de Vonageque fue asignado a una aplicación de Vonage.

  2. Vonage recibe la llamada y activa la aplicación de Vonage answer_url webhookque expone su backend.

  3. Que answer_url determina cómo gestionar una llamada y con quién conectarla. Para ello, ejecuta una NCCO, que utiliza numerosas capacidades del Voice API.

  4. A llame a y los usuarios solicitados se conectan a él. Una llamada, al igual que con los eventos de comunicación de Vonage, se produce dentro de un Conversación objeto.

Como resultado de answer_url ejecución, un nuevo Conversación o se obtiene uno ya existente, y se le añaden los usuarios solicitados para conectarse a la llamada. Tenga en cuenta que todos los eventos pasan por la Conversation API y son accesibles a través de ella. Por esa razón, las Conversaciones son muy poderosas, ya que mantienen todos los eventos de comunicación de todos los canales por usuario, permitiéndole retener el contexto de comunicación, y proveer mejores y más inteligentes experiencias de comunicación para sus usuarios.

  1. Todos los eventos respectivos se envían a tu aplicación. Estos eventos pueden ser de entrada al backend o a la aplicación cliente:

    a. y b. A su backend vía event_url webhooksque podrías asignar a tu aplicación de Vonage. Existen eventos de voz y eventos RTC. Eventos a tu aplicación de Vonage voz event_url webhook son enviados por Voice API. Eventos para la capacidad RTC de tu aplicación de Vonage event_url son enviados por la Conversation API.

    c. A su aplicación clienteque es integrado con el Client SDK. Estos eventos pueden recibirse a través de llamadas de retorno que los SDK de cliente activan si un usuario ha iniciado sesión en el SDK. También pueden recibirse a través de notificaciones push, si se han habilitadoy la aplicación está en segundo plano.

Nota: Sólo los eventos seleccionados se envían a los SDK de cliente. Para recibir todos los eventos, asegúrese de que configure event_url webhooks para tu aplicación de Vonage. La configuración de webhooks de eventos no es obligatoria, pero se recomienda encarecidamente.

Referencia

Para más información, consulte la siguiente documentación:

Guías

Referencias API