Webhooks
Los Webhooks dentro de Herramientas permiten avisar a sistemas externos cuando ocurren determinados eventos en uCRM. Cada webhook envía peticiones HTTP a una o más direcciones (endpoints) que configurás.
Lo importante es sobre qué tipo de dato actúa el webhook: contactos o eventos del calendario. Eso lo definís con la Categoría.
Acceso
- Abre Herramientas en la barra lateral del CRM.
- Selecciona la pestaña Webhooks (junto al gestor de contactos, filtros, conflictos, etc.).
Categoría: Contactos o Calendario
La Categoría indica si el webhook reacciona a cambios en contactos o a cambios en eventos del calendario. La Acción (Crear / Actualizar / Borrar) siempre se aplica a esa categoría.
| Categoría | Qué significa |
|---|---|
| Contactos | El webhook se dispara cuando ocurre algo sobre un contacto en uCRM—por ejemplo se crea, actualiza o borra un contacto. Usala cuando tu integración depende de la ficha o del ciclo de vida del contacto. |
| Calendario | El webhook se dispara cuando ocurre algo sobre un evento del calendario (una cita o entrada en la agenda)—por ejemplo se crea, actualiza o borra ese evento. Usala cuando necesitás reaccionar a reuniones, recordatorios u otras actividades calendarizadas, no al contacto en sí. |
Elegí Contactos para flujos de CRM sobre personas; elegí Calendario para flujos ligados a la agenda. Si necesitás ambos casos, lo habitual es configurar webhooks distintos (uno por categoría y acción que te interese).
Lista de webhooks
La pantalla principal muestra una tabla con los webhooks configurados. Las columnas habituales incluyen:
- Nombre — identificador del webhook (la lista puede ordenarse por nombre).
- Categoría — Contactos o Calendario (ver tabla anterior).
- Acción — Crear, Actualizar o Borrar (respecto de la categoría elegida).
- Endpoint — URL(s) de destino.
- Habilitada — si el webhook está activo.
- Acciones — opciones para editar o eliminar el webhook cuando hay filas.
Usa el campo Buscar para filtrar la lista. Si aún no hay webhooks, verás un estado vacío hasta crear el primero.
Crear un webhook
- Pulsa Nuevo (+).
- En el cuadro Webhooks, completa el Nombre del webhook (campo obligatorio). El icono de información puede mostrar ayuda adicional en el producto.
- Elige Categoría: Contactos o Calendario, según quieras notificaciones por cambios en contactos o en eventos del calendario. Es un campo obligatorio.
- Elige Acción: Crear, Actualizar o Borrar para esa categoría. El icono de información junto al campo puede ofrecer más contexto en el producto.
- Opcional: Habilitada — si no está marcada, estos endpoints no se activarán hasta que habilites el webhook.
- En Endpoints:
- Pulsa Agregar endpoint para añadir otra URL.
- Completa cada URL en su campo.
- Usa el icono de eliminar junto a un endpoint para quitarlo.
- Pulsa Probar endpoints cuando esté disponible para comprobar que las URLs responden correctamente.
- Pulsa Guardar para guardar el webhook o Cancelar para descartar los cambios.
Gestionar webhooks existentes
Desde la lista, usá Acciones en cada fila para editar o eliminar un webhook según tus permisos. Podés modificar nombre, categoría, acción, estado habilitado o endpoints y volver a guardar.
Resumen
| Elemento | Función |
|---|---|
| Contactos | El webhook aplica a crear / actualizar / borrar contactos |
| Calendario | El webhook aplica a crear / actualizar / borrar eventos del calendario |
| Acción | Crear / Actualizar / Borrar (dentro de la categoría elegida) |
| Habilitada | Si no está marcada, los endpoints no se activan |
| Endpoints | Una o más URLs que reciben las notificaciones |
| Probar endpoints | Validar conectividad cuando el control esté habilitado |