Agente de IA en WhatsApp Business: qué se paga, qué es gratis y qué cambia entre la API oficial y la no oficial

Qué cambia entre la API oficial de WhatsApp y una no oficial#

La API oficial es la WhatsApp Business Platform, que Meta ofrece a las empresas: el número queda registrado en Meta, los mensajes llegan al sistema por webhook y cada envío sigue las reglas y los precios que Meta publica. Una API no oficial es una biblioteca que imita WhatsApp Web y entra en el número como un dispositivo vinculado, sin contrato con Meta.

Una de las más conocidas es Baileys, de código abierto. El propio proyecto advierte en su README que no tiene vínculo ni autorización de WhatsApp y desaconseja usarla para mensajes automáticos o masivos. La vinculación se hace con un código QR, como en WhatsApp Web, y el equipo de la empresa sigue usando la app en el teléfono.

Para quien va a poner IA en la atención, la diferencia no es solo técnica ni solo de precio. En la oficial, las reglas de Meta deciden lo que la atención puede hacer: cuándo la empresa puede escribir, con qué texto, desde qué número y con qué medios. En la no oficial, esas reglas desaparecen, y en su lugar queda el riesgo de que el número sea bloqueado. En la plataforma de atención por WhatsApp que operamos para clientes en Brasil, donde WhatsApp es el canal habitual de cualquier negocio, usamos los dos caminos y elegimos uno para cada cliente.

Qué reglas de Meta dan forma a la atención en la API oficial#

Tres reglas de Meta cambian el diseño de una atención con IA en la API oficial: un número está en una integración a la vez, el webhook se suscribe por cuenta y no por número, y fuera de la ventana de 24 horas solo sale una plantilla de mensaje aprobada. Una cuarta es de formato: la nota de voz solo existe en OGG con Opus. Cada una se volvió una decisión de diseño en la plataforma que operamos.

1. Un número, una integración. Para usar en la API un número que ya tiene WhatsApp, Meta pide borrar la cuenta de la app o entrar por un socio que ofrezca la coexistencia con la app WhatsApp Business. Si el número ya está en la API oficial con otro proveedor, el cambio depende de dónde esté registrado: cuando la cuenta de WhatsApp y el número están en el portafolio de Meta Business de la propia empresa, basta con cambiar la integración; cuando están en la cuenta del proveedor, la salida suele ser un número nuevo.
2. El webhook es de la cuenta, no del número. La aplicación se suscribe a los webhooks de una cuenta de WhatsApp Business, y Meta entrega a todas las aplicaciones suscritas los mensajes de todos los números de esa cuenta. Si el número hubiera entrado en la cuenta que usaba el proveedor anterior, su sistema habría recibido nuestras conversaciones y podría haber respondido encima. La salida prevista fue una cuenta separada, solo con nuestra aplicación, al costo de aprobar las plantillas de nuevo.
3. Fuera de la ventana, solo plantilla. La ventana de atención se abre por 24 horas con cada mensaje de la persona. La respuesta de la IA al lead ocurre dentro de ella. Lo que afecta la regla es lo que inicia la empresa: el seguimiento de quien dejó de responder y el aviso al vendedor de que llegó un lead, porque es el número de la atención escribiendo al número del vendedor, y nadie abrió esa ventana. Los dos pasaron a salir por plantilla aprobada, y la bandeja de entrada cambia el campo de texto por el selector de plantillas cuando la ventana se cierra. Cómo entra esta regla en la planificación de los avisos de cualquier sistema está en el mapa de notificaciones.
4. Voz en OGG con Opus. Meta solo trata como nota de voz el archivo OGG con el códec Opus, marcado como voz. El navegador graba en otro formato, así que el sistema convierte el audio grabado en el panel antes de enviarlo. Antes de esa conversión, el audio enviado desde el panel no se reproducía en el iPhone.

Por qué una plantilla de mensaje aprobada todavía puede ser bloqueada#

Porque la aprobación dice que el texto puede usarse, no que el mensaje será entregado. Meta asigna una categoría a cada plantilla y limita cuántas plantillas de marketing recibe una persona, de todas las empresas, en un período. Cuando el mensaje cae en ese límite, vuelve con el error 131049, que Meta describe como mensaje no entregado para mantener un engagement saludable del ecosistema.

Eso pasó con el aviso de nuevo lead en uno de los números que operamos en la API oficial. En un mismo día de octubre de 2026, Meta bloqueó dos veces el aviso para los dos números del equipo del cliente, con la plantilla ya aprobada. Horas antes, con la plantilla todavía en revisión, el error era otro, el 131047, de mensaje fuera de la ventana. El aviso se estaba cobrando como marketing, a cerca de R$ 0,34 cada uno (unos US$ 0,06), y caía en el límite de marketing.

