
# Embudos de ventas

La plataforma se conecta a tus embudos de ventas existentes para que, cuando alguien complete un formulario de suscripción en tu página de destino, se añada automáticamente como contacto y reciba un mensaje personalizado, todo ello sin que tengas que hacer nada manualmente.

**En términos sencillos:** Alguien se registra en tu sitio web y, en cuestión de minutos, recibe un mensaje de WhatsApp de tu bot de IA iniciando una conversación real.


---

## Qué hace una integración de embudo

Cuando conectas tu página de destino a la plataforma, cada nuevo cliente potencial es automáticamente:

1. **Agregado como contacto** en la aplicación
2. **Agregado a una lista de contactos específica** que supervisa tu Difusión
3. **Interactuado por tu bot de IA** con un mensaje de apertura personalizado
4. **Seguimiento automático** si no responden

Esto convierte una página de suscripción pasiva en una conversación de ventas activa, gestionada completamente por tu bot de IA.

**Ejemplo: Cómo se ve en la práctica**

```
Someone fills out your landing page form
       |
       v
Your automation tool (Pabbly, Zapier, or Make) sends
the lead's info to the platform
       |
       v
The platform creates the contact and adds them to your list
       |
       v
Your Broadcast sends a personalized WhatsApp message
       |
       v
The lead replies, and your AI bot continues the conversation
```

---

## Qué necesita recopilar tu página de suscripción

Tu página de destino (creada con ClickFunnels, Leadpages, Systeme.io, WordPress o cualquier otra herramienta) necesita recopilar al menos estos dos campos:

### Campos obligatorios

| Campo | Por qué es necesario |
|-------|-----------------|
| **Número de teléfono** | La plataforma envía mensajes a través de WhatsApp o SMS, por lo que un número de teléfono es esencial. Debe incluir el código de país (p. ej., +1 para EE. UU., +34 para España). |
| **Nombre** | Se utiliza para personalizar el mensaje de apertura. Los mensajes con el nombre de la persona obtienen tasas de respuesta significativamente más altas. |

### Opcional pero recomendado

| Campo | Por qué ayuda |
|-------|-------------|
| **Correo electrónico** | Permite el seguimiento multicanal y ayuda a evitar contactos duplicados |
| **Apellidos** | Una personalización más profesional |
| **Campos personalizados** | Cualquier dato relevante para tu oferta (nombre de la empresa, área de interés, etc.) |

**Consejo:** Mantén tu formulario breve. El número de teléfono y el nombre son lo mínimo. Cada campo adicional que añadas reduce la tasa de finalización del formulario. Siempre puedes recopilar información adicional a través de la propia conversación.

---

## Configuración de tu agente para embudos

Un embudo necesita dos cosas: un **Agente de IA** que conozca tu oferta y responda a cada cliente potencial de la misma manera, y una **Difusión** que envíe el primer mensaje a los clientes potenciales que recopila tu embudo. Crea primero el Agente; la Difusión apunta a él.

### Configuración paso a paso

