API de WhatsApp: 40 preguntas y respuestas

Actualizado el 28/10/2026

Esta página reúne las 40 preguntas más comunes sobre la API oficial de WhatsApp, con respuestas breves y directas, agrupadas por tema: acceso, precio, plantillas, límites, coexistencia, parte técnica y cuentas. Cada respuesta se entiende por sí sola y enlaza al artículo que profundiza el tema. Los valores y las reglas se verificaron en la documentación oficial de Meta el 28/10/2026.

Acceso

1. ¿Qué es la API oficial de WhatsApp?

Es la WhatsApp Business Platform de Meta, que hoy se usa a través de la Cloud API: una API HTTP alojada por Meta que permite enviar y recibir mensajes desde tu sistema, con eventos entregados por webhook. Es el único camino que Meta autoriza para automatizar el WhatsApp de una empresa. Lee WhatsApp Cloud API: qué es, cómo funciona y cuánto cuesta.

2. ¿La API de WhatsApp y la app WhatsApp Business son lo mismo?

No. La app WhatsApp Business es una aplicación gratuita de uso manual en el celular, sin endpoint ni webhook. La API (WhatsApp Business Platform, Cloud API) es para sistemas: integración con CRM, chatbots, notificaciones y varios agentes. Los nombres se explican en WhatsApp Business API, Business Platform y Cloud API.

3. ¿Cómo obtengo acceso a la API de WhatsApp?

Necesitas un portafolio comercial en Meta, un número registrado en la Cloud API, una cuenta de mensajes con método de pago y una app con permiso para usar esos activos. Puedes hacerlo directo en el panel de desarrolladores de Meta o con el registro insertado (Embedded Signup) de un proveedor. El paso a paso está en cómo obtener la API de WhatsApp.

4. ¿Puedo crear mi propia API de WhatsApp?

Sí, siempre que sea una capa de tu sistema sobre la Cloud API oficial: app en Meta, token de usuario del sistema, webhook y número registrado. Crear un canal propio con ingeniería inversa de la aplicación viola los Términos del Servicio. Detalles en ¿puedo crear mi propia API de WhatsApp?.

5. ¿Conviene contratar directo con Meta o con un proveedor?

Directo, no pagas por el acceso, pero mantienes app, tokens y webhook, y usas los canales de soporte de Meta para desarrolladores. El proveedor cobra por su capa y ofrece soporte, panel y, muchas veces, coexistencia. La comparación completa está en directo con Meta o con un proveedor.

6. ¿Usar una API no oficial (Baileys, WPPConnect) puede bloquear mi número?

Sí. Esas bibliotecas emulan WhatsApp Web, y los Términos del Servicio de WhatsApp prohíben el acceso automatizado no autorizado, así que los números pueden bloquearse sin aviso. Lee API oficial vs. API no oficial de WhatsApp.

Precio

7. ¿La API de WhatsApp es gratis?

El acceso es gratis; los mensajes, no. Meta cobra por mensaje entregado, según la categoría y el país del destinatario. Hay excepciones, como el cupo mensual de mensajes de servicio y la ventana de punto de entrada gratuito de los anuncios. Lee ¿existe una API de WhatsApp gratis?.

8. ¿Cómo cobra Meta los mensajes?

Por mensaje entregado, con un precio que depende de la categoría (marketing, utilidad, autenticación, servicio o Meta Business Agent) y del país del destinatario. Meta solo cambia precios el primer día de un trimestre: 1 de enero, abril, julio u octubre. Para estimar un envío, lee cuánto cuesta una campaña de WhatsApp.

9. ¿Cuánto cuesta un mensaje a Brasil?

Desde el 1/10/2026, para destinatarios en Brasil: marketing cuesta R$ 0,3217 (reales brasileños) y utilidad, autenticación y servicio cuestan R$ 0,0350 por mensaje. Son precios de lista de Meta, sin impuestos ni la tarifa de intermediarios. Otros mercados están en precio de la API de WhatsApp por país.

