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