Firmados con HMAC-SHA256
Cada entrega lleva una firma calculada a partir del cuerpo y del secreto de tu endpoint, para que tu receptor pueda verificar que la petición viene realmente de nosotros antes de actuar.
Webhooks salientes
Treinta y un eventos, desde la creación de un contacto hasta un plazo de soporte incumplido o un anuncio rechazado, entregados a tu endpoint como peticiones HTTP POST firmadas y con reintentos automáticos. En el plan Business. Sin bucles de sondeo ni tareas cron preguntando si algo ha cambiado.
Última actualización:
Suscribe cada endpoint solo a los eventos que le interesan, en lugar de recibirlo todo y filtrar por tu cuenta.
Cualquiera puede enviar un cuerpo JSON por POST. Firmarlo, reintentarlo y dejarte ver qué pasó es lo que lo hace utilizable en producción.
Cada entrega lleva una firma calculada a partir del cuerpo y del secreto de tu endpoint, para que tu receptor pueda verificar que la petición viene realmente de nosotros antes de actuar.
Una entrega fallida se reintenta con intervalos crecientes en lugar de descartarse, así que un despliegue o una caída breve por tu parte no hacen que se pierda en silencio el evento que importaba.
Consulta qué se envió, cuándo, qué respondió tu endpoint y cuánto tardó. Depurar una integración deja de ser una discusión sobre si el evento se disparó o no.
Cada endpoint se suscribe a los eventos que quiere. Un servicio logístico al que solo le interesa invoice.paid no tiene por qué recibir y descartar cada actualización de contacto.
Hasta veinte endpoints, para que un sistema de almacén, un reenvío interno a Slack y un almacén de datos reciban cada uno su propio flujo con su propio secreto.
Un evento de prueba te permite verificar el endpoint, la comprobación de la firma y tu manejador antes de que un deal.won real dependa de que los tres funcionen.
support.ticket.breached se dispara cuando se incumple un plazo de respuesta, y es el evento que la mayoría de los equipos quiere en un canal de guardia y no en un panel que nadie tiene abierto.
Contactos, etapas del embudo, mensajes, pasos y respuestas de prospección, negocios, tareas, facturas, transacciones, suscripciones, tickets de soporte y alertas de cuentas publicitarias: todo emite eventos.
El webhook te dice que algo ha ocurrido; la API REST pública te permite leer o modificar el registro afectado. Juntos sustituyen por completo el sondeo.
Un webhook es Pinlyx enviando una petición HTTP POST a una URL que tú controlas en cuanto ocurre algo, en lugar de que tu código nos pregunte cada pocos minutos si ha pasado algo. Hay treinta y un eventos disponibles, cada entrega va firmada, los fallos se reintentan y el registro muestra exactamente qué respondió tu endpoint.
La diferencia práctica está en la latencia y el costo. Una tarea de sondeo que se ejecuta cada cinco minutos llega cinco minutos tarde y casi todas sus peticiones son en balde. Un webhook llega en menos de un segundo y solo cuando hay algo que contar.
Cada endpoint tiene su propio secreto. Calculamos un HMAC-SHA256 del cuerpo de la petición con ese secreto y lo enviamos en una cabecera de firma; tu receptor lo vuelve a calcular y lo compara. Una petición sin una firma coincidente debe rechazarse.
Compara en tiempo constante y no con una igualdad de cadenas normal, y trata el secreto como una contraseña: es lo único que se interpone entre tu endpoint y cualquiera que adivine la URL.
Una respuesta que no sea 2xx o un tiempo de espera agotado marcan la entrega como fallida, y se reintenta con intervalos crecientes. Eso cubre los casos habituales: un despliegue, un reinicio, un bloqueo momentáneo de la base de datos.
Como hay reintentos, tu manejador tiene que ser idempotente. Diséñalo para que recibir el mismo evento dos veces produzca el mismo resultado que recibirlo una, normalmente usando como clave el id del evento. Esto vale para cualquier sistema de webhooks, y es el error que con más frecuencia aparece en forma de registros duplicados.
Los webhooks salientes son una función de Business, con hasta veinte endpoints, igual que la API REST pública que los acompaña. Si prefieres no escribir ningún receptor, las integraciones con Zapier y n8n consumen los mismos eventos en el mismo plan. Los precios actuales están en la página de precios.
Lee y modifica los registros a los que se refieren los eventos.
Deja que un cliente de IA maneje el espacio de trabajo.
Los mismos eventos, sin receptor.
Automatización autoalojada sobre los mismos datos.
De donde sale el evento de incumplimiento de SLA.
Endpoints incluidos en cada plan.
Listo para empezar
Los webhooks y la API REST están incluidos en Business.