La salida no fue reescribir la plantilla, sino usar la ventana de 24 horas. Cada persona del equipo manda un "hola" al número de la atención, lo que abre su ventana, y responde a los avisos que recibe, lo que la mantiene abierta. Mientras está abierta, el aviso sale como texto común. El agente reconoce los números del equipo y no los atiende como leads, y la pantalla del equipo muestra, persona por persona, si los avisos están llegando.

Según la documentación de Meta, los mensajes de marketing enviados con la ventana abierta no cuentan para el límite, y quien recibe el 131049 debe esperar al menos 24 horas antes de reenviar.

¿La API oficial es solo la opción más cara?#

No. Desde julio de 2025, Meta cobra por mensaje entregado, con precio por categoría y por país del destinatario, y parte de lo que envía una atención con IA no paga nada: cada número tiene 1.000 respuestas de atención gratis al mes, y quien llega desde un anuncio de clic a WhatsApp abre una ventana de hasta 7 días sin cobro. Lo que pesa en la cuenta es el mensaje que inicia la empresa.

El precio volvió a cambiar el 1 de octubre de 2026. Las respuestas libres dentro de la ventana, que Meta llama mensajes de servicio y que incluyen las escritas por una IA de terceros, se vuelven a cobrar a partir de la 1.001 del mes en cada número. Las plantillas de utilidad enviadas dentro de la ventana también pasaron a cobrarse. Para Brasil, Meta usa como referencia 0,68 centavos de dólar por mensaje de utilidad y de autenticación.

En uno de los números que operamos en la API oficial, las 1.000 respuestas gratis de octubre ya se habían agotado el día 22, y cada respuesta de la IA pasó a costar cerca de R$ 0,04 de Meta, menos de un centavo de dólar. Una plantilla cobrada como marketing salió a cerca de R$ 0,34. La cuenta de Meta es del cliente, pagada con la tarjeta registrada en su propia cuenta, y va separada del costo de la IA, que es por token y está en cuánto cuesta poner IA a trabajar dentro del sistema. Desde julio de 2026, Meta también vende su propio agente de IA en WhatsApp, cobrado por token, que según la propia Meta sale a 4 o 5 centavos de dólar por mensaje.

Lo que la oficial cobra además del dinero es diseño. El seguimiento se vuelve una plantilla paga, el aviso al equipo necesita la ventana abierta y toda conversación que inicia la empresa exige que la persona haya aceptado recibir mensajes, como manda la política de WhatsApp.

¿Una API no oficial de WhatsApp es gratis?#

No le paga a Meta, pero no es gratis. La no oficial usa WhatsApp de una manera que sus términos del servicio prohíben: acceso por medios automatizados no autorizados y mensajes automáticos o masivos. El costo aparece cuando el número es bloqueado, y quien ya usaba el servicio fuera de los términos no tiene base para apelar alegando un uso legítimo.

Los términos de WhatsApp prohíben los mensajes masivos, los automáticos y el marcado automático, y prevén desactivar o suspender la cuenta. En la API oficial, Meta documenta un camino gradual: aviso, restricciones de envío de duración creciente, bloqueo de la cuenta y, al final, la desactivación, con una apelación que suele responderse en 24 a 48 horas. En el alcance de nuestra plataforma, el bloqueo en la no oficial se trata como permanente y sin recurso.

Por eso, los clientes que se quedan en la no oficial tienen protecciones que existen solo para cuidar el número:

• un número dedicado a la atención, y no la línea principal de la empresa, con el chip nuevo calentado con conversación real antes de recibir tráfico y nunca un número VoIP;
• responder solo a quien escribió, sin envíos masivos, campañas ni listas de difusión;
• un contenedor por cliente, para que el bloqueo de un número no tumbe a los demás;
• detenerse cuando WhatsApp rechaza la sesión, avisando a la guardia en lugar de intentar reconectar;
• un acuse de conocimiento del riesgo, firmado por el cliente antes de activar.

La protección de detenerse nació de un ensayo. Con la sesión muerta, el agente recargaba la misma credencial y golpeaba a WhatsApp cada 5 segundos, sin fin, un comportamiento que lleva al bloqueo y que ninguna alerta mostraba. Hoy se detiene y avisa. La sesión también se cae sola: en uno de los números en la no oficial hubo cuatro caídas en un mismo día de septiembre.

Oficial o no oficial: la comparación, criterio por criterio#

La tabla compara los dos caminos en lo que cambia para una atención con IA: el número, cuándo puede escribir la empresa, el costo, el riesgo y lo que llega con cada conversación. Reúne la documentación de Meta, los términos de WhatsApp y lo que vemos en la plataforma de atención que operamos con los dos transportes.

Leída fila por fila, la tabla muestra un intercambio: la oficial pone reglas y precio donde la no oficial pone riesgo. Cuando revisamos el alcance de nuestra plataforma, el campo de origen del contacto quedó sin fuente en los números de la no oficial, porque el referral del anuncio es un recurso de la API oficial.

¿La regla de Meta contra los chatbots de IA afecta la atención de una empresa?#

En el caso común, no. Desde el 15 de enero de 2026, los términos de la plataforma prohíben a los proveedores de IA, como quien ofrece un asistente de uso general, cuando la IA es la función principal que se ofrece, "y no incidental o accesoria". Un agente que responde en nombre de una empresa sobre su propio negocio es uso accesorio. Según los términos, quien decide cómo se clasifica cada caso es Meta.

En Brasil hay una excepción para los propios proveedores de IA: Meta dice que está obligada por ley a permitir que usen la plataforma allí, y desde el 11 de marzo de 2026 les cobra cada mensaje de servicio entregado a usuarios brasileños. Ese cobro es específico de esos proveedores y no cambia los precios de las demás empresas.

Para el agente de atención de una empresa, la regla que pesa es la política de mensajes de WhatsApp: con automatización, la empresa debe ofrecer un camino rápido y claro para hablar con una persona. En los agentes que operamos, pedir una persona pasa la conversación al equipo. Y en un asistente de finanzas familiares en WhatsApp cuyo alcance estamos definiendo, el documento dice que el asistente solo habla de las finanzas de la familia y rechaza con amabilidad otros temas, para no convertirse en un asistente de uso general.

Cómo elegimos el transporte de cada cliente#

Elegimos según lo que la atención necesita hacer. Si la empresa va a iniciar conversaciones, con seguimiento, avisos o reactivación, si quiere saber qué anuncio trajo cada lead o si el número ya está en una integración oficial, va a la oficial. Si la atención solo responde a quien escribe y el equipo quiere seguir en la app del teléfono, la no oficial cabe, con número dedicado y el riesgo firmado.

Para que la elección sea por cliente, el transporte se volvió una pieza intercambiable del sistema: el mismo agente, la misma bandeja de entrada y el mismo embudo funcionan en los dos caminos, y solo cambia la capa que habla con WhatsApp. El lado oficial se validó antes de que existiera una cuenta en Meta, con 270 pruebas del agente corriendo contra una Meta falsa, que cubren la entrada, el envío, el audio convertido, las plantillas y el aviso al equipo con plan B. Es la misma lógica de cualquier integración con un sistema de terceros: el límite de quien está del otro lado se vuelve el límite de tu producto, como con el ERP que decide parte de tu sistema.

Las cuentas quedan a nombre del cliente: el portafolio de Meta Business, la cuenta de WhatsApp, el número, las plantillas y la tarjeta que le paga a Meta. Eso es lo que permitió que un cliente cambiara de proveedor sin cambiar de número.

No toda empresa necesita una integración directa con Meta. En Helpe, un marketplace brasileño de servicios locales, el código de verificación por WhatsApp que estamos incorporando sale por un socio oficial de Meta, cobrado por mensaje, con SMS automático si WhatsApp falla. Y un proyecto que necesita iniciar conversaciones desde el primer día nace en la oficial, como el asistente de finanzas que estamos definiendo, que envía recordatorios de vencimiento fuera de la ventana.

Preguntas frecuentes#

¿Está permitida una API no oficial de WhatsApp?#

No según los términos de WhatsApp. Prohíben acceder al servicio por medios automatizados no autorizados y enviar mensajes automáticos o masivos, y prevén suspender o desactivar la cuenta. La propia Baileys, una de las bibliotecas más conocidas, advierte que no tiene vínculo ni autorización de WhatsApp. Quien la usa asume el riesgo de perder el número.

¿Puedo usar en la API oficial el número que ya uso en la app de WhatsApp?#

Sí, de dos maneras. La primera es borrar la cuenta de la app y registrar el número en la API, perdiendo el historial del teléfono. La segunda es entrar por un socio de Meta que ofrezca la coexistencia, en la que el número sigue en la app WhatsApp Business y en la API al mismo tiempo, con límites: los grupos no se sincronizan, las listas de difusión y la visualización única se desactivan y el caudal queda en 20 mensajes por segundo.

¿Cuánto cuesta la API oficial de WhatsApp por mensaje?#

Desde julio de 2025, Meta cobra por mensaje entregado, con precio por categoría y por país del destinatario. Cada número tiene 1.000 respuestas de atención gratis al mes, y quien llega desde un anuncio de clic a WhatsApp abre hasta 7 días sin cobro. En un número brasileño que operamos, en octubre de 2026, la respuesta después de las 1.000 gratis costó cerca de R$ 0,04 y una plantilla cobrada como marketing, cerca de R$ 0,34.

¿Meta prohibió los chatbots de IA en WhatsApp?#

Prohibió a los proveedores de IA cuyo producto principal es el asistente, como un chatbot de uso general, desde el 15 de enero de 2026. La regla vale cuando la IA es la función principal, y no incidental o accesoria. Un agente que responde en nombre de una empresa sobre su propio negocio es uso accesorio. La política de mensajes exige, cuando hay automatización, un camino claro para hablar con una persona.

¿Por qué WhatsApp bloqueó mi plantilla de mensaje ya aprobada?#

Porque la aprobación habilita el texto, pero no garantiza la entrega. El error 131049 aparece cuando Meta retiene el mensaje para no saturar a la persona, sobre todo por el límite de plantillas de marketing que cada usuario recibe de todas las empresas. Meta recomienda esperar 24 horas antes de reenviar. Para avisos internos, la salida que usamos es que cada persona del equipo abra la ventana de 24 horas con un mensaje.

Fuentes#

• Meta, precios de la WhatsApp Business Platform, consultados el 23 de octubre de 2026 (cobro por mensaje desde el 1 de julio de 2025; 1.000 mensajes de servicio gratis al mes por número y utilidad dentro de la ventana cobrada desde el 1 de octubre de 2026; ventana gratis de hasta 7 días desde anuncios de clic a WhatsApp; 0,68 centavos de dólar por utilidad y autenticación en Brasil; el agente de IA de Meta a US$ 2 por millón de tokens): https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
• Meta, envío de mensajes (la ventana de atención de 24 horas, que se abre y se reinicia con cada mensaje de la persona): https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages
• Meta, límite de plantillas de marketing por usuario (el 131049, la espera de 24 horas y los mensajes con la ventana abierta fuera del límite): https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits
• Meta, códigos de error (131049, "not delivered to maintain healthy ecosystem engagement"; 131047, más de 24 horas desde la última respuesta): https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/
• Meta, categorización de plantillas (marketing, utilidad y autenticación; el contenido mixto cuenta como marketing): https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization
• Meta, mensajes de audio (nota de voz solo en OGG con Opus, con voice: true): https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/audio-messages
• Meta, webhook de mensajes de texto (el objeto referral de los mensajes que llegan desde anuncios de clic a WhatsApp): https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/text
• Meta, webhooks para proveedores de soluciones (la aplicación se suscribe a cada cuenta de WhatsApp Business): https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks
• Meta, usar un número que ya tiene WhatsApp (borrar la cuenta o entrar por un socio con coexistencia): https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/migrate-existing-whatsapp-number-to-a-business-account
• Meta, coexistencia con la app WhatsApp Business (20 mensajes por segundo; grupos, visualización única y listas de difusión fuera): https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users
• Meta, aplicación de políticas (aviso, restricciones graduales, bloqueo, desactivación y apelaciones respondidas en 24 a 48 horas): https://developers.facebook.com/documentation/business-messaging/whatsapp/policy-enforcement
• Meta, precios para proveedores de IA (términos del 15 de enero de 2026; cobro en Brasil desde el 11 de marzo de 2026): https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ai-providers
• Meta, términos de la WhatsApp Business Platform, sección 4.7 (proveedores de IA prohibidos cuando la IA es la función principal, "rather than incidental or ancillary"): https://www.facebook.com/legal/Meta-Terms-for-WhatsApp-Business-Platform
• WhatsApp, política de mensajes para empresas (consentimiento antes de escribir; un camino claro hacia una persona cuando hay automatización): https://whatsappbusiness.com/policy/
• WhatsApp, términos del servicio (prohibición de mensajes masivos y automáticos y de acceso por medios automatizados; suspensión y desactivación de la cuenta): https://www.whatsapp.com/legal/terms-of-service
• Baileys, README en GitHub ("not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp"): https://github.com/WhiskeySockets/Baileys

Próximo paso#

Si vas a poner un agente de IA en WhatsApp y necesitas definir el camino antes de elegir proveedor, ese es el trabajo que hacemos en IA y automatización: el transporte elegido según lo que la atención necesita hacer, las cuentas a nombre de tu empresa y las reglas de Meta dentro del diseño desde el principio.