Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

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:

  1. 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.
  2. 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

  1. Abre la campaña y activa Fuente Webhook (genera una URL única e inmutable, visible en el editor).
  2. Copia la URL. Trátala como una contraseña: no la pongas en código público de tu sitio.
  3. Desde tu formulario, envía un POST en formato JSON con al menos name y email. 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.
  4. 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).
  5. Los contactos nuevos entran al proceso de scoring y siguen las reglas de la campaña.

Crear un Webhook Saliente

  1. En Integraciones › Webhooks Salientes pulsa Nuevo webhook.
  2. Completa Nombre, URL destino, descripción opcional y, si lo necesitas, Headers personalizados (Añadir header).
  3. En Eventos marca al menos uno (agrupados en Leads, Notas y reuniones, Llamadas, LinkedIn, Email y WhatsApp).
  4. Deja Webhook activo encendido y pulsa Probar envío (requiere que esté activo): verás «Enviado correctamente (HTTP 200)» o «Falló».
  5. 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íntomaCausa comúnQué revisarCuándo escalar
El formulario recibe 403Webhook desactivado, campaña no activa o URL incorrectaActiva la Fuente Webhook, activa la campaña y copia de nuevo la URLSi todo está activo
Respuesta 400Faltan name o emailRevisa el formato JSON—
Respuesta 429Más de 100 solicitudes por minutoReduce el ritmoSi necesitas más volumen
Los leads llegan pero no entran a la secuenciaPuntaje ICP mínimo de la campaña o reglas de la campañaRevisa «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 ReintentarSi tu endpoint funciona y falla
«Máximo de 10 webhooks alcanzado»Límite por empresaElimina uno—
«El webhook debe estar activo para probarlo»Está inactivoActí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.