# Formularios de clientes potenciales de Facebook ¿Publicas anuncios en Facebook para captar clientes potenciales? Esta integración envía automáticamente esos clientes potenciales a Your AI Connector para que puedas hacerles seguimiento a través de WhatsApp, SMS o cualquier otro canal conectado, sin mover un dedo. Funciona conectando Facebook Lead Ads a Your AI Connector a través de una plataforma de automatización (como Pabbly, Zapier o Make). Estas plataformas actúan como un puente entre Facebook y Your AI Connector, transfiriendo la información del cliente potencial de una a otra mediante la API (una forma en que diferentes programas intercambian datos automáticamente). --- ## Requisitos previos Antes de comenzar, asegúrate de tener: - Acceso a **Facebook Ads Manager** con permiso para crear Lead Ads. - **Una cuenta** con una clave API activa (genera una en **Configuración → Integraciones → Clave API**; consulta [Acceso a la API](api-access.md) para ver los pasos exactos). - **Una cuenta en una plataforma de automatización**: Pabbly Connect, Zapier o Make (Integromat). Esta guía utiliza Pabbly como ejemplo, pero los pasos son similares en cualquier plataforma. - **Una lista de contactos** en Your AI Connector donde se añadirán los nuevos clientes potenciales; consulta [Organización de listas y contactos](../get-started/list-and-contact-management.md). --- ## Información general La integración funciona en tres etapas: 1. Un posible cliente completa tu formulario de Facebook Lead Form. 2. Tu plataforma de automatización detecta el nuevo cliente potencial y envía la información a Your AI Connector automáticamente (usando dos llamadas a la API). 3. Your AI Connector crea el contacto y lo añade a la lista que especifiques. A partir de ahí, una difusión, una campaña o un agente de IA que hayas asignado se encarga del resto, ya sea un mensaje de bienvenida con IA, una secuencia de goteo o un seguimiento manual. --- ## Paso 1: Crea tu formulario de clientes potenciales de Facebook 1. Abre el **Administrador de anuncios de Facebook**. 2. Crea una nueva campaña con el objetivo de **Clientes potenciales**. 3. En el nivel de anuncio, elige **Formulario instantáneo** como método de captación. 4. Crea tu formulario con los campos que necesites. Como mínimo, incluye: - **Nombre** - **Número de teléfono** (con código de país) - Opcional: Apellido, correo electrónico 5. Publica el anuncio o guarda el formulario como borrador para realizar pruebas. --- ## Paso 2: Prueba el formulario de clientes potenciales Antes de conectar la automatización, envía un cliente potencial de prueba: 1. En el Administrador de anuncios, ve a tu formulario de clientes potenciales. 2. Haz clic en **Vista previa** y completa el formulario con datos de prueba. 3. Confirma que el cliente potencial de prueba aparezca en tu **Centro de clientes potenciales de Facebook** (en Herramientas de publicación en tu página de Facebook, o en el Administrador de anuncios en "Clientes potenciales"). Esta entrada de prueba se utilizará para configurar el mapeo de campos en tu plataforma de automatización. --- ## Paso 3: Configura la automatización ### Conectar Facebook Lead Ads como activador 1. Inicia sesión en tu plataforma de automatización (Pabbly, Zapier o Make). 2. Crea un nuevo flujo de trabajo / escenario / zap. 3. Configura el **activador** (trigger) en "Facebook Lead Ads - New Lead". 4. Conecta tu cuenta de Facebook y selecciona la página y el formulario de clientes potenciales. 5. Obtén el cliente potencial de prueba para confirmar que la conexión funciona y asignar los campos. ### Configurar llamada a la API 1: Crear contacto Añade un paso de acción con una solicitud HTTP / Webhook / API: - **Método:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY` - **Encabezados:** ``` Content-Type: application/json ``` - **Cuerpo (JSON):** ```json { "firstName": "{{first_name}}", "lastName": "{{last_name}}", "phone": "{{phone_number}}", "email": "{{email}}" } ``` Reemplaza `{{placeholders}}` con las asignaciones de campo reales de tu paso de activación. ::: warning **Importante:** El número de teléfono debe incluir el código de país (por ejemplo, `+1` para EE. UU. o `+31` para los Países Bajos). Si su formulario de clientes potenciales recopila el número de teléfono sin un código de país, añada un paso de formato en su automatización para anteponerlo. ::: La respuesta de la API devuelve el ID del nuevo contacto en `data.contactId`. Guarde ese valor; lo necesitará para el siguiente paso. > **Puede omitir la segunda llamada.** `POST /v1/contacts` también acepta `listId` (una lista) o `listIds` (varias) en el cuerpo de creación, lo que añade el nuevo contacto a esas listas en la misma solicitud. Utilice la versión de dos pasos que aparece a continuación solo si su plataforma de automatización necesita que el contacto exista antes de decidir qué lista utilizar. ### Configurar llamada a la API 2: Añadir contacto a la lista Añade un segundo paso de acción: - **Método:** `POST` - **URL:** `https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY` - **Encabezados:** ``` Content-Type: application/json ``` - **Cuerpo (JSON):** ```json { "contactId": "{{contact_id_from_previous_step}}", "listId": "YOUR_LIST_ID" } ``` Reemplace `YOUR_LIST_ID` con el ID real de su lista de contactos (consulte [Cómo encontrar el ID de su lista](#finding-your-list-id) a continuación) y asigne `contactId` al `data.contactId` devuelto por la primera llamada a la API. --- ## Cómo encontrar el ID de tu lista 1. En Your AI Connector, haz clic en **Contactos** y luego en la pestaña **Listas**. 2. Abre el menú de la fila ("⋯") junto a la lista que desees y haz clic en **Copiar ID de lista**. Consulta [Organización de listas y contactos](../get-started/list-and-contact-management.md) para ver el recorrido completo de la página de Listas. --- ## Paso 4: Probar el flujo de trabajo completo 1. Envía otra prueba de cliente potencial a través de tu formulario de Facebook (o vuelve a ejecutar la prueba existente en tu plataforma de automatización). 2. Comprueba en Your AI Connector lo siguiente: - El **contacto** se creó con el nombre, número de teléfono y correo electrónico correctos. - El contacto se **añadió a la lista correcta**. 3. Si tienes una difusión, campaña o agente de IA configurado para enviar mensajes a esa lista automáticamente, confirma que se active como esperabas. --- ## Referencia de datos A continuación, se muestran ejemplos de los datos enviados y recibidos durante la integración. ### Crear contacto - Solicitud ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Crear contacto - Respuesta ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Agregar contacto a la lista - Solicitud ```json POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY { "contactId": "abc123xyz", "listId": "LIST_ID" } ``` --- ## Consejos - **Gestión de duplicados:** si ya existe un contacto con el mismo número de teléfono, la llamada de creación devuelve `{"success": false, "error_code": 409}` y no devuelve el contacto existente. Cree una bifurcación en `error_code` (el estado HTTP es 200) y busque el contacto con `GET /v1/contacts?phoneNumber=...` antes de realizar la llamada para añadirlo a la lista. - **Múltiples formularios:** cree flujos de trabajo de automatización independientes para diferentes formularios de clientes potenciales, cada uno dirigido a una lista diferente y a una difusión, campaña o agente de IA distinto. - **Notificaciones de error:** configure su plataforma de automatización para que le notifique si una llamada a la API falla, de modo que no pierda clientes potenciales. --- ## Próximos pasos - [Migración de campañas a difusiones y agentes](../moving-from-campaigns.md) — configure algo para enviar mensajes automáticamente a nuevos clientes potenciales. - [Acceso a la API](api-access.md) — documentación completa de la API para integraciones avanzadas. - [Webhooks](webhooks.md) — reciba notificaciones cuando se creen o etiqueten contactos.