Saltar al contenido principal
Actualizado el Aug 4, 2026

Webhooks

Lo que aprenderás
  • Qué son los webhooks y cómo funcionan en AutoTalk
  • Qué contiene cada entrega y cómo se comportan las entregas
  • Cómo crear y gestionar endpoints de webhook

Webhooks envían notificaciones en tiempo real a servicios externos cuando ocurren eventos en AutoTalk. En lugar de verificar repetidamente la API de AutoTalk en busca de nuevos datos, tu sistema externo recibe una notificación automática en el momento en que algo sucede, como la llegada de un nuevo mensaje o la actualización de un contacto.

Gestionas los webhooks desde la página Webhooks en Integraciones en la barra lateral.

Cómo funcionan los webhooks​

  1. Proporcionas una URL del webhook (un endpoint en tu servidor o un servicio de terceros que pueda recibir solicitudes HTTP).
  2. Eliges un Modelo de datos y una Operación (por ejemplo, contacts + afterCreate) que deben activar el webhook y, opcionalmente, un Filtro CEL para acotar qué cambios lo disparan. Tus propios Tipos Personalizados también funcionan — elige la entrada ct:<slug> en el dropdown de Modelo (para Tipos Personalizados se disparan las operaciones afterCreate, afterUpdate y afterDelete).
  3. Cuando ocurre un cambio coincidente en AutoTalk, la plataforma envía una solicitud HTTP POST a tu URL del webhook con los datos del evento en formato JSON.

Tu sistema externo recibe los datos y puede actuar sobre ellos según sea necesario, ya sea actualizando una base de datos, enviando una notificación o disparando un workflow.

Carga útil de la entrega​

Cada entrega es una solicitud HTTP POST con un cuerpo JSON en una estructura estable:

{
  "id": "contacts:afterCreate:66a1b2c3d4e5f6a7b8c9d0e1:2026-07-02T14:03:07.512Z",
  "model": "contacts",
  "op": "afterCreate",
  "at": "2026-07-02T14:03:07.512Z",
  "companyId": "664a0f9eb1c2d3e4f5a6b7c8",
  "tenantId": "664a0f9eb1c2d3e4f5a6b7c8",
  "doc": {
    "_id": "66a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Jane Doe",
    "createdAt": "2026-07-02T14:03:07.498Z",
    "updatedAt": "2026-07-02T14:03:07.498Z"
  },
  "prev": null
}
CampoSignificado
idUn identificador por evento que combina el modelo, la operación, el ID del registro y la marca de tiempo
modelEl modelo de datos que cambió — un modelo integrado como contacts, o ct:<slug> para un Tipo Personalizado
opLa operación del ciclo de vida que disparó el webhook (por ejemplo afterCreate, afterUpdate, afterDelete)
atCuándo se disparó el evento, como una marca de tiempo ISO 8601
companyId / tenantIdEl ID de tu empresa (ambos campos llevan el mismo valor)
docEl registro involucrado en el evento (el ejemplo anterior está truncado — recibes el registro completo)
prevLa versión anterior del registro, cuando existe (actualizaciones); null en caso contrario (por ejemplo, en las creaciones)
nota

Para las entregas de afterDelete de Tipo Personalizado (ct:), doc no es el registro eliminado — es un objeto de resumen {filter, hardDelete, deletedCount} que describe la eliminación, y prev es siempre null.

Semántica de la entrega​

  • Cada evento recibe un único intento de entrega por webhook — las entregas fallidas no se reintentan.
  • La solicitud expira después de 5 segundos y las redirecciones no se siguen — apunta el webhook directamente a un endpoint que responda rápido.
  • Responde con cualquier estado 2xx para confirmar la recepción; el cuerpo de la respuesta se ignora, y una respuesta que no sea 2xx cuenta como una entrega fallida.
  • Las entregas fallidas se registran — usa el botón Logs en la página de detalles del webhook para revisar los intentos recientes.
  • Las entregas no están firmadas. Si tu receptor necesita verificar que una solicitud realmente vino de AutoTalk, incluye un token difícil de adivinar en tu URL del webhook (por ejemplo, un parámetro de consulta secreto) y verifícalo en tu lado.

Gestionar webhooks​

Ver webhooks existentes​

Navega a Integraciones > Webhooks. La página muestra una lista titulada Webhooks con todos tus endpoints configurados. La lista sigue el formato CRUD estándar de AutoTalk con opciones para filtrar, ver, editar y eliminar entradas.

Crear un nuevo webhook​

  1. En la página de Webhooks, haz clic en el botón + (información sobre herramientas "Agregar nuevos webhooks").
  2. Completa los campos:
    • URL del webhook — El endpoint donde AutoTalk debe enviar los datos del evento (debe ser una URL HTTP/HTTPS pública)
    • Activado — Si el webhook se dispara (activado por defecto)
    • Disparador — Un Modelo, una Operación y un Filtro CEL opcional que deciden qué cambios disparan el webhook
  3. Guarda el webhook.

AutoTalk ahora enviará una solicitud HTTP POST a tu URL del webhook cada vez que ocurra un cambio coincidente.

Editar o eliminar un webhook​

  • Haz clic en cualquier webhook de la lista para ver sus detalles y modificar su configuración. La página de detalles también tiene un botón Logs que muestra los intentos de entrega recientes.
  • Para detener las notificaciones a un endpoint específico, elimina el webhook de la lista.

Próximos pasos​

Última actualización en
En esta página