> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.flokzu.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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:
![](https://storage.crisp.chat/users/helpdesk/website/ccc3fbb5dc442800/user-create_17p8wt1.png)


|| 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:

![](https://storage.crisp.chat/users/helpdesk/website/ccc3fbb5dc442800/webhooks-usuarios-update_1k893pr.png)

#### 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:
![](https://storage.crisp.chat/users/helpdesk/website/ccc3fbb5dc442800/out-office-es_1ncq5v7.png)


|| 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:


![](https://storage.crisp.chat/users/helpdesk/website/ccc3fbb5dc442800/user-login_1xhi52q.png)
 
## Configurar webhooks

Los webhooks de usuario deben ser configurados desde l sección _Configuración Avanzada_ . 

![](https://storage.crisp.chat/users/helpdesk/website/ccc3fbb5dc442800/conf-webhooks-usuarios_jff0ki.png)



 
||| **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. 
