# Enviar clientes potenciales a otras herramientas

> Envía cada nuevo cliente potencial a Zapier, Make, tu CRM o tu propio servidor con un webhook — cómo configurarlo, probarlo, y qué pasa cuando un cliente potencial no llega.

Envía cada nuevo cliente potencial a Zapier, Make, tu CRM o tu propio servidor con un webhook — cómo configurarlo, probarlo, y qué pasa cuando un cliente potencial no llega.

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](https://konvuno.com/es/help/leads/notifications) en lugar de sustituirlo, y cada cliente potencial sigue llegando a la pantalla Clientes potenciales.

![La tarjeta del webhook en Ajustes, con una dirección de Zapier escrita](https://konvuno.com/help/shots/es/leads/webhook-connect.webp)

La tarjeta del webhook en Ajustes, con una dirección de Zapier escrita

## 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

![El webhook después de un cliente potencial de prueba: la dirección, su estado y los envíos recientes](https://konvuno.com/help/shots/es/leads/webhook-active.webp)

El webhook después de un cliente potencial de prueba: la dirección, su estado y los envíos recientes

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:

```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": "lucia@example.com",
    "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](https://www.standardwebhooks.com), 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.

Nota

Cuando un cliente potencial llega a tu herramienta, también queda guardado allí. Eliminar el cliente potencial en Konvuno no elimina esa copia — quítala en la propia herramienta.

Cómo lo usan otros negocios

- **Una tienda de bicicletas** envía cada cliente potencial, a través de Make, a una hoja de Google que comparte todo el equipo.
- **Una agencia web** pasa los clientes potenciales de su web directamente a su CRM con un Zap, donde un comercial los recoge junto con todo lo demás.
- **Una empresa de tejados** convierte cada cliente potencial en una tarea de su tablero de proyectos, que recoge el primer técnico libre.
- **Una empresa de software** dirige el webhook a su propio servidor, comprueba la firma y abre un ticket por cada cliente potencial.

---

Canonical: https://konvuno.com/es/help/leads/webhook
Index: https://konvuno.com/llms.txt