Todas las colecciones
Desarrolladores
Notificaciones & WebHooks
Notificaciones & WebHooks

Cómo notificamos a otros sistemas

Diego Pereda avatar
Escrito por Diego Pereda
Actualizado hace más de una semana

Una sección importante de la API de Zenvia Conversion fue construida con el propósito de notificar a otros sistemas cuando ocurren determinados eventos dentro de la plataforma.

La API se encarga de notificar a otros sistemas a través de un pedido (request) HTTP POST a una URL registrada, y envía en el contenido (body) del pedido/request la información relacionada al evento. Está técnica es conocida usualmente como: Webhook.

Actualmente, los eventos (conocidos como Topics) que pueden ser reportados a una URL registrada son:

  •  Cuando un prospect es creado en Zenvia Conversion (a partir de recibir y validar un lead).

  •  Cuando un quote es actualizado y su estado es modificado.

  •  Cuando una Interaction es resuelta por un asesor.

Registro y uso de las notificaciones      

Una vez obtenida la API Key para acceder a la API de Zenvia Conversion, podrás registrar una nueva subscripción (subscription) a determinados eventos (topics), y podrá especificar una URL donde quiere ser notificado (callbackURL). Todo esto, directamente desde la sección Notifications de la API.

A partir del momento que se registra la subscripción, cada vez que el evento (Topic) ocurra dentro de la Plataforma, Zenvia Conversion notificará a la URL de retorno registrada a través de una operación (request) HTTP POST.

Puedes consultar o eliminar las subscripciones disponibles en cualquier momento, directamente desde la API de Notifications.

Recuerda que para poder obtener acceso a la API, necesitas una API Key.

Artículos relacionados:


¿Ha quedado contestada tu pregunta?