# Configurar Webhooks

Gran parte de los recursos son accedidos por medio de webhooks. Por lo que en esta sección te mostraremos como configurar los endpoints para recibir eventos configurables y obtener así los datos correspondiente.

## Configuración

Para poder configurar los webhooks, debes primero estar loggeado en Persat, luego dirigirte a la esquina superior derecha de la pantalla principal, y presionar la opción "Integraciones y Partners" en la configuración de usuario.

![](/files/FTUNuMM2NtQRbFpnwLws)

Una vez dentro de la sección, presioná dentro del recuadro de la izquierda "Integra con nuestra API".

![](/files/QCQDQUGWlSki3eKvoFK5)

Seleccioná la opción Webhooks, y luego **Administrar webhooks**

Arriba a la derecha, podemos crear un nuevo endpoint con el boton "+ Add Endpoint"

![](/files/-Mf2zxlYf7LIlfM6rP5i)

Completá los datos de tus endpoints, recordá seleccionar cuales eventos van a ser escuchados por el mismo. Podés seleccionar uno, o varios. En caso de no seleccionar ninguno, se toma por defecto que se quiere escuchar a todos los eventos disponibles.

Hay 19 eventos disponibles

* **checkme.check\_in**  Se genera cuando el usuario de la app [Persat Check Me](https://play.google.com/store/apps/details?id=com.pst.checkme\&hl=es_AR\&pli=1) hace click en Fichar Entrada.
* **checkme.check\_out**  Se genera cuando el usuario de la app [Persat Check Me](https://play.google.com/store/apps/details?id=com.pst.checkme\&hl=es_AR\&pli=1) hace click en Fichar Saluda.
* **client.created** Se genera, tanto cuando se crea un cliente de forma manual, como así también cuando se importa un listado de clientes desde un archivo .csv&#x20;
* **client.updated** Se genera, tanto cuando se modifica un cliente particular, como así también cuando se realiza una modificación masiva desde un archivo .csv
* **client.deleted** Se genera cuando se elimina un cliente
* **delivery.created**  Se genera, tanto cuando se crea una nueva entrega de forma manual, como así también cuando se importa un listado de entregas desde un archivo excel
* **delivery.deleted**  Se genera tanto cuando se elimina una entrega particular, como cuando se eliminan varias entregas al mismo tiempo (operaciones masivas), asi como también si se elimina una entrega desde el endpoint correspondiente de la API
* **deliveryRoute.assigned:** Se genera cuando se asigna una ruta a un dispositivo. \ <mark style="color:red;">IMPORTANTE:</mark> Solo funciona en el módulo de entregas.
* **deliveryRoute.updated:** Se genera cuando se modifique la ruta asignada, existen varios casos que pueden disparar este evento. Están definidos [acá](/modulos/gestion-de-entregas/rutas-de-entrega/eventos-webhooks/ruta-modificada.md).
* **deliveryRoute.canceled:** Se genera cuando el usuario administrador o quien tenga permisos suficientes cancela una Ruta ya asignada.
* **delivery.finished**  Se genera tanto cuando se finaliza una entrega desde el celular, como cuando se finaliza desde la web por el administrador o quien tenga el permiso correspondiente.
* **digitalform.created**  Se genera cuando se inserta un nuevo formulario. Esto puede realizarse tanto desde la web como desde la app de Android.
* **digitalform.updated**  Se genera cuando se modifica un formulario existente. Esto puede realizarse tanto desde la web como desde la app de Android.
* **digitalform.state\_updated**  Se genera cuando el administrador o el usuario que posea permisos necesarios, modifique el estado de un formulario. Esta operación se realiza siempre desde la web.
* **digitalform.state\_updated\_massively**  Se genera cuando el administrador o el usuario que posea permisos necesarios, modifique el estado de formulario de forma masiva(el estado al que cambian es el mismo para todos). Esta operación se realiza siempre desde la web.
* **workorder.created**  Se genera cuando crea una OT en Persat. Esta operación se realiza siempre desde la web.
* **workorder.updated**  Se genera cuando la OT es modificada. Por ejemplo cuando se modifica el formulario de instrucciones, o se modifica la fecha y el horario de asignación. \ <mark style="color:red;">IMPORTANTE</mark>: No se dispara cuando la OT es finalizada o cerrada,
* **workorder.finished**  Se genera cuando el técnico da por finalizada la Orden de trabajo desde la app de Android.
* **workorder.closed**  Se genera cuando el administrador o el usuario que posea permisos necesarios, de por cerrada una orden de trabajo. Esta operación se realiza siempre desde la web.

![](/files/-Mfi9lpnQqoH5tBGs2yY)

{% hint style="info" %}
La información que se recibe en cada uno de los eventos, se explica con más detalle en las seccione posteriores.
{% endhint %}

{% hint style="success" %}
Listo, ya tenemos creados el/los webhooks necesarios para escuchar los eventos.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.api.persat.com.ar/como-usar-la-api/nueva-entrega.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
