Your AI Connector Docs

Conecta tu propia aplicación de Meta

Ejecuta WhatsApp a través de tu propia aplicación de Meta y paga a Meta directamente según sus propias tarifas. Your AI Connector no añade tarifas por mensaje en esta conexión y no hay ninguna cuenta de Twilio de por medio. Debido a que la cuenta de WhatsApp es tuya, tus clientes solo verán el nombre de tu empresa.

Esta es la opción más técnica de las conexiones de WhatsApp: crearás una aplicación dentro del sitio para desarrolladores de Meta y copiarás cuatro valores en Your AI Connector. Reserva unos 20 minutos. Si esto te parece demasiado complicado, la conexión gestionada de WhatsApp Business sigue siendo la forma más sencilla de empezar.

Lo que necesitas

  • Acceso a tu cuenta de Meta Business Manager.
  • Un número de teléfono que no esté ya en uso en la aplicación de WhatsApp.
  • Unos 20 minutos.

Parte 1 — Configura tu aplicación en Meta

Realiza estos pasos primero en Meta. Recopilarás cuatro valores durante el proceso: un ID de la aplicación, un secreto de la aplicación, un token de acceso y un ID de la cuenta de WhatsApp.

1. Crea una aplicación

Ve a developers.facebook.com, abre Mis aplicaciones y pulsa Crear aplicación. Elige el tipo Negocio y asígnale cualquier nombre; el nombre solo es visible para ti.

2. Añade WhatsApp a la aplicación

En el panel de la aplicación, busca WhatsApp en la lista de productos y pulsa Configurar. Meta crea una cuenta de WhatsApp de prueba con un número de prueba gratuito para que puedas probar las cosas antes de conectar un número real.

3. Activa los permisos de WhatsApp

Este es el paso que la mayoría de las guías omiten, y omitirlo es la razón más común por la que la conexión falla más adelante.

En tu aplicación, abre Revisión de la aplicación y, a continuación, Permisos y funciones. Busca whatsapp_business_management. Si dice Sin acceso, pulsa Obtener acceso estándar: Meta te pedirá que vuelvas a introducir tu contraseña y te lo concederá al instante. No hay periodo de espera ni revisión de la aplicación; es un solo botón.

whatsapp_business_messaging normalmente ya tiene acceso estándar. Ambos permisos deben mostrar Acceso estándar antes del siguiente paso; de lo contrario, al token que generes le faltará uno de ellos.

4. Crear un usuario del sistema

En Meta Business Settings, abre Usuarios y luego Usuarios del sistema. Añade uno y dale acceso de administrador tanto a tu aplicación como a tu cuenta de WhatsApp.

5. Generar un token para ese usuario

Selecciona el usuario del sistema y pulsa Generar token. Elige tu aplicación, selecciona un token que nunca caduque y marca tanto whatsapp_business_messaging como whatsapp_business_management. Meta muestra el token una sola vez; cópialo de inmediato.

6. Encontrar tu ID de cuenta de WhatsApp

En Business Settings, abre Cuentas y luego Cuentas de WhatsApp, y selecciona tu cuenta. El número largo que aparece debajo de su nombre es el ID.

Tu App ID y App secret se encuentran en la Configuración de la aplicación (App settings), en Básico (Basic). Pulsa Mostrar (Show) junto al App secret para revelarlo.

Parte 2 — Conéctalo en Your AI Connector

Abra Settings, luego Channels, busque la tarjeta WhatsApp Business API y presione Connect WhatsApp. Elija Use a number you already have, luego Your own Meta app. El asistente se abrirá con una breve descripción general; presione Start setup.

  1. Tus detalles. Este paso repite los cinco pasos del lado de Meta de la Parte 1 junto a un formulario para tus cuatro valores. Pega el ID de la aplicación, el secreto de la aplicación, el token de acceso y el ID de la cuenta de WhatsApp exactamente como los muestra Meta, sin espacios adicionales, y pulsa Comprobar mis detalles. No se guarda nada hasta que funcionan; Your AI Connector los verifica primero con Meta.
  1. Elige el número a conectar. El asistente enumera todos los números de tu cuenta de WhatsApp, cada uno con la calificación de calidad propia de Meta. Elige el que este espacio de trabajo debe usar para enviar y recibir mensajes y pulsa Conectar este número (Connect this number).
  1. Activación y entrega. Your AI Connector activa el número para la API de la nube y registra su webhook con Meta automáticamente, de modo que los mensajes entrantes lleguen a su bandeja de entrada; en la mayoría de los casos, accederá directamente a la tarjeta de conexión con una confirmación de “Número conectado”. Si el paso automático no puede finalizar, el asistente mostrará la URL de devolución de llamada (callback URL) y el token de verificación con botones de copia y le guiará para que los añada usted mismo en Meta; los mismos valores permanecerán visibles en la tarjeta de conexión en caso de que Meta le pida que los vuelva a introducir.
  2. El asistente comprueba la conexión por sí mismo. En el último paso, verifica la configuración automáticamente, sin que usted tenga que esperar. Una vez que la tarjeta indique que está conectada, envíese un mensaje de WhatsApp desde otro teléfono y observe cómo llega a sus chats: las conversaciones en ese número fluirán ahora como en cualquier otro canal, y sus agentes de IA podrán responder en él. Si la comprobación detecta algo que Meta aún necesita (por ejemplo, la verificación del número), la tarjeta le indicará exactamente qué es, y Verificar conexión volverá a ejecutar la comprobación una vez que lo haya solucionado.

Puede volver a la misma página en cualquier momento para comprobar el estado de la conexión, Volver a conectar con nuevos detalles o pulsar Desconectar: su número, su cuenta de Meta y su facturación siguen siendo suyos.

Es bueno saberlo

  • La ventana de 24 horas se aplica, como en todas las conexiones de WhatsApp Business. Siempre puedes responder libremente a las personas que te enviaron un mensaje en las últimas 24 horas. Fuera de esa ventana, WhatsApp solo permite a las empresas iniciar conversaciones con una plantilla de mensaje aprobada; un mensaje de texto plano será aceptado por Meta, pero no se entregará.
  • Meta te factura directamente las conversaciones según sus tarifas publicadas por país, en el método de pago vinculado a tu cuenta de WhatsApp en Meta. Your AI Connector no cobra por mensaje en esta conexión; el uso de la IA se factura en créditos como de costumbre.
  • Mantén un método de pago válido en esa cuenta de WhatsApp. Sin él, Meta bloquea todas las conversaciones que inicia tu empresa (difusiones, campañas y cualquier mensaje de plantilla) y muestra el error en WhatsApp Manager. En esta conexión, una difusión o campaña se niega a lanzarse mientras sea así y te indica que añadas un método de pago en lugar de fallar mensaje a mensaje. Las respuestas a las personas que te escribieron primero siguen saliendo por ahora, pero a partir del 1 de octubre de 2026 Meta también cobrará por ellas, por lo que una cuenta sin un método de pago funcional quedará totalmente en silencio en esa fecha. El panorama completo está en Costes de WhatsApp y el cambio de octubre de 2026.
  • Tu estimación de costes se ve diferente aquí. Debido a que estas tarifas nunca afectan a tus créditos, la estimación en el paso de revisión de una difusión (y en el paso de lanzamiento de una campaña) muestra el recuento de contactos y el desglose por país con una nota de que Meta los factura a tu cuenta de WhatsApp Business, en lugar de un total de créditos.
  • Los números de prueba son gratuitos. El número de prueba que Meta da a cada nueva aplicación puede enviar mensajes a hasta cinco destinatarios verificados sin coste alguno: una forma práctica de probar la configuración completa antes de apuntar un número real a ella.

Plantillas

Las plantillas de mensajes funcionan en esta conexión y residen en su propia cuenta de WhatsApp Business. Cree una en la página Plantillas y se creará en esa cuenta y será revisada por Meta; el resultado aprobado, pendiente o rechazado se le mostrará aquí. Las plantillas que ya tiene en WhatsApp Manager aparecen en la lista automáticamente, y un botón Sincronizar desde Meta importa cualquier cambio que haya realizado allí recientemente. El envío funciona igual que en cualquier otra conexión de WhatsApp: elija una plantilla aprobada para iniciar una conversación o reabrir una fuera de la ventana de 24 horas. Los detalles se encuentran en Uso de plantillas con su propia cuenta de Meta WhatsApp.

Si algo no funciona

  • “No pudimos conectar con esos detalles” — vuelva a copiar cada valor; un espacio adicional suele ser la causa. El mensaje incluye la propia respuesta de Meta, que normalmente indica el valor que es incorrecto.
  • El error dice que falta el token whatsapp_business_management — a su aplicación aún no se le ha concedido ese permiso. Vuelva a la Parte 1, paso 3, pulse Obtener acceso estándar, genere un nuevo token con ambos permisos marcados y vuelva a comprobar sus datos. Regenerar el token sin ese paso seguirá produciendo el mismo error.
  • Su token desapareció — Meta solo muestra un token una vez. Genere uno nuevo desde el mismo usuario del sistema; el anterior seguirá funcionando hasta que lo revoque, pero solo el nuevo será visible.
  • Los mensajes que usted inicia no llegan — consulte la nota sobre la ventana de 24 horas más arriba: fuera de esa ventana, solo se entregan los mensajes de plantilla.
  • No llega nada en absoluto — es probable que el número aún no esté activado para la API de la nube. Un número solo puede estar en un lugar a la vez, así que si todavía está registrado en la aplicación WhatsApp Business en un teléfono, elimínelo primero allí y, a continuación, pulse Verificar conexión en la tarjeta de conexión. Your AI Connector lo activa por usted y le indica al instante si a Meta todavía le falta algo.
  • “Este número ya tiene un PIN de verificación en dos pasos” — el número se configuró en otro lugar anteriormente y mantuvo su PIN. Desactive la verificación en dos pasos para él en el Administrador de WhatsApp (WhatsApp Manager) y, a continuación, pulse Reconectar.
  • “Meta aún no ha verificado este número” — finalice la verificación del número en el Administrador de WhatsApp (Meta le enviará un código) y, a continuación, pulse Reconectar.
  • “Este número está alojado en la API local (On-Premises)” — se está ejecutando en el producto autohospedado más antiguo de WhatsApp, que no puede compartir un número con la API de la nube. Migre primero al Administrador de WhatsApp a la API de la nube.