10. ¿Se cobran los mensajes de servicio?

Desde el 1/10/2026, cada número tiene un cupo gratuito de 1.000 mensajes de servicio entregados al mes; a partir del 1.001 se cobran. El cupo no se acumula de un mes a otro y no cubre plantillas de utilidad. Sin método de pago, Meta deja de entregar mensajes de servicio cuando se agota el cupo.

11. ¿Las plantillas de utilidad dentro de la ventana de atención son gratis?

Ya no. Desde el 1/10/2026, las plantillas de utilidad enviadas dentro de la ventana de atención se cobran. Siguen siendo gratis dentro de una ventana de punto de entrada gratuito. El cambio se explica en mensajes de utilidad en la ventana de atención.

12. ¿Qué es la ventana de punto de entrada gratuito?

Se abre cuando el cliente te escribe desde un anuncio de clic a WhatsApp (en Android o iOS) y respondes dentro de la ventana de atención. Puede quedar abierta hasta 7 días, y en ese período Meta no cobra mensajes de marketing, utilidad, autenticación ni servicio. Para medir esos anuncios, lee rastrear anuncios Click-to-WhatsApp.

13. ¿El precio cambia según el país del cliente?

Sí. El precio lo define el código de país del destinatario, no el país de la empresa. Un mensaje de marketing a un número de México tiene una tarifa distinta de uno a Colombia o a Brasil. Las tablas están en precio de la API de WhatsApp por país.

¿Quieres probar mientras lees? Crea tu cuenta en Vectalk y envía el primer mensaje por la API oficial. Crear cuenta gratis →

Plantillas

14. ¿Qué es una plantilla?

Es un modelo de mensaje aprobado por Meta, obligatorio para iniciar una conversación o escribirle al cliente fuera de la ventana de 24 horas. Tiene categoría, idioma, texto con variables y, de forma opcional, encabezado, pie y botones. Hay ejemplos listos en 60 modelos de plantillas de WhatsApp por sector.

15. ¿Cuáles son las categorías de plantilla?

Marketing, utilidad y autenticación. Utilidad cubre mensajes ligados a una transacción o cuenta del cliente; autenticación, códigos de verificación; lo demás es marketing. La categoría define el precio, y Meta puede reclasificar la plantilla. Lee categorías de plantillas de WhatsApp.

16. ¿Cuánto tarda Meta en aprobar una plantilla?

La revisión es automática y, según la documentación, puede tardar hasta 24 horas. Las plantillas editadas se revisan de nuevo. Para evitar idas y vueltas, revisa los motivos comunes de rechazo.

17. ¿Cuántas plantillas puedo tener?

Los portafolios no verificados pueden tener hasta 250 plantillas por cuenta de mensajes. Los verificados, con nombre visible aprobado en al menos un número, llegan a 6.000. También hay un límite de 100 plantillas creadas por hora en cada cuenta. Los términos clave están en el glosario de la API de WhatsApp.

18. ¿Puedo usar la API para cobrar deudas?

El cobro de deudas de terceros está prohibido por la Política de Mensajería Comercial. En cambio, el recordatorio de factura del propio cliente, como un pago por vencer, es un mensaje de utilidad. Lee cobranza por WhatsApp sin que te bloqueen.

19. ¿La Cloud API dejará de enviar marketing?

Sí. Meta anunció que la Cloud API deja de admitir mensajes de marketing el 13 de octubre de 2027, y las cuentas de mensajes creadas a partir del 13 de abril de 2027 ya no podrán enviar marketing por ella. El camino es la Marketing Messages API; utilidad, autenticación y servicio siguen en la Cloud API. Lee cómo migrar tus envíos de marketing.

Límites

20. ¿Qué es la ventana de 24 horas?

Es el período que se abre con cada mensaje del cliente. Dentro de él puedes responder con cualquier tipo de mensaje (texto, multimedia, botones). Fuera de él, solo plantillas aprobadas. Cada nuevo mensaje del cliente reinicia el plazo. Cómo se cobra dentro de la ventana está en mensajes de utilidad en la ventana de atención.

