Conversation API

La Conversation API es una API de bajo nivel que permite crear varios objetos como Eventos, Miembros y Conversaciones.

Las conversaciones son el concepto fundamental en torno al que gira la API. Las conversaciones son contenedores de comunicaciones intercambiadas entre dos o más Usuarios que pueden ser una única interacción o el historial de todas las interacciones entre ellos.

La API también permite crear Eventos para habilitar comunicaciones de texto, voz y personalizadas entre dos Usuarios y almacenarlas en Conversaciones.

Actualmente, las comunicaciones de texto, voz y personalizadas pueden fluir a través de varios canales como App, Teléfono, SIP y Websocket. Para habilitar el canal de la aplicación (para mensajería y voz dentro de la aplicación), también necesitarás utilizar nuestro canal de Vonage. Client SDK.

Los canales telefónicos, SIP y Websocket se activan a través de la función Voice API y todas desembocan en Conversaciones.

Contenido

Funciones compatibles

Product deprecation notice

Effective April 30th, 2026, Vonage In-App Messaging will no longer be available. Access for new users will be closed, and the service will be discontinued for all existing users.

If you have any questions regarding this product’s discontinuation, please contact your account manager or our support team.

Actualmente, la Conversation API admite una serie de canales de comunicación descritos en esta documentación.

A medida que la Conversation API se expanda para admitir más y más servicios de Vonage, los canales admitidos también se expandirán. Como resultado, las conversaciones se convertirían en el contenedor del historial de todas tus comunicaciones intercambiadas a través de los servicios API de Vonage. Se podrá acceder a este historial a través de la Conversation API.

Concepts

  • Cómo configurar su solicitud
  • Aplicaciones: Una aplicación de Vonage proporciona un contenedor para usuarios y conversaciones.
  • Cómo autenticar a los usuarios
  • Usuario: Un usuario representa a una entidad, como una persona, que desea comunicarse.
  • Conversación: Una Conversación conecta a los Usuarios y les permite comunicarse.
  • Flujo de eventos: Este tema brinda una descripción general de un flujo de envío de eventos a través del sistema que abarca los servicios de voz y conversación de Vonage.
  • Miembro: Un Miembro se crea cuando un Usuario se une a una Conversación.
  • Llame a: Una llamada se compone de uno o varios tramos.
  • Canal: Un canal se refiere a uno de los siguientes: App, Teléfono, SIP o Websocket.
  • Evento: Las conversaciones se basan en eventos. Los objetos de evento se generan cuando se producen actividades clave.

Cómo empezar

Empieza con estas guías:

Fragmentos de código

Los fragmentos de código proporcionan ejemplos de código listos para usar, de modo que pueda crear su aplicación rápidamente.

Puede empezar por Crear una conversación.

Casos prácticos

También hay un Caso práctico sobre cómo crear su propio Centro de Contacto.

Referencia