¿Qué es la API de WhatsApp Business y cómo empezar en 2026?
Qué es la API de WhatsApp Business, quién la necesita, las tres formas de obtener acceso y los requisitos, la verificación, las plantillas y los problemas de configuración que vas a encontrar.
La API de WhatsApp Business es la forma que ofrece Meta para que un software envíe y reciba mensajes de WhatsApp en el número de un negocio. Su nombre oficial es WhatsApp Business Platform, y la parte a la que te conectas es la API de Cloud, alojada por Meta. Con ella, una bandeja compartida, un CRM, un sistema de reservas o un agente de IA pueden atender a tus clientes por WhatsApp, en lugar de una sola persona con un solo teléfono.
Puedes empezar de tres formas: configurar la API de Cloud por tu cuenta en el panel de desarrolladores de Meta, darte de alta con un socio de Meta o conectar tu número a una plataforma de mensajería que hace la configuración por ti. Todas piden lo mismo: un portafolio comercial de Meta, un número que no esté activo en WhatsApp normal, un nombre visible que pase la revisión y plantillas aprobadas para cualquier mensaje que inicies tú.
Elige la API de Cloud si tienes un desarrollador, un proveedor de soluciones empresariales si quieres una sola factura y un contrato de soporte, y una plataforma si quieres una bandeja o un agente de IA listos para usar.
¿Qué es la API de WhatsApp Business?
Es un conjunto de API, no una aplicación. La API de Cloud de Meta envía y recibe mensajes, la API de administración de WhatsApp Business gestiona cuentas, números y plantillas, y los webhooks entregan a tu servidor cada mensaje entrante y cada cambio de estado. La descripción general de WhatsApp Business Platform de Meta enumera cada pieza.
Eso tiene una consecuencia práctica: no hay una pantalla desde la que contestar a los clientes. Necesitas algo que trabaje sobre la API, ya sea código que escriben tus desarrolladores, una bandeja de equipo, un CRM o un agente de IA. Por eso también puedes terminar pagando a Meta por los mensajes y a un proveedor por el software, algo que desglosamos en nuestra guía de precios de la API de WhatsApp Business.
En la configuración actual de Meta, dentro de tu portafolio comercial hay tres activos: una cuenta de WhatsApp para la presencia de tu negocio, incluidos sus números, una cuenta de mensajería que guarda tus plantillas y tu facturación, y una app autorizada para usarlas. Las guías antiguas llaman a la segunda cuenta de WhatsApp Business, o WABA, y ese nombre todavía aparece en la API.
¿Quién necesita la API de WhatsApp Business?
La app gratuita de WhatsApp Business alcanza cuando una o dos personas contestan desde un teléfono y el volumen es manejable. Si es tu caso, nuestra comparación entre WhatsApp, WhatsApp Business y la API explica qué puede hacer la app y qué no.
Necesitas la API cuando se cumple alguna de estas condiciones:
- Varias personas tienen que contestar el mismo número desde su propia computadora, con cada chat asignado a alguien.
- Quieres que un agente de IA o un chatbot responda, también de noche y los fines de semana.
- WhatsApp tiene que hablar con otro sistema, como un motor de reservas, una tienda, un CRM o un sistema de gestión hotelera.
- Envías confirmaciones, recordatorios o avisos a muchos clientes y quieres que salgan solos.
- Necesitas reportes de tiempos de respuesta, volumen y resultados de todo el equipo.
¿De qué formas puedes obtener acceso a la API de WhatsApp Business?
Meta permite que un negocio se conecte por su cuenta o a través de un socio. Hay dos tipos principales de socios. Los proveedores de soluciones empresariales, a menudo llamados BSP, pueden darte una línea de crédito y facturarte las tarifas de Meta. Los proveedores de tecnología te dan de alta con el flujo de registro de Meta, y luego Meta te cobra los mensajes directamente mientras el proveedor cobra su propio software. La documentación para socios de Meta explica la diferencia.
En la práctica, quedan tres caminos:
| Camino | Ideal para | Quién cobra las tarifas de mensajes de Meta | Configuración | Para tener en cuenta |
|---|---|---|---|---|
| API de Cloud por tu cuenta | Equipos con un desarrollador que quieren control total | Meta, a tu método de pago | Crear una app de Meta, registrar un número, alojar un webhook y construir la interfaz | No hay tarifa de proveedor. Tú construyes y mantienes todo, y la coexistencia requiere un socio |
| Proveedor de soluciones empresariales (BSP) | Empresas grandes que quieren una sola factura y un contrato de soporte | Normalmente el proveedor, con su línea de crédito | El proveedor configura las cuentas por ti | Revisa qué incluye además del acceso a la API, como una bandeja o automatización, y qué cobra el proveedor sobre las tarifas de Meta |
| Plataforma que te conecta | Equipos que quieren una bandeja, automatización o un agente de IA listos para usar | Meta si la plataforma es un proveedor de tecnología, la plataforma si es un proveedor de soluciones empresariales | Inicias sesión con Meta desde la plataforma y eliges o agregas un número | Dependes de las funciones de la plataforma, así que revisa cómo maneja las plantillas, el traspaso a tu equipo y tus otros sistemas |
Visito es un ejemplo del tercer camino: conectas tu número desde el panel de Visito con el flujo de registro de Meta, y tu plan de Visito es independiente de las tarifas de mensajes de Meta. Si quieres comparar proveedores de la API en general, nuestra lista de alternativas a Twilio para WhatsApp revisa doce, incluida la propia API de Cloud de Meta.
¿Qué necesitas antes de empezar?
Reúne esto antes de abrir cualquier pantalla de configuración. A la mayoría de las configuraciones que se quedan a medias les falta alguna de estas cosas:
- Un portafolio comercial de Meta, creado en business.facebook.com, con al menos un administrador con control total.
- Una cuenta de Facebook o una cuenta de Meta administrada para quien hace la configuración, registrada como desarrollador de Meta si eliges la API de Cloud.
- Un número de teléfono propio con código de país y de área que pueda recibir un SMS o una llamada. Los números cortos no se admiten, y un celular es lo más fácil de verificar.
- Un número que no esté activo en WhatsApp. Si lo está, elimina primero esa cuenta de WhatsApp o usa la coexistencia para mantener la app de WhatsApp Business en él.
- Los datos legales de tu negocio (nombre, dirección, teléfono y sitio web) escritos tal como aparecen en los documentos oficiales, y un sitio web que cargue con HTTPS.
- Un método de pago para las tarifas de mensajes de Meta, salvo que te facture un proveedor de soluciones empresariales.
- El consentimiento de tus clientes. Meta lo exige antes de enviarles plantillas, y el consentimiento tiene que mencionar el nombre de tu negocio.
¿Cómo configuras la API de Cloud por tu cuenta, paso a paso?
Si tienes un desarrollador y quieres conectarte directamente, la guía para empezar con la API de Cloud de Meta sigue estos pasos:
- Crea una app en el panel de apps de Meta, elige el caso de uso para conectar con clientes por WhatsApp y asocia tu portafolio comercial.
- En la configuración de la API, conecta una cuenta de mensajería o crea una. Meta también te da un número de prueba que puede enviar plantillas de prueba sin método de pago.
- Genera un token de acceso temporal y envía la plantilla hello_world a tu propio teléfono para confirmar que funciona.
- Configura un endpoint de webhook para que tu servidor reciba los mensajes entrantes y los estados de entrega.
- Crea un usuario del sistema en la configuración del negocio y genera un token permanente con los permisos business_management, whatsapp_business_messaging y whatsapp_business_management. El token temporal vence rápido.
- Agrega tu número real, verifícalo con un código por SMS o llamada, define un PIN de verificación en dos pasos de seis dígitos y regístralo en la API de Cloud.
- Agrega un método de pago, crea tus primeras plantillas y empieza a construir la interfaz que van a usar tu equipo o tu agente.
Enviar un mensaje de prueba es lo fácil. El trabajo de verdad viene después del último paso: una bandeja, asignación de chats, almacenamiento, gestión de plantillas y monitoreo. Tenlo en cuenta en tu presupuesto antes de elegir este camino.
¿Cómo funciona la verificación del negocio en Meta?
La verificación del negocio le confirma a Meta que tu portafolio pertenece a una empresa real y registrada. Puedes usar la API sin ella, pero a pequeña escala. La página de límites de mensajes de Meta dice que un portafolio nuevo puede escribir a 250 clientes únicos fuera de una ventana de atención al cliente en un periodo móvil de 24 horas. Verificar tu negocio es una de las formas de llegar a 2,000. También sube tu tope de dos números registrados a 20 y es un requisito para solicitar la insignia azul, que Meta llama cuenta oficial de empresa.
Para verificar, un administrador con control total abre el Centro de seguridad en Meta Business Suite, hace clic en Iniciar verificación y escribe el nombre legal, la dirección, el teléfono y el sitio web. Si Meta no encuentra un registro que coincida, pide documentos como una licencia comercial o el acta constitutiva. Después confirmas la conexión por correo, llamada, mensaje de texto, mensaje de WhatsApp o verificación del dominio.
Los pasos de verificación del negocio de Meta dicen que la decisión puede tardar hasta 14 días hábiles, y que si editas los datos del negocio después tienes que verificar de nuevo. Empieza la verificación el primer día, porque suele ser el paso más lento. Tampoco es lo mismo que Meta Verified, la suscripción de pago con insignia.
¿Cómo consigues que aprueben tu nombre visible?
Cada número de la API necesita un nombre visible, el nombre del negocio que los clientes ven en tu perfil de WhatsApp. Meta lo revisa según sus pautas para el nombre visible, y un nombre aprobado también puede aparecer arriba de los chats. Las reglas se resumen en tres cosas: cumplir las políticas de WhatsApp, describir tu negocio real y mostrar una relación clara con tu nombre legal o tu marca pública.
Los nombres que se rechazan suelen romper alguna de estas reglas:
- Una palabra genérica o un lugar solos, como "Moda" o "Nueva York".
- "Oficial" o "Verificado" en el nombre.
- Una mención de Meta, WhatsApp o Facebook.
- Texto promocional, como un descuento o "el mejor de la ciudad".
- Una dirección web o de correo como nombre.
- Una marca que no aparece en ningún otro lugar. Si la marca y la empresa legal son distintas, muestra la relación en tu sitio web o usa el formato "Marca by Empresa" que propone Meta.
Meta te deja cambiar el nombre visible hasta 10 veces en 30 días. Cuando se aprueba un nombre nuevo, tienes que volver a registrar el número dentro de 14 días para que el cambio se aplique.
¿Qué son las plantillas de mensajes y cuándo las necesitas?
Cuando un cliente te escribe, se abre una ventana de atención al cliente de 24 horas y puedes responder con cualquier mensaje. Fuera de esa ventana, Meta solo te deja enviar plantillas: mensajes que escribes por adelantado y envías a aprobación. Las confirmaciones, los recordatorios, los seguimientos y las campañas son plantillas.
Cada plantilla tiene una categoría (marketing, utilidad o autenticación), un idioma y variables opcionales como {{first_name}} para los datos que cambian según el cliente. La categoría también define lo que cobra Meta. Meta revisa cada plantilla, con sistemas automáticos y a veces una persona, y decide en un máximo de 24 horas. Después, califica cada plantilla según cómo responden los clientes. Las plantillas que reciben comentarios negativos o tienen tasas de lectura bajas pueden quedar en pausa o desactivadas.
La guía de revisión de plantillas de Meta enumera los motivos de rechazo más comunes. Revisa las tuyas antes de enviarlas:
- Variables mal escritas, fuera de orden, con símbolos como # o $, o justo al principio o al final del mensaje.
- Demasiadas variables para un mensaje corto.
- Solicitudes de números de tarjeta completos, números de identificación u otros datos sensibles.
- Contenido que incumple la Política de Comercio de WhatsApp o amenaza al cliente.
- El mismo cuerpo y pie de página que una plantilla que ya tienes.
¿Cuántos mensajes puedes enviar?
Hay dos límites distintos. El límite de mensajes cuenta los clientes únicos a los que puedes escribir fuera de una ventana de atención al cliente en un periodo móvil de 24 horas, y lo comparten todos los números de tu portafolio comercial. Empieza en 250, sube a 2,000 cuando verificas tu negocio o envías plantillas de alta calidad a 2,000 clientes únicos en 30 días, y después sube solo a 10,000, 100,000 e ilimitado. Meta lo aumenta cuando tus mensajes mantienen una calificación de calidad alta y usaste al menos la mitad de tu límite en los últimos siete días.
La velocidad de envío es otra cosa. Un número puede enviar hasta 80 mensajes por segundo de forma predeterminada, y un mensaje cada seis segundos al mismo cliente, con ráfagas cortas permitidas. Las respuestas dentro de una ventana de atención abierta no cuentan para el límite de mensajes, así que un equipo que sobre todo contesta consultas entrantes casi nunca lo alcanza.
¿Puedes seguir usando la app de WhatsApp Business en el mismo número?
Sí, con lo que Meta llama la incorporación de usuarios de la app de WhatsApp Business y casi todos llaman coexistencia. Sigues contestando desde la app en tu teléfono mientras un software usa la API en el mismo número, y los chats se mantienen sincronizados. Durante la configuración puedes traer hasta seis meses de historial de chats individuales y tus contactos.
Hay que aceptar algunos límites. La documentación de coexistencia de Meta dice que solo los proveedores de soluciones empresariales y los proveedores de tecnología pueden ofrecerla, así que no puedes configurarla con la API de Cloud sola por tu cuenta. La velocidad de envío queda fija en 20 mensajes por segundo, las listas de difusión y los mensajes temporales se desactivan, los chats grupales no se sincronizan y los dispositivos vinculados se desvinculan, y WhatsApp para Windows y Wear OS dejan de funcionar como dispositivos vinculados. Si usas esas funciones a diario, quizá te convenga pasar del todo a la API, y los pasos para configurar la coexistencia muestran qué cambia con cada opción.
¿Cuáles son los problemas de configuración más comunes?
Estos son los problemas que más aparecen, con la solución habitual:
- "Este número ya está registrado en WhatsApp". Elimina primero la cuenta de WhatsApp o WhatsApp Business de ese número, o conéctalo con coexistencia. Un número bloqueado tiene que pasar por una apelación antes de poder usarse.
- El código de verificación nunca llega. Meta no recomienda códigos por SMS para números fijos, gratuitos o VoIP. Elige la llamada, y si el número tiene un menú telefónico, permite los números desde los que llama Meta y desvía la llamada a una persona.
- Rechazan la verificación del negocio. Los datos que escribiste no coinciden con tus documentos o tu sitio web. Copia el nombre legal y la dirección exactamente, confirma que el sitio cargue con HTTPS y vuelve a enviarla.
- Rechazan el nombre visible. Compáralo con las pautas de arriba, edítalo o apela.
- Rechazan una plantilla. Lee el motivo en WhatsApp Manager, corrige las variables o el texto, agrega valores de ejemplo y vuelve a enviarla o apela.
- Perdiste el PIN de verificación en dos pasos. Puedes definir uno nuevo a través de la API sin el PIN anterior.
- Los mensajes dejaron de salir después de un día. Venció el token de acceso temporal. Usa un token de usuario del sistema.
- Los mensajes entrantes nunca llegan a tu sistema. Revisa que tu app esté suscrita al campo messages del webhook y que tu endpoint sea accesible desde internet.
- No puedes responderle a un cliente. Se cerró la ventana de 24 horas, así que necesitas una plantilla aprobada.
- El límite no pasa de 250. Verifica tu negocio o envía plantillas de alta calidad a 2,000 clientes únicos en 30 días.
¿Cómo pones un agente de IA en la API de WhatsApp Business?
Un agente de IA en WhatsApp necesita tres cosas además de la conexión a la API: información de la que sacar las respuestas (tu sitio web, políticas, precios y documentos), acciones en tus propios sistemas (consultar disponibilidad, un pedido o una reserva) y un traspaso limpio a una persona cuando no debe responder. También tiene que cumplir las reglas de WhatsApp. La política de IA de WhatsApp prohíbe los asistentes de IA de uso general en Business Platform, pero permite los agentes que atienden a tus propios clientes.
Puedes construirlo sobre la API de Cloud con un modelo de lenguaje y tu propio código, usar Meta Business Agent, que Meta ahora ofrece dentro de la plataforma, o usar una plataforma que ya trae el agente, la bandeja y las integraciones. Construirlo te da control total, pero es lo que más trabajo exige. El agente de Meta deja todo dentro de Meta. Una plataforma sacrifica algo de flexibilidad a cambio de rapidez, y los agentes de IA para WhatsApp se diferencian sobre todo en cómo se conectan a tus sistemas y pasan los chats a las personas.
Visito es una de esas plataformas. Su agente de IA para WhatsApp responde con tu contenido, consulta tus sistemas con integraciones nativas o la API de Visito y pasa el chat a tu equipo en una bandeja compartida.
¿Qué más pregunta la gente sobre la API de WhatsApp Business?
¿La API de WhatsApp Business es gratis?
Meta no cobra por conectar un número. Le pagas a Meta por mensaje según sus reglas de precios, que dependen de la categoría del mensaje y del país del cliente, y cada proveedor suma su propia tarifa. Meta publica sus tarifas en su página de precios de la plataforma.
¿Necesito un desarrollador?
Para la API de Cloud por tu cuenta, sí, porque necesitas un servidor de webhooks y una interfaz. Con un socio o una plataforma, no. Inicias sesión con Meta, eliges un número y la plataforma hace el resto.
¿Cuánto tiempo toma empezar?
Un mensaje de prueba toma minutos. Conectar un número real con un socio o una plataforma es rápido cuando tu portafolio y tu número están listos. La verificación del negocio puede tardar hasta 14 días hábiles, y la revisión de cada plantilla suele tardar hasta 24 horas.
¿Puedo usar mi número de WhatsApp actual?
Sí. Puedes eliminarlo de la app de WhatsApp y registrarlo en la API, o mantener la app de WhatsApp Business en él con coexistencia. Sin coexistencia, un número no puede estar en WhatsApp normal y en la API al mismo tiempo.
¿Puedo enviar mensajes masivos?
Sí, con plantillas aprobadas, a clientes que dieron su consentimiento y dentro de tu límite de mensajes. Las campañas de baja calidad hacen que pausen tus plantillas y frenan el aumento del límite, así que envía lo que tus clientes esperan.
¿Puedo cambiar de proveedor más adelante?
Normalmente, sí. Antes de cambiar, pregúntale al nuevo proveedor cómo traslada tu número, confirma quién será el dueño de la cuenta de mensajería y consigue que aprueben tus plantillas en la cuenta nueva antes de enviar.
¿Cómo conectas tu número de WhatsApp a Visito?
Visito conecta tu número de WhatsApp con el flujo de registro de Meta, con coexistencia si quieres mantener la app de WhatsApp Business, y suma un agente de IA y una bandeja compartida. Tus desarrolladores pueden trabajar con las mismas conversaciones a través de la API de Visito.
Empieza en el plan gratuito con el chat del sitio web y entrena al agente con tu contenido. Cuando responda como quieres, agrega WhatsApp en un plan de pago.
