Webhooks — recibir leads desde formularios y enviar eventos a otros sistemas
Lymera ofrece dos tipos de webhooks:
# Webhooks: recibir leads y enviar eventos
📘 Qué es
Lymera ofrece dos tipos de webhooks:
- Fuente Webhook de una campaña (entrante): te da una URL única para que tus formularios, landing pages u otros sistemas envíen contactos directamente a una campaña.
- Webhooks Salientes: Lymera envía eventos (lead creado, estado cambiado, notas, reuniones, llamadas, mensajes de LinkedIn, correos y WhatsApp) a una URL de tu sistema mediante HTTP POST.
📍 Dónde encontrarlo
- Entrante: Campañas › tu campaña › pestaña de configuración › sección Leads › Fuente Webhook.
- Saliente: Setup › Integraciones › sección Webhooks Salientes (hasta 10 webhooks por empresa).
🛠️ Cómo se hace
Recibir leads con la Fuente Webhook
- Abre la campaña y activa Fuente Webhook (genera una URL única e inmutable, visible en el editor).
- Copia la URL. Trátala como una contraseña: no la pongas en código público de tu sitio.
- Desde tu formulario, envía un POST en formato JSON con al menos
nameyemail. Campos opcionales: apellido, teléfono con código de país, empresa, cargo, URL de LinkedIn, origen del lead (por ejemplo «Meta Ads»), temperatura (COLD, WARM o HOT; por defecto COLD), contexto, sector, tamaño, ciudad, país, sitio web y facturación anual. Tu equipo técnico puede consultar la referencia completa en la sección de webhooks de la documentación de la plataforma. - Respuestas: 200 con «received» = recibido; si el contacto ya existía por email se enriquece; 400 = faltan nombre o email o el email no es válido; 403 = token inválido, webhook desactivado o campaña no activa; 429 = demasiadas solicitudes (máximo 100 por minuto por campaña).
- Los contactos nuevos entran al proceso de scoring y siguen las reglas de la campaña.
Crear un Webhook Saliente
- En Integraciones › Webhooks Salientes pulsa Nuevo webhook.
- Completa Nombre, URL destino, descripción opcional y, si lo necesitas, Headers personalizados (Añadir header).
- En Eventos marca al menos uno (agrupados en Leads, Notas y reuniones, Llamadas, LinkedIn, Email y WhatsApp).
- Deja Webhook activo encendido y pulsa Probar envío (requiere que esté activo): verás «Enviado correctamente (HTTP 200)» o «Falló».
- Pulsa Crear webhook.
Revisar y reintentar envíos
En la lista (columnas Nombre, URL, Estado, Último HTTP, Eventos, Último envío) pulsa Ver logs para ver cada intento con estado Pendiente, Enviado, Reintentando, Fallido o Muerto, el código HTTP y los intentos. Usa Reintentar en un envío fallido y Recargar logs. Puedes Editar o Eliminar el webhook (eliminar no se puede deshacer).
❓ Preguntas frecuentes
¿La URL de la Fuente Webhook cambia? No: es inmutable y exclusiva de la campaña.
¿Qué pasa si envío el mismo contacto dos veces? Si el email ya existe en la campaña, se completan los datos faltantes; un reenvío inmediato se marca como duplicado.
¿Por qué mi webhook me responde 403? El webhook está desactivado, la campaña no está activa o el token de la URL es incorrecto.
¿Puedo recibir WhatsApp o correos en mi sistema? Sí, con los eventos de Webhooks Salientes «Email enviado/recibido» y «WhatsApp enviado/recibido».
¿Cuántos webhooks salientes puedo tener? Hasta 10 por empresa.
¿Puedo ver el contenido que envió Lymera? En Ver logs ves el estado y el código HTTP de cada intento.
🔧 Si algo no funciona
| Síntoma | Causa común | Qué revisar | Cuándo escalar |
|---|---|---|---|
| El formulario recibe 403 | Webhook desactivado, campaña no activa o URL incorrecta | Activa la Fuente Webhook, activa la campaña y copia de nuevo la URL | Si todo está activo |
| Respuesta 400 | Faltan name o email | Revisa el formato JSON | — |
| Respuesta 429 | Más de 100 solicitudes por minuto | Reduce el ritmo | Si necesitas más volumen |
| Los leads llegan pero no entran a la secuencia | Puntaje ICP mínimo de la campaña o reglas de la campaña | Revisa «ICP Score mínimo» | Si no encuentras la causa |
| Webhook saliente en «Fallido» o «Muerto» | Tu servidor respondió error o no respondió | Revisa el código HTTP del log; corrige tu endpoint y pulsa Reintentar | Si tu endpoint funciona y falla |
| «Máximo de 10 webhooks alcanzado» | Límite por empresa | Elimina uno | — |
| «El webhook debe estar activo para probarlo» | Está inactivo | Actívalo | — |
Datos que debes pedir al cliente: empresa, campaña, nombre del webhook, URL destino (sin tokens), código HTTP, hora del intento, ejemplo del cuerpo enviado (sin datos sensibles) y captura del log.