Webhooks Usuarios
Webhooks de usuarios
En Flokzu puedes compartir la información sobre eventos que suceden sobre tus usuarios con sistemas externos a través de webhooks.
Los webhooks proporcionan un mecanismo para notificar a tu aplicación cuando se produzca un determinado evento que afecta a un usuario y así poder tomar acciones.
En Flokzu hay varios eventos que pueden ser tomados en cuenta al momento de configurar los webhooks de usuario:
- Cuando un usuario es invitado a Flokzu
- Cuando un usuario acepta la invitación y se transforma en usuario activo.
- Cuando se desususcribe un usuario de los mails.
- Cuando el usuario es borrado.
- Cuando se modifica el usuario nombre o alias.
- Cuando se agrega, modifica o quita la suplencia.
- Cuando el usuario se loggea en Flokzu.
Las acciones en tu sistema dependerán de lo que desees y deberás configurar la URL para ejecutarla.
¿Cómo funcionan los webhooks?
Imagina un sistema de timbre, el mismo incluye un botón en la puerta y una campana en tu sala de estar.
Cuando una persona presiona el botón, suena la campana en la sala, lo que te informa que alguien está en la puerta - es decir, una señal es enviada desde el botón al timbre.
En este ejemplo: alguien llegará a la puerta y presionará el botón, la campana escuchará el botón y sonará.
Los Webhooks funcionan de la misma manera, la puerta será Flokzu, el botón será el evento que sucede en Flokzu y la campana el sistema al cual notificarás de ese evento.
Para los webhooks: Sucederá un evento asociado a un usuario en Flokzu, el otro sistema escuchará ese evento y realizará una acción en base a ello, por ejemplo Actualizar datos.
Webhook: user:create
Un webhook configurado para el evento user:create será ejecutado al momento de que un usuario sea invitado a Flokzu.
El formato para cada Json enviado al servicio es el siguiente:
Webhook: user:update
Un webhooks configurado para el evento user:update será ejecutado en caso de que alguna de las siguientes acciones sucedan:
- Cuando un usuario acepta la invitación y se transforma en usuario activo.
- Cuando se desususcribe un usuario de los mails.
- Cuando el usuario es borrado.
- Cuando se modifica el usuario nombre o alias.
El formato para cada Json enviado al servicio es el siguiente:
WebHook user:out-of-office
Un webhook configurado para el evento user:out-of-office será ejecutado al momento de que se agregue, modifique o quite la suplencia de un usuario.
El formato para cada Json enviado al servicio es el siguiente:
WebHook user:login
Un webhook configurado para el evento user:login será ejecutado al momento de que un usuario se loggea en Flokzu.
El formato para cada Json enviado al servicio es el siguiente:
Configurar webhooks
Los webhooks de usuario deben ser configurados desde l sección Configuración Avanzada .
La versión actual no prevé una política de reintentos. Para garantizar la integridad de los datos en tu implementación, puedes utilizar el timestamp del evento.
Actualizado el: 07/07/2020
¡Gracias!