Un webhook es una forma de que dos sistemas se comuniquen en tiempo real: cuando ocurre algo, uno envía datos al otro a través de una URL. En Epifanía los webhooks se integran a tus automatizaciones (workflows) en dos direcciones: entrantes para recibir información de otros sistemas y salientes para enviarla.
Webhook entrante: recibir datos
El disparador Webhook recibido se activa cada vez que la URL única de tu automatización recibe una petición. Epifanía puede crear un contacto nuevo con esos datos o buscar uno existente y actualizarlo. Por ejemplo: tu pasarela de pagos notifica una compra y el contacto aparece actualizado al instante en tu cuenta, sin que nadie cargue nada a mano.
Los datos viajan en formato JSON, un texto ordenado en pares de campo y valor. Un cuerpo de ejemplo, descrito en texto, contendría dos campos: email con el correo del cliente y estado con el valor pagado. En el disparador mapeas cada campo del JSON al campo correspondiente del contacto, y listo.
Webhook saliente: enviar datos
La acción de webhook saliente envía una petición a la URL que indiques, con los datos del contacto que elijas. La URL de destino puede ser de otro software o de un servicio de integración que conecte con cientos de aplicaciones.
En tu automatización, agrega la acción de Webhook saliente.
Pega la URL de destino que te proporcione el sistema receptor.
Selecciona el método de envío y define los campos a incluir, por ejemplo nombre, teléfono y correo.
Guarda y haz una prueba con un contacto de prueba, verificando que el otro sistema recibió los datos.
Usos típicos
Pasar leads a otro software de tu operación, como un ERP o un sistema de facturación.
Recibir confirmaciones de pago y desencadenar entregas o accesos.
Notificar a tableros internos cuando un lead cruza una etapa clave del embudo.
Reintentos y errores
Si el sistema destino no responde o devuelve un error, Epifanía reintenta automáticamente la petición varias veces antes de marcar el paso como fallido. Revisa los errores en las estadísticas de la automatización y confirma siempre que la URL de destino esté activa y acepte las peticiones de Epifanía.