Artículos sobre: Usuarios y roles
Este artículo también está disponible en:

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:



Alias es el email alias que defina el usuario en su perfil.


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:



Cuando se elimina una suplencia se debe enviar el payload con action Deleted y con los datos de substitute, start y end como strings vacios. En el caso de ser modificada la suplencia el action es Updated.




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

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!