Notificaciones & WebHooks

Una sección importante de la API de Sirena 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 Sirena (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 vendedor

Registración y Uso de las Notificaciones

Una vez obtenida la API Key para acceder a la API de Sirena, Ud. podrá 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) ocurrá dentro de la Plataforma, Sirena notificará a la URL de retorno registrada a través de una operación (request) HTTP POST.

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



Recuerde que para poder obtener acceso a la API, necesita una API Key. Si ese es el caso, le recomendamos continuar en: Autenticación & API Keys

0 Comments

Add your comment

E-Mail me when someone replies to this comment