1. **Empieza desde tu agente**
   - ¿Ya tienes uno para esta oferta? En **AI Studio**, haz clic en **AI Agents** y haz clic en su nombre. (En un teléfono, toca primero el icono de menú **☰**).
   - ¿Empiezas desde cero? Haz clic en **New agent** y apúntalo a tu sitio web (leerá tus páginas y escribirá las instrucciones por ti) o elige **Start blank**. Consulta [Creating an Agent](../ai-agents/ai-agents.md#creating-an-agent).
   - Dale un nombre descriptivo, por ejemplo "Webinar Funnel - March 2026".


2. **Configurar el bot**
   - En el paso **AI Instructions**, escribe instrucciones adaptadas a la oferta de tu embudo
   - Añade información de la empresa, preguntas frecuentes y recursos específicos de la oferta en el paso **FAQs & Knowledge**
   - Establece el objetivo de la conversación (p. ej., "Reservar una llamada de consulta gratuita")
   - Consulta la guía [Configuración de tu bot de IA](../ai-automation/ai-bot-setup.md) para obtener instrucciones detalladas


3. **Activa el agente**
   - De vuelta en la página de AI Agents, usa el botón **Activate agent** de la fila para que su estado sea **Active**. A partir de ese momento, responderá a cualquiera que te contacte a través de los canales de los que es responsable.
   - Qué canales son esos lo deciden los [Entry Points](../ai-agents/entry-points.md), ya sea el propio paso **Entry Points** del agente o el panel **Who answers new conversations** en la parte superior de la página de AI Agents.

4. **Crea la Difusión que envía el primer mensaje**
   - Abre [Broadcasts](../broadcasts/broadcasts.md) y crea una. Su paso **Message** contiene el mensaje de apertura que reciben tus clientes potenciales; incluye el nombre del contacto, sé breve, es tu primera impresión.
   - En el paso **Replies**, elige el agente que acabas de crear. Eso es lo que conecta el envío con el cerebro.
   - En WhatsApp, el mensaje de apertura debe enviarse a WhatsApp para su aprobación antes de que pueda enviarse; consulta [WhatsApp Templates](../templates/whatsapp-templates.md).


5. **Anota el ID de tu lista**
   - La automatización de tu embudo necesita el ID de la lista a la que debe agregar clientes potenciales. En **CRM**, abre **Contacts** → **Lists**, abre la lista a la que envía tu Difusión y copia su ID desde allí.


6. **Habilita los seguimientos** (recomendado)
   - Activa los seguimientos automáticos en el paso **Follow-ups** del agente para que los clientes potenciales que no respondan vuelvan a ser contactados.
   - Consulta la guía [Follow-Up System](../ai-automation/follow-ups.md) para obtener más detalles.


---

## Conexión de su embudo a la aplicación

La plataforma funciona con todas las principales plataformas de automatización. A continuación, le explicamos cómo conectar el formulario de su página de destino.

### Opción 1: Uso de Pabbly Connect

Pabbly es rentable y maneja bien los embudos de gran volumen.

**Pasos:**

1. **Configura un disparador de webhook**: esto se activa cuando alguien envía tu formulario de suscripción.
2. **Agrega un retraso de 15-20 minutos** (opcional pero recomendado): da tiempo al cliente potencial para que te envíe un mensaje primero, creando una conversación más natural.
3. **Comprueba si el contacto ya existe**: llama a la API para evitar crear duplicados.
4. **Crea el contacto y agrégalo a tu lista en una sola llamada**: envía su información a la plataforma incluyendo el ID de lista de tu Difusión (`listId`). Una sola solicitud crea el contacto y lo agrega a la lista, y agregarlo a la lista es lo que activa el mensaje de apertura. (Consulta [Direct API Integration](#direct-api-integration) a continuación).

### Opción 2: Usar Zapier

**Pasos:**

1. **Disparador:** Nuevo envío de formulario desde tu página de destino.
2. **Acción 1:** la aplicación - Find Contact (comprobar si ya existen).
3. **Filtro:** Solo continuar si NO se encontró el contacto.
4. **Acción 2:** la aplicación - Create Contact, incluyendo el ID de lista de tu Difusión para que el contacto se cree directamente en la lista. Si prefieres la API sin procesar, un solo POST de "Webhooks by Zapier" a `/v1/contacts` con `listId` hace lo mismo; no se necesita un paso separado de "Add to List".

### Opción 3: Usar Make (anteriormente Integromat)

**Pasos:**

1. **Activador de webhook** desde tu embudo
2. **Comprobar** si el contacto ya existe a través de la API
3. **Crear** el contacto si es nuevo, pasando el ID de lista de tu difusión (`listId`) en la misma solicitud: esto crea el contacto y lo añade a la lista en una sola llamada. Un único módulo HTTP POST a `/v1/contacts` gestiona ambos.

---

## Integración directa mediante API

Si tiene un desarrollador o gestiona el backend de su propio sitio web, puede conectarse directamente a la API de la plataforma sin necesidad de una herramienta de middleware.

### Crea el contacto y añádelo a tu lista, en una sola llamada

No necesitas dos solicitudes separadas. El endpoint de creación de contactos acepta un `listId`, por lo que una sola llamada crea el contacto **y** lo coloca en la lista de tu difusión; añadir el contacto a esa lista es exactamente lo que activa el mensaje de apertura.

```
POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john@example.com",
  "listId": "YOUR_LIST_ID"
}
```

Para añadir el contacto a varias listas a la vez, utiliza `listIds` (una matriz) en su lugar; tiene prioridad sobre `listId`:

```
{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "listIds": ["list123", "list456"]
}
```

> **Usa nombres de campo en camelCase** (`phoneNumber`, `firstName`, `lastName`) - no `phone_number` / `first_name`. Cualquier campo que la plataforma no reconozca se almacenará como un [campo personalizado](../get-started/custom-contact-fields.md) en el contacto; por lo tanto, un `phone_number` mal escrito dejaría al contacto sin número de teléfono y la solicitud sería rechazada.

### Añadir un contacto existente a una lista (opcional)

Si el contacto ya existe y solo necesitas añadirlo a una lista, utiliza el endpoint de añadir a lista con el ID del contacto:

```
POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "contactId": "abc123",
  "listId": "YOUR_LIST_ID"
}
```

Consulta la [referencia de la API de contactos](../api/contacts.md) completa para ver todos los campos disponibles.

**Dónde encontrar tu clave API:** Ve a **Settings** (icono de engranaje, cerca de la parte inferior de la barra lateral izquierda) → **Integrations** → **API Key**.

**Importante:** Incluya siempre el código de país en el número de teléfono (p. ej., `+1` para EE. UU., `+44` para el Reino Unido, `+31` para los Países Bajos).

---

## Cómo los nuevos miembros de la lista activan el mensaje de apertura

Esto es lo que conecta todo, una vez que tu difusión está activa con **Enviar a nuevos miembros de la lista** activado:

1. Se añade un nuevo contacto a la lista que supervisa tu difusión (a través de la automatización, una importación manual o manualmente)
2. La difusión detecta al nuevo contacto
3. Se envía el mensaje de apertura:
   - **1-3 contactos** se envían inmediatamente (este es el escenario normal del embudo: una persona se registra a la vez)
   - **4+ contactos a la vez** se ponen automáticamente en cola y se envían a una velocidad segura para proteger tu reputación como remitente
4. Cuando el contacto responde, el agente en el paso de **Respuestas** de la difusión toma el control de la conversación

---

## El flujo completo del embudo (de principio a fin)

Esto es todo lo que sucede cuando un cliente potencial entra en su embudo:

1. **El cliente potencial rellena tu formulario de registro** en tu página de destino
2. **Tu herramienta de automatización** (Pabbly, Zapier, Make) recibe los datos del formulario
3. **Retraso opcional de 15-20 minutos** para ver si el cliente potencial te escribe primero
4. **La automatización comprueba** si el contacto ya existe en la aplicación
5. **El contacto se crea en tu lista** a través de una única llamada a la API (el ID de lista de la difusión se incluye en la solicitud de creación, por lo que la creación y la adición a la lista ocurren juntas)
6. **La difusión envía** el mensaje de plantilla de WhatsApp de apertura
7. **El cliente potencial lee el mensaje** y responde
8. **Tu bot de IA** inicia una conversación personalizada
9. **El bot trabaja hacia tu objetivo** (reservar cita, calificar al cliente potencial, compartir oferta)
10. **Si el cliente potencial se queda en silencio**, los seguimientos automáticos vuelven a interactuar con él
11. **Si el bot necesita ayuda**, alerta a un miembro del equipo para que tome el control

---

## Mejores prácticas

1. **Añada un breve retraso antes de crear el contacto.** Un retraso de 15-20 minutos da tiempo a los clientes potenciales para escribirle primero. Si lo hacen, entran en el flujo entrante (una conversación más natural). Si no lo hacen, se envía la plantilla saliente.

2. **Activa Enviar a nuevos miembros de la lista para embudos continuos.** En el paso de **Audiencia** de la difusión, esa configuración mantiene la difusión supervisando la lista después de su lanzamiento, por lo que cada nuevo cliente potencial que se registra recibe el mensaje de apertura automáticamente. Los clientes potenciales que te escriben primero son gestionados por el mismo agente a través de sus Puntos de entrada, por lo que ambas direcciones terminan en una sola configuración.

3. **Personalice el mensaje inicial.** Incluya siempre el nombre del contacto en la plantilla de WhatsApp. Los mensajes de apertura genéricos obtienen tasas de respuesta mucho más bajas.

4. **Mantenga el mensaje inicial breve.** Dos o tres frases es lo ideal. Haga una pregunta para invitar a una respuesta. Por ejemplo: "¡Hola {first_name}! Gracias por registrarte para nuestra consulta gratuita. ¿Cuál es el mayor desafío que enfrentas con [tema] en este momento?"

5. **Habilite los seguimientos.** Los clientes potenciales del embudo están interesados pero ocupados. Un seguimiento entre 24 y 72 horas después a menudo los hace volver.

6. **Pruebe el flujo completo antes de lanzarlo.** Envíe una suscripción de prueba en su página de destino, verifique que el contacto se cree en la aplicación y confirme que el mensaje inicial llega correctamente.

7. **Monitorea tus tasas de conversión.** Realiza un seguimiento de cuántos clientes potenciales del embudo responden al mensaje de apertura y cuántos convierten hacia tu objetivo (cita, venta, etc.) desde las estadísticas de la difusión. Ajusta tus instrucciones de IA y el mensaje de apertura según lo que aprendas.

8. **Evite duplicados.** Compruebe siempre si un contacto existe antes de crearlo. Los contactos duplicados generan conversaciones confusas y desperdicio de créditos.

9. **Obtenga el consentimiento adecuado.** Asegúrese de que su página de suscripción indique claramente que el cliente potencial recibirá mensajes de WhatsApp. Incluya una casilla de verificación de consentimiento si es necesario en su región.

---

## Próximos pasos

- [Pasar de Campañas a Difusiones y Agentes](../moving-from-campaigns.md) - donde reside ahora toda la configuración de las antiguas campañas.
- [Sistema de seguimiento](../ai-automation/follow-ups.md) - vuelve a interactuar con clientes potenciales del embudo que se quedan en silencio.
- [Difusiones](../broadcasts/broadcasts.md) - la guía completa para configurar el lado del envío.
- [Referencia de la API de contactos](../api/contacts.md) - todos los campos que acepta el endpoint de creación de contactos.
