Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

API de WhatsApp para agentes de IA: acceso oficial en minutos, sin convertirte en Tech Provider

Un agente de IA obtiene acceso oficial a WhatsApp a través de la Cloud API de Meta, y un número que sigue en la app de WhatsApp Business se incorpora a ella mediante un Tech Provider o un Solution Partner. Puedes convertirte en uno, lo que implica la verificación del negocio, los videos de App Review y una implementación de Embedded Signup, o conectarte a través de un proveedor que ya lo sea: el número se incorpora en minutos y el agente recibe herramientas MCP o credenciales de API.

easyCoexistence es un Tech Provider independiente de Meta: conecta un número de WhatsApp Business a la Cloud API mediante Coexistencia en minutos, para que tu agente tenga acceso oficial mientras el negocio conserva la app.

Tech Provider

Lo que Meta exige a quien incorpora un número que sigue en la app de WhatsApp Business: la condición de Tech Provider o de Solution Partner.

2 videos

App Review pide un video de un mensaje enviado desde tu app y otro de tu app creando una plantilla.

Advanced access

Lo que App Review otorga a whatsapp_business_messaging y whatsapp_business_management, ambos necesarios para ser Tech Provider.

October 15, 2026

Cuándo Meta declaró obsoletos Embedded Signup v2 y v3 e indicó a las integraciones que migraran a v4.

20 msg/s

Throughput fijo de un número que se usa a la vez con la app de WhatsApp Business y con la Cloud API.

1 hour

Cuánto tiempo sigue válido un enlace de conexión alojado cuando una plataforma incorpora el número de un cliente mediante la Partner API.

¿Qué necesita un agente de IA para usar WhatsApp de forma oficial?

Cuatro cosas de la Cloud API de Meta. Un phone number ID y un token de acceso con el permiso whatsapp_business_messaging, para que el agente pueda llamar al endpoint messages. Un endpoint de webhook donde Meta entrega los mensajes entrantes y, en un número compartido con la app, smb_message_echoes para las respuestas que una persona escribe en el teléfono. Plantillas aprobadas, porque un mensaje de formato libre solo llega a quien te escribió en las últimas 24 horas. Y una forma de saber cuándo se cae la conexión, ya que la app del teléfono sigue funcionando aunque la parte de la API deje de hacerlo.

El atajo que la gente encuentra primero es automatizar WhatsApp Web, que inicia sesión como dispositivo vinculado. Eso incumple los términos de WhatsApp y expone el número a un bloqueo, haga lo que haga el agente que funcione sobre él.

¿Qué implica la vía de Tech Provider?

La secuencia que marca Meta, en este orden. Cada paso es gratuito y ninguno se puede acelerar pagando: las revisiones siguen el calendario de Meta, que no publica plazos, así que cuenta con semanas, no días, antes de que se conecte el número del primer cliente. Después hay que mantener el backend en marcha: el intercambio de token tras cada registro, un receptor de webhooks, el enrutamiento por número y el monitoreo de desconexiones, como la regla de 14 días de inactividad de Meta.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

¿Cuál es la vía más corta?

Conectar el número a través de un proveedor que ya pasó por ese proceso. Con easyCoexistence, el negocio completa el Embedded Signup de Meta y escanea un código con la app de WhatsApp Business, lo que lleva unos dos minutos, y el número se incorpora a la Cloud API en el propio Portafolio Comercial del negocio mientras la app sigue funcionando. Después, el agente obtiene acceso en el formato que maneje: herramientas MCP para un asistente como ChatGPT, Claude, Claude Code o Codex, o las credenciales y los webhooks del número para el código que ejecutes tú.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

¿Cómo obtiene el agente las credenciales del número?

Con get_api_credentials o desde la página del número en el panel. La herramienta devuelve la URL base de la Graph API, el ID de la WhatsApp Business Account, el phone number ID, el endpoint de envío y, si existe, el token de acceso propio del negocio, limitado a sus activos de WhatsApp. Si no se emitió ningún token de cliente, el token vuelve como null con una nota que indica que reconectar el número desde el panel emite uno, sin reemplazar un token que ya funcione. No hay ningún app secret que obtener, porque Meta firma los webhooks con el app secret de easyCoexistence, que nunca se comparte. La herramienta requiere un plan activo, ya que el token permite enviar mensajes.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

¿Cómo le llegan los mensajes entrantes al agente?

Cada número tiene dos modos, que se cambian con set_inbound_mode o en la página del número. Directo a tu servidor: set_webhook_destination hace que Meta entregue directamente a tu endpoint HTTPS, que debe responder al handshake GET de Meta, y easyCoexistence nunca ve los mensajes, así que las automatizaciones quedan desactivadas. Como Meta firma esas entregas con nuestro app secret, pon un secreto aleatorio largo en la ruta de la URL y rechaza las peticiones que no lo incluyan.

Automatizaciones activadas: Meta entrega a easyCoexistence, las automatizaciones pueden responder y una URL de reenvío opcional recibe el payload original de Meta bajo "value", firmado con X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 de "<t>.<body>"> con un secreto que se muestra una sola vez. Además, el paso Llamar a mi webhook de una automatización pasa a tu agente el mensaje y los últimos 10 mensajes del chat, y envía la respuesta si tu servidor contesta {"reply": "..."} en menos de 20 segundos.

¿Qué límites debe respetar el agente?

Los de Meta, que son los mismos con cualquier proveedor. Un agente que los conoce de antemano evita fallos que parecen bugs:

  • 20 mensajes por segundo por número, fijados por Meta para los números compartidos con la app de WhatsApp Business.
  • Mensajes de formato libre solo dentro de las 24 horas siguientes al último mensaje del cliente; después, una plantilla aprobada.
  • Las plantillas se envían solo por la API, porque la app no puede enviarlas en un número con Coexistencia.
  • Las respuestas que una persona escribe en la app llegan como smb_message_echoes; pausa el agente en ese chat o el cliente recibirá dos respuestas.
  • Los chats de grupo no se sincronizan con la API, así que el agente trabaja en chats individuales.
  • Los contactos y hasta 6 meses de chats individuales se importan una sola vez, y solo si se guarda un destino de webhook directo en las 24 horas siguientes a la conexión; un número con automatizaciones activadas no recibe la importación.
  • Las llamadas de voz y video siguen funcionando en la app, pero la Cloud API no gestiona llamadas en un número con Coexistencia, así que el agente trabaja por texto.

¿Puede una plataforma conectar así los números de sus propios clientes?

Sí, con la Partner API, que es como un SaaS o una agencia incorpora a sus clientes sin ser Tech Provider. Crea la clave con create_api_key (empieza por ec_live_ y se muestra una sola vez) y luego llama a POST /api/v1/connect-sessions desde tu backend, o a create_connect_link desde el asistente, para obtener un enlace alojado válido durante 1 hora. Allí el cliente completa la ventana emergente de Meta y el escaneo del QR, y vuelve a tu redirect_url con un connection_id. Después, GET /api/v1/connections/:id?credentials=1 devuelve el token propio del cliente, y los eventos de estado, como connection.disconnected, llegan firmados con X-EC-Signature. Cada número se factura a tu cuenta con los mismos tramos por número.

Errores comunes

  • Validar X-Hub-Signature-256 en un destino directo. Meta firma con el app secret de easyCoexistence, que nunca se comparte, así que las entregas legítimas no superan la verificación; confía en un secreto aleatorio largo en la URL o usa el reenvío con X-EC-Signature.
  • Recibir con el nodo WhatsApp Trigger de n8n. Ese nodo espera tu propia app de Meta; usa en su lugar el nodo genérico Webhook con un secreto en su URL.
  • Ignorar smb_message_echoes. El agente responde aunque una persona ya haya contestado desde el teléfono, y el cliente lee dos respuestas.
  • Guardar el destino de webhook directo días después de conectar, o dejar el número con las automatizaciones activadas. La importación única de Meta de contactos y de hasta 6 meses de chats requiere un destino directo guardado en las 24 horas siguientes a la conexión.
Hacerlo con EasyCoexistence

El agente trabaja con más de 30 herramientas MCP o con las credenciales y los webhooks de cada número, y cada número se monitorea 24/7 con alertas. De US$ 9 a US$ 0.75 por número al mes, y el precio baja a medida que sumas números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Necesito mi propia app de Meta?

No. El número se incorpora a través de la app de Meta de easyCoexistence y permanece en el Portafolio Comercial y en la WhatsApp Business Account del propio negocio. Tu código envía con el token propio del negocio que obtienes con get_api_credentials, así que no interviene ninguna app tuya, a menos que más adelante crees una.

¿Pueden el agente y el equipo usar el número al mismo tiempo?

Sí. Meta replica los mensajes entre la Cloud API y la app de WhatsApp Business, así que lo que envía el agente aparece en el chat de la app en el teléfono, y lo que el equipo escribe en la app llega a tu sistema como smb_message_echoes.

¿Con qué frameworks de agentes funciona?

Con cualquier cliente que hable MCP sobre HTTP con OAuth, como ChatGPT, Claude, Claude Code, Codex y Cursor, y con cualquier código que llame a la Graph API de Meta: Node.js, Python, n8n, LangChain, el OpenAI Agents SDK o el Vercel AI SDK. La API de fondo es la propia de Meta, así que dentro del agente no hay nada propietario.

¿Se permiten los asistentes de IA de uso general en WhatsApp?

Desde el 15 de enero de 2026, la sección 4.7 de los Business Solution Terms de Meta prohíbe a los proveedores de asistentes de IA de uso general ofrecerlos en la WhatsApp Business Platform cuando la IA es la funcionalidad principal, según determine Meta. La norma no apunta a un negocio que usa IA con sus propios clientes, para soporte, ventas o reservas, y los reguladores de la UE y de Brasil han ordenado a Meta suspender o revertir la norma para los asistentes rivales.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el