Enviar clientes potenciales a otras herramientas

Con un webhook, Konvuno envía cada nuevo cliente potencial a la dirección que elijas en cuanto el visitante envía el formulario. La mayoría de los negocios lo dirigen a Zapier o Make, que pasan el cliente potencial a un CRM, una hoja de cálculo o una lista de correo, sin código. Los desarrolladores pueden dirigirlo a su propio servidor.

El webhook está incluido en todos los planes de pago y solo un propietario puede configurarlo. Se suma al correo sobre nuevos clientes potenciales en lugar de sustituirlo, y cada cliente potencial sigue llegando a la pantalla Clientes potenciales.

Configurarlo#

1. Crea un webhook en la herramienta que debe recibir tus clientes potenciales y copia su dirección:
   • Make: empieza un escenario con Webhooks → Custom webhook, haz clic en Add y copia la dirección que muestra Make. Los webhooks personalizados funcionan en el plan gratuito de Make.
   • Zapier: crea un Zap con Webhooks by Zapier como disparador y Catch Hook como evento, y copia la URL del webhook. Zapier solo ofrece webhooks en sus planes de pago.
   • Tu propio servidor: cualquier dirección https:// que acepte un POST JSON.
2. En Konvuno, abre Configuración → Integraciones.
3. Pega la dirección en URL del webhook y haz clic en Conectar.
4. Haz clic en Enviar prueba. Zapier y Make aprenden los campos de un cliente potencial a partir de esta primera solicitud, así que envíala antes de asignar los campos en el siguiente paso de tu Zap o escenario.

La dirección debe empezar por https://. Los clientes potenciales son datos personales, así que Konvuno nunca los envía sin cifrar y rechaza las direcciones que llevan a una red privada.

Comprobar que funciona#

La etiqueta junto a la dirección indica cómo va el webhook:

• Activo — el último cliente potencial llegó.
• Con errores — el último intento no llegó y Konvuno lo vuelve a intentar. La línea bajo la dirección dice por qué.
• En pausa — desactivaste el envío.
• Detenido — la herramienta que recibe los datos indicó que la dirección ya no existe, así que Konvuno se detuvo por su cuenta.

Envíos recientes muestra los últimos diez envíos, incluidos los de prueba, con la respuesta que dio la herramienta. Un cliente potencial de prueba es igual que uno real, con datos claramente inventados y "test": true, para que puedas descartarlo en tu Zap o escenario.

Qué se envía#

Cada cliente potencial es un POST JSON:

{
  "type": "lead.created",
  "timestamp": "2026-09-25T10:00:05.000Z",
  "data": {
    "lead_id": "6f7a3c1e-…",
    "created_at": "2026-09-25T10:00:03.000Z",
    "name": "Lucía García",
    "email": "[email protected]",
    "phone": "+34 612 555 012",
    "company": null,
    "message": "¿Tienen esta bici en una talla más pequeña?",
    "consent_given": true,
    "consent_text": "Acepto que me contacten sobre mi solicitud.",
    "business_id": "4e6f7274-…",
    "business_name": "Northwheel",
    "conversation_id": "c0f3…",
    "source_url": "https://northwheel.example",
    "dashboard_url": "https://app.konvuno.com/leads?lead=6f7a3c1e-…",
    "test": false
  }
}

Un campo que el visitante dejó vacío vale null. source_url es el sitio web en el que ocurrió el chat, y dashboard_url abre el cliente potencial en Konvuno. El contenido del chat no se envía — abre el cliente potencial para leerlo.

Cuando un cliente potencial no llega#

Si la herramienta que recibe los datos no responde con éxito, Konvuno lo vuelve a intentar tras 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas, 12 horas y 24 horas — unos dos días en total. Si el cliente potencial sigue sin llegar, Konvuno deja de intentarlo y envía un correo a la cuenta que registró el negocio (como mucho un correo de este tipo al día). Un cliente potencial que nunca llegó a tu herramienta sigue en la pantalla Clientes potenciales.

Las causas habituales son un Zap o un escenario desactivado, o una dirección que cambió. Soluciónalo y haz clic en Enviar prueba. Si cambiaste la dirección, los reintentos en curso van a la nueva.

Pausar, cambiar o quitar#

• Enviar desactiva y activa el envío. Los clientes potenciales que llegan mientras está desactivado no se envían después.
• Cambiar URL dirige el webhook a otra dirección. Tu secreto de firma sigue siendo el mismo.
• Quitar detiene el envío y borra el historial de envíos. Tus clientes potenciales siguen en Konvuno.

Si tu plan termina, el webhook se queda, pero no se envía nada hasta que vuelvas a elegir un plan.

Comprobar que una solicitud viene de Konvuno#

Esta parte es para desarrolladores. Cada solicitud se firma según Standard Webhooks, con tres cabeceras: webhook-id, webhook-timestamp y webhook-signature. Verifícalas con cualquier biblioteca de Standard Webhooks y el Secreto de firma que aparece bajo la dirección.

webhook-id es el mismo en cada reintento del mismo cliente potencial, así que úsalo para descartar uno que ya recibiste. Nuevo secreto sustituye el secreto al instante — actualízalo en tu servidor justo después.