Your AI Connector Docs

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

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):
    {
  "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.

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):
    {
  "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 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 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 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "jane@example.com"
}

Crear contacto - Respuesta 

{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}

Agregar contacto a la lista - Solicitud 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/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