21. ¿Cuál es el límite de mensajes de la API?

Los portafolios nuevos empiezan con 250 destinatarios únicos cada 24 horas fuera de la ventana de atención. Los niveles siguientes son 2.000, 10.000, 100.000 e ilimitado. El límite es del portafolio y lo comparten todos sus números. La planificación está en Black Friday en WhatsApp.

22. ¿Cómo aumento el límite de mensajes?

Para llegar a 2.000, verifica la empresa o envía 2.000 mensajes entregados fuera de la ventana, a números únicos, en 30 días, con plantillas de buena calidad. Por encima de eso, el aumento es automático: hay que mantener la calidad y usar al menos la mitad del límite actual en los últimos 7 días. Lee calidad del número en la API de WhatsApp.

23. ¿Cuántos mensajes por segundo envía la API?

Hasta 80 mensajes por segundo por número de forma predeterminada, con ampliaciones de capacidad disponibles. Los números en coexistencia con la app quedan fijos en 20 mensajes por segundo. Superar ese ritmo genera el error 130429; enviar demasiado rápido al mismo destinatario genera el 131056. Consulta throughput y rate limit.

24. ¿Por qué no se entregó mi plantilla de marketing?

Una causa común es el límite de marketing por usuario: Meta limita cuántas plantillas de marketing recibe una misma persona de las empresas en un período, y el envío falla con el error 131049. La solución está en error 131049 y el límite de marketing.

25. ¿Pueden bloquear mi número en la API oficial?

Usar la API no provoca bloqueos, pero incumplir la política sí: denuncias, bloqueos de usuarios y envíos sin consentimiento bajan la calidad y pueden causar restricciones. La Política de Mensajería Comercial exige opt-in y respetar las bajas. Lee cómo armar una lista opt-in para WhatsApp.

Coexistencia

26. ¿Qué es la coexistencia?

Es usar el mismo número en la app WhatsApp Business y en la Cloud API a la vez: el equipo sigue en el celular y el sistema responde por la API. Meta documenta la incorporación por el registro insertado, a cargo de socios. Lee coexistencia de WhatsApp con un CRM.

27. ¿Qué deja de funcionar con la coexistencia?

Según Meta, los chats grupales no se sincronizan, las listas de difusión quedan en solo lectura, los mensajes temporales y de visualización única se desactivan en los chats individuales y los dispositivos vinculados se desconectan durante la incorporación. El detalle está en qué se sincroniza y qué no.

28. ¿Puedo usar en la API un número que ya está en WhatsApp?

Si el número está en la app WhatsApp Business, puedes conectarlo por coexistencia. Si está en WhatsApp común, debes eliminar la cuenta de la app antes de registrar el número en la Cloud API. Lee cómo liberar un número de WhatsApp para la API.

Parte técnica

29. ¿Cómo envío un mensaje por la API?

Con un POST a /{phone_number_id}/messages en la Graph API, con el token en el encabezado Authorization y un cuerpo JSON con messaging_product: "whatsapp", destinatario, tipo y contenido. Fuera de la ventana, el tipo debe ser template. Hay ejemplos en cURL, Node.js y Python en enviar mensajes con la API de WhatsApp.

30. ¿Cómo recibo los mensajes de los clientes?

Por webhook: registras una URL HTTPS, respondes al desafío de verificación y te suscribes a los campos de la cuenta (como messages). Meta envía un POST con JSON por cada mensaje recibido y cada cambio de estado. Lee estados de mensaje por webhook.

31. ¿Cómo sé que el webhook vino de Meta?

Validando el encabezado X-Hub-Signature-256, que trae un HMAC SHA-256 del cuerpo de la solicitud generado con el secreto de la app. Compáralo con el HMAC que calculas sobre el cuerpo crudo, antes de parsearlo. El paso a paso con código está en validar la firma del webhook.

32. ¿Cómo genero un token que no venza?

Creando un usuario del sistema en la configuración del negocio, asignándole la app y la cuenta de WhatsApp y generando un token con los permisos business_management, whatsapp_business_messaging y whatsapp_business_management. El token temporal del panel vence rápido. Lee token permanente con usuario del sistema.

33. ¿Cómo descargo la foto o el audio que envió el cliente?

El webhook trae el ID del archivo, no el archivo. Consultas ese ID en la Graph API para obtener la URL y descargas el archivo con el mismo token en el encabezado. El flujo completo está en recibir y descargar multimedia.

34. ¿Puedo poner un chatbot con IA en la API?

Sí. El webhook recibe el mensaje, tu sistema llama al modelo de IA y responde por la API dentro de la ventana de 24 horas. Desde julio de 2026 también existe la categoría Meta Business Agent, para respuestas generadas por la plataforma de IA de la propia Meta. Hay un tutorial con código en conectar ChatGPT a la API oficial.

Cuentas

35. ¿Tengo que verificar mi empresa en Meta?

No para empezar, pero la verificación cambia lo que puedes hacer: es uno de los caminos para pasar de 250 a 2.000 destinatarios y desbloquea más números y plantillas. Lee cómo obtener la API de WhatsApp.

36. ¿Cuántos números puedo registrar?

Los portafolios nuevos pueden registrar dos números. El tope pasa a 20 cuando la empresa se verifica o alcanza el límite de 2.000 mensajes. Cada número necesita código de país y de área y debe recibir SMS o llamada. Lee cómo registrar el número en la Cloud API.

37. ¿Qué cambió en la WABA en 2026?

Desde el 23/09/2026, la antigua WABA se dividió en cuenta de WhatsApp, que contiene el número, y cuenta de mensajes, que contiene plantillas, facturación y webhooks. Eso cambia cómo los socios acceden a la cuenta y cómo se cambia de proveedor. Lee cuenta de WhatsApp vs. cuenta de mensajes.

38. ¿Cómo cambio de proveedor sin perder el número?

Con la nueva estructura, cambiar de proveedor es compartir tu cuenta de WhatsApp con el nuevo socio, que la opera con su propia cuenta de mensajes. El número sigue siendo tuyo durante el cambio. Lee cambiar de proveedor de API de WhatsApp.

39. ¿Cómo funciona el nombre visible?

Es el nombre que ve el cliente. Lo indicas al registrar el número y Meta lo revisa, con estados como pendiente, aprobado o rechazado. Las reglas están en nombre visible en la API de WhatsApp.

40. ¿Dónde pido soporte a Meta?

Todos los desarrolladores pueden usar el soporte para desarrolladores de Meta, el foro de la comunidad y el formulario de errores. El Direct Support, con tickets, se describe como canal para desarrolladores enterprise, como los socios; los clientes de un socio deben contactarlo a él. Lee soporte de Meta para WhatsApp Business.

Cómo ayuda Vectalk

Vectalk es un proxy de la Cloud API oficial de Meta: tu aplicación envía a https://apis.vectalk.com.br/api/messages el mismo payload de Meta y Vectalk lo reenvía. Tú le pagas a Vectalk y Vectalk le paga a Meta. Los webhooks siguen el formato de la documentación de Meta, y el número puede quedar en coexistencia con la app WhatsApp Business. Empieza por la guía rápida o crea tu cuenta en apps.vectalk.com.br/register. Las dudas de cuenta y facturación van al Centro de Ayuda.

---

Fuentes oficiales consultadas el 28/10/2026: Acerca de la WhatsApp Business Platform, Get started, Precios, Límites de mensajes, Descripción general de la Cloud API, Plantillas, Marketing Messages API, Números de teléfono comerciales, Coexistencia, Evolución del modelo de cuentas, Soporte, Términos del Servicio de WhatsApp, Política de Mensajería Comercial.