Webhooks salientes

Tus sistemas se enteran en el momento en que ocurre

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.

  • 31 eventos
  • Firmados con HMAC-SHA256
  • Reintentos con espera progresiva

Última actualización:

Todos los eventos a los que puedes suscribirte

Suscribe cada endpoint solo a los eventos que le interesan, en lugar de recibirlo todo y filtrar por tu cuenta.

Contactos y embudo

4
  • contact.created
  • contact.updated
  • contact.deleted
  • pipeline.stage_changed

Mensajería

3
  • message.sent
  • message.received
  • sequence.completed

Campañas de prospección

4
  • outreach.step.sent
  • outreach.replied
  • outreach.completed
  • outreach.unsubscribed

Negocios

5
  • deal.created
  • deal.updated
  • deal.stage_changed
  • deal.won
  • deal.lost

Tareas

2
  • task.created
  • task.completed

Finanzas

4
  • invoice.created
  • invoice.paid
  • finance.transaction.created
  • subscription.changed

Mesa de soporte

4
  • support.ticket.created
  • support.ticket.updated
  • support.ticket.resolved
  • support.ticket.breached

Cuentas publicitarias

5
  • ads.ad.disapproved
  • ads.budget.exhausted
  • ads.spend.anomaly
  • ads.billing.problem
  • ads.campaign.status_changed

Los detalles de fiabilidad aburridos que deciden si te fías de ello

Cualquiera puede enviar un cuerpo JSON por POST. Firmarlo, reintentarlo y dejarte ver qué pasó es lo que lo hace utilizable en producción.

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.

Reintentos con espera progresiva

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.

Un registro de entregas legible

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.

Suscripción por evento

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.

Varios endpoints

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.

Pruébalo antes de depender de él

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.

Incluye los incumplimientos de SLA de soporte

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.

Todo el negocio, no solo los contactos

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.

Junto a la API REST

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.

Para qué sirven los webhooks salientes

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.

Cómo verificar que una entrega viene de nosotros

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.

Qué pasa cuando tu endpoint no responde

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.

Qué plan necesita

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.

Preguntas frecuentes

A treinta y uno, que cubren contactos y etapas del embudo, mensajería, campañas de prospección, negocios, tareas, facturas y transacciones, suscripciones, tickets de la mesa de soporte, incluidos los incumplimientos de SLA, y alertas de cuentas publicitarias como un anuncio rechazado o un presupuesto agotado.
Cada entrega se firma con HMAC-SHA256 usando el secreto de tu endpoint. Vuelve a calcular la firma a partir del cuerpo sin procesar y compárala en tiempo constante; rechaza todo lo que no coincida.
Las entregas fallidas se reintentan con intervalos crecientes en lugar de descartarse, y el registro de entregas muestra cada intento con la respuesta que dio tu endpoint. Por los reintentos, tu manejador debería ser idempotente.
Sí, hasta veinte, cada uno con su propio secreto y su propia suscripción a eventos, para que cada sistema reciba un flujo distinto.
No. Los webhooks salientes son una función de Business, junto con las claves de API y la API REST pública. El servidor MCP está en todos los planes. Los precios actuales están en la página de precios.
Usa las integraciones con Zapier o n8n. Consumen los mismos eventos y te permiten enviarlos a otras aplicaciones sin escribir ni alojar nada.

Listo para empezar

Deja de sondear en busca de cambios

Los webhooks y la API REST están incluidos en Business.

Plan gratis para siempre · Preparado para el RGPD · Sin tarjeta de crédito