Cómo configurar la API de WhatsApp Business paso a paso (y las trampas que Meta no te cuenta)

Te cuento algo que me pasa cada vez que un empresario me dice: quiero que mi negocio responda por WhatsApp automáticamente. Suena simple. Pero cuando se sientan a hacerlo, se encuentran con la documentación de Meta — y ahí empieza la pesadilla.

No porque sea imposible. Sino porque Meta explica las cosas para desarrolladores, no para personas que tienen un negocio que atender. Y hay trampas escondidas que solo descubres cuando ya perdiste tiempo (y a veces dinero).

He configurado esta integración más de una docena de veces para negocios reales — concesionarios, clínicas, inmobiliarias, restaurantes. Te voy a explicar el proceso completo, con los costes actualizados a 2026, los errores que casi nadie menciona, y un detalle técnico que evitará que tu integración se rompa un domingo sin que te des cuenta.

Primero: WhatsApp Business app vs. WhatsApp Business API — no es lo mismo

Este es el primer punto donde la mayoría se confunde. Existen tres versiones de WhatsApp para negocios:

• WhatsApp personal — el que usas todos los días. Cero funcionalidad de negocio.
• WhatsApp Business app — la app gratuita con perfil de empresa, catálogo y respuestas rápidas. Útil para negocios pequeños que manejan todo manual.
• WhatsApp Business API (Cloud API) — la versión profesional. Permite automatización, integración con CRM, chatbots, colaboradores digitales, envío masivo de templates y atención multicanal. Es la que necesitas si quieres escalar.

La app gratuita tiene un límite claro: solo funciona en un dispositivo (o hasta 4 con la versión premium), no permite automatización real, y no se conecta con otros sistemas. Si tu negocio recibe más de 20 mensajes al día o necesitas que un colaborador digital responda por ti, necesitas la API.

Qué necesitas antes de empezar (requisitos reales)

Meta lo hace sonar fácil en su documentación. La realidad tiene más pasos. Esto es lo que realmente necesitas:

• Una cuenta de Meta Business (antes Facebook Business Manager) — si no la tienes, créala en business.facebook.com. Necesitas una página de Facebook asociada a tu negocio. Si no tienes página, créala primero — tarda 5 minutos.
• Verificación de negocio — Meta te pide documentos para comprobar que tu empresa es real. En España: NIF de empresa, escritura de constitución o alta censal. En Latinoamérica: RUC, RUT, CUIT o equivalente. Tarda entre 2 y 14 días hábiles dependiendo de tu documentación.
• Un número de teléfono dedicado — que NO esté registrado en WhatsApp personal ni en la app de Business. Si tu número actual ya está en WhatsApp, tienes que migrarlo (y pierdes el historial) o usar uno nuevo. Consejo: compra una SIM nueva dedicada exclusivamente a esto.
• Una cuenta de desarrollador en Meta — te registras en developers.facebook.com con tu cuenta personal de Facebook. Es gratuito.
• Un servidor o servicio que reciba webhooks — cuando alguien te escribe, Meta envía una notificación a una URL tuya. Necesitas un servidor que la reciba y procese. Si no sabes qué es un webhook, no te preocupes — lo explico en el paso 4.
• Dominio web propio verificado — Meta verifica que tu web corresponde a tu negocio. Si no tienes web, este es un buen momento para plantearte una. Acelera la verificación y da profesionalidad.

Ojo con esto: los puntos 5 y 6 son donde la mayoría de empresarios se quedan. No porque sea técnicamente imposible, sino porque requiere infraestructura. Un servidor, código, mantenimiento. Si no tienes equipo técnico, ahí es donde tiene sentido contar con un sistema que ya tenga todo esto resuelto.

El proceso paso a paso (Cloud API — la versión actual)

Desde octubre de 2025, Meta eliminó la versión on-premise de la API. Todo funciona ahora con Cloud API — los servidores los maneja Meta. Eso simplifica bastante las cosas, pero el proceso de configuración sigue teniendo sus pasos. Te los detallo uno por uno.

Paso 1: Crear tu cuenta de Meta Business

Si ya tienes una cuenta en Meta Business Suite (business.facebook.com), puedes usarla. Si no, créala:

• Entra a business.facebook.com y haz clic en Crear cuenta.
• Ingresa el nombre legal de tu empresa (como aparece en tus documentos oficiales), tu nombre y tu email corporativo.
• Meta te envía un email de confirmación. Haz clic en el enlace.
• Una vez dentro, ve a Configuración del negocio > Información del negocio y completa todos los campos: dirección, teléfono, web. Cuanto más completa esté esta información, más rápida será la verificación.

Si ya tienes una página de Facebook de tu empresa, asegúrate de que esté asociada a esta cuenta de Meta Business. Es un requisito para el siguiente paso.

Paso 2: Crear tu app en Meta Developers

Entra a developers.facebook.com, ve a Mis Apps y crea una nueva. Selecciona el tipo de app Negocio y cuando te pregunte por el caso de uso, elige Enviar y recibir mensajes con la plataforma de WhatsApp Business.

Si no tienes un Meta Business Portfolio vinculado, el asistente te ayuda a crear uno. Asegúrate de vincular la app con la cuenta de Meta Business que creaste en el paso 1.

Paso 3: Agregar WhatsApp a tu app y conectar tu número

Dentro de tu app, busca WhatsApp en la sección de productos y agrégalo. Meta te dará un número de prueba temporal y un token de acceso para hacer tus primeras pruebas. Guarda ese token — lo necesitas para las pruebas iniciales (pero NO lo uses en producción, ya verás por qué).

Ahora conecta tu número real:

• Ve a la sección de WhatsApp > Números de teléfono dentro de tu app.
• Haz clic en Agregar número de teléfono.
• Introduce tu número dedicado con código de país (ej: +34 para España, +593 para Ecuador).
• Meta te envía un código de verificación por SMS o llamada de voz. Elige la opción que prefieras.
• Ingresa el código de 6 dígitos.
• Tu número queda vinculado a la API. A partir de este momento, ese número NO puede usarse en la app normal de WhatsApp.

Consejo práctico: ten el teléfono con la SIM dedicada a mano cuando hagas este paso. El código de verificación caduca en minutos.

Paso 4: Configurar el webhook

Este es el paso técnico. Cuando alguien te escribe por WhatsApp, Meta necesita avisarle a tu sistema. Lo hace enviando una petición a una URL que tú configuras — eso es un webhook.

• Ve a la sección de Webhooks de tu app en Meta Developers.
• Necesitas dos cosas: una URL de callback (tu servidor HTTPS donde Meta enviará los mensajes) y un token de verificación (una contraseña que tú inventas para que Meta confirme que la URL es tuya).
• Configura ambos y haz clic en Verificar y guardar. Meta hace una petición GET a tu URL para comprobar que responde correctamente.
• Después, suscríbete al evento messages — es el que te avisa cuando alguien te escribe.

Si no tienes servidor propio, puedes usar servicios como Supabase Edge Functions, AWS Lambda, Google Cloud Functions, o cualquier servicio que acepte webhooks HTTPS. Lo importante es que responda rápido (menos de 20 segundos) y esté disponible 24/7.

Si este paso te suena a chino, no te preocupes. Es exactamente la parte que un proveedor técnico resuelve por ti — y una de las razones por las que muchos negocios prefieren contratar la integración en vez de hacerla solos.

Paso 5: Crear y aprobar templates de mensajes

Aquí viene algo que sorprende a muchos: no puedes enviar cualquier mensaje a cualquier persona. Meta solo permite dos tipos de comunicación:

• Mensajes de respuesta (service messages) — dentro de una ventana de 24 horas después de que el cliente te escriba primero. Estos son GRATIS.
• Mensajes de template — mensajes pre-aprobados por Meta que tú inicias. Estos tienen costo por mensaje. Deben aprobarse antes de usarse.

Los templates se crean en el Meta Business Manager, dentro de WhatsApp > Administrador de cuentas > Plantillas de mensajes. Para cada template defines:

• Categoría: marketing, utilidad (confirmaciones/recordatorios) o autenticación (códigos de acceso). Elige bien porque la categoría afecta el precio.
• Idioma: selecciona es_ES para España. Si operas en Latinoamérica, puedes usar es_MX o es_AR (aunque es_ES funciona en la mayoría de países).
• Contenido: el texto del mensaje, con variables tipo {{1}}, {{2}} para personalizar (nombre del cliente, fecha de cita, etc.).
• Botones opcionales: llamada a la acción (ej: 'Confirmar cita') o respuesta rápida (ej: 'Sí' / 'No').

Meta revisa cada template y lo aprueba o rechaza en un plazo de entre 1 minuto y 24 horas. Consejo práctico: mantén tus templates cortos, informativos y con valor para el cliente. Los que suenan a publicidad agresiva se rechazan. Siempre incluye una opción de no recibir más mensajes.

Paso 6: Crear un System User y generar un token permanente

Este es el paso más importante de toda la guía y el que más gente hace mal. Si solo te llevas una cosa de este artículo, que sea esto.

El token temporal que Meta te da al crear tu app caduca en 24 horas. Si lo usas para conectar tu sistema de producción, un día tu WhatsApp deja de responder y no sabes por qué. He visto esto pasar en negocios reales — un domingo por la tarde, el token caduca, los clientes escriben y nadie contesta.

La solución es crear un System User (usuario del sistema). Es un tipo de usuario especial de Meta que representa a tu aplicación, no a una persona. Su token no caduca nunca.

Para crearlo, sigue estos pasos exactos:

• Entra a business.facebook.com y ve a Configuración del negocio.
• En el menú lateral izquierdo, busca Usuarios > Usuarios del sistema.
• Haz clic en Agregar. Ponle un nombre descriptivo (por ejemplo, 'WhatsApp API Produccion') y selecciona el rol Administrador.
• Una vez creado, haz clic en el System User y luego en Agregar activos.
• Selecciona Apps, elige tu app de WhatsApp y dale permisos de Control total.
• Repite el paso anterior pero selecciona WhatsApp Business Account (tu cuenta de WhatsApp Business, no la app) y dale también Control total.
• Ahora haz clic en Generar token. Selecciona tu app en el desplegable.
• Marca estos dos permisos: whatsapp_business_management y whatsapp_business_messaging. Son los únicos que necesitas.
• Haz clic en Generar token. Se muestra una sola vez — cópialo inmediatamente y guárdalo en un lugar seguro.

Este token es tu credencial de producción. No caduca, no necesita renovación manual, y es el que tu sistema usa para enviar y recibir mensajes programáticamente. Si necesitas revocarlo por seguridad, puedes hacerlo desde el mismo panel.

Un detalle técnico que importa: la URL base de la API es graph.facebook.com (versión actual: v22.0). No uses graph.instagram.com ni endpoints antiguos — funcionan un tiempo y luego dejan de funcionar cuando Meta depreca versiones. La URL correcta para enviar un mensaje es: graph.facebook.com/v22.0/TU_NUMERO_ID/messages.

Paso 7: Verificar tu negocio en Meta

Meta requiere verificación de negocio para desbloquear funcionalidades de producción, como enviar templates a números que no te han escrito primero y aumentar los límites de envío.

La verificación se hace desde Meta Business Suite > Configuración del negocio > Centro de seguridad > Verificación del negocio. Meta te pide:

• Documentación legal del negocio — En España: NIF de empresa, escritura de constitución o alta censal. En Latinoamérica: RUC, RUT, CUIT, NIT o equivalente en tu país. El documento debe mostrar claramente el nombre legal y la dirección de la empresa.
• Un dominio web verificado — Meta comprueba que el dominio de tu web corresponde a tu negocio. Puedes verificarlo de dos formas: añadiendo un registro TXT a tu DNS, o subiendo un archivo HTML a la raíz de tu servidor. La opción DNS es la más común.
• Dirección y teléfono coherentes — La información de tu negocio debe coincidir entre tu web, tu página de Facebook, Google Business y los documentos que presentes. Las inconsistencias son la causa número uno de retrasos.
• Presencia online verificable — Meta revisa que tu negocio tiene presencia real en internet. Un perfil de Google Business activo con reseñas, redes sociales con contenido reciente, y una web profesional ayudan.

En España, con el NIF de empresa y un dominio web verificado, el proceso suele resolverse en 2-5 días laborables. En Latinoamérica los tiempos varían: México y Colombia entre 3-7 días, otros países hasta 2 semanas. Si tu documentación está en orden y no hay inconsistencias, Meta tiende a aprobar rápido.

Paso 8: Probar todo antes de ir a producción

Antes de que tu primer cliente real reciba un mensaje automático, pasa por esta lista de comprobación:

• Envía un template de prueba a tu propio número — verifica que llega, se muestra bien, y los botones funcionan.
• Prueba la ventana de 24 horas — escríbete desde otro número, responde con tu sistema, y verifica que el flujo de respuesta automática funciona de principio a fin.
• Verifica que el webhook recibe y procesa — revisa los logs de tu servidor para confirmar que cuando te escriben, el mensaje llega y se procesa correctamente.
• Confirma que el endpoint es graph.facebook.com/v22.0 — no graph.instagram.com, no versiones antiguas. Este error causa fallos silenciosos que tardan días en detectar.
• Verifica que usas el token del System User — no el temporal de prueba. Mira el paso 6.
• Configura alguna alerta — si tu webhook falla 3 veces seguidas, Meta desactiva las notificaciones sin avisarte. Ten un sistema que te alerte cuando deje de recibir mensajes.

Una vez que todo funciona, ya puedes dar de alta tu número en producción y empezar a atender clientes.

Cuánto cuesta realmente (cifras actualizadas 2026)

La API de WhatsApp Cloud es gratuita en sí misma — no pagas por usarla. Lo que sí pagas es por cada mensaje de template que envías. Desde julio de 2025, Meta cobra por mensaje individual, no por conversación.

Los precios varían por país y categoría de mensaje:

• Marketing (promociones, ofertas): el más caro. Entre $0.01 y $0.22 USD por mensaje según el país del destinatario.
• Utility (confirmaciones, recordatorios): entre $0.005 y $0.08 USD por mensaje.
• Authentication (códigos de verificación): entre $0.003 y $0.07 USD por mensaje.
• Service (respuestas dentro de las 24h): GRATIS. Cero costo.

Para un negocio en España que envía 500 templates de utility al mes (confirmaciones de cita, recordatorios), estamos hablando de unos 15-25 EUR mensuales en costes de Meta. Si agregas 200 mensajes de marketing, sube a unos 40-60 EUR. Comparado con lo que cuesta una persona contestando esas mismas 700 interacciones manualmente, la diferencia es enorme.

Las 7 trampas que Meta no te cuenta (y que aprendí configurando esto para negocios reales)

1. Tu número queda secuestrado

Una vez que conectas un número a la API, no puedes volver a usarlo en la app normal de WhatsApp sin un proceso de migración que puede tardar días. Usa siempre un número dedicado. Nunca el personal.

2. La ventana de 24 horas es más estricta de lo que parece

Si un cliente te escribe y no respondes en 24 horas, la ventana se cierra. Después solo puedes contactarlo con un template aprobado (y pagando). He visto negocios que pierden oportunidades porque no tenían automatización para responder dentro de esa ventana.

3. Los templates se rechazan sin explicación clara

Meta puede rechazar un template y darte un motivo genérico como contenido no permitido. A veces es por una palabra, a veces por el tono. La mejor práctica: hazlos informativos, no promocionales. Y siempre incluye una opción de no recibir más mensajes.

4. El webhook necesita responder en menos de 20 segundos

Si tu servidor tarda más de 20 segundos en responder el webhook, Meta lo marca como fallido. Después de varios fallos, desactiva las notificaciones. Tu negocio deja de recibir mensajes sin que te des cuenta. Necesitas infraestructura confiable, no un servidor compartido barato.

5. El idioma del template importa

Los templates se aprueban por idioma específico. Si tu template está en es_ES (español de España) y luego quieres usarlo con público en Latinoamérica, necesitas otro template en es_MX o es_AR. No hay un español genérico que cubra todo. En nuestra experiencia, usar es_ES funciona para la mayoría de países hispanohablantes, pero hay que saber esto antes de configurar.

6. Los tokens de usuario caducan sin aviso

Meta ofrece dos tipos de token: el de usuario (temporal, caduca entre 1 hora y 60 días) y el de System User (permanente). He visto negocios donde alguien configuró el token temporal porque funcionaba en las pruebas, y semanas después el sistema dejó de enviar mensajes. Nadie se dio cuenta hasta que un cliente importante no recibió su confirmación de cita. El token del System User no caduca — es la única opción segura para producción. Detalle completo en el Paso 6.

7. El endpoint de la API no es el que piensas

La documentación de Meta tiene URLs dispersas en diferentes páginas y versiones. El endpoint correcto para la API de WhatsApp Business es graph.facebook.com con la versión más reciente (hoy: v22.0). He visto integraciones usando graph.instagram.com o versiones deprecadas — funcionan un tiempo y después fallan cuando Meta retira el endpoint antiguo. Si estás copiando código de un tutorial, verifica siempre que la URL base sea graph.facebook.com.

Entonces, tiene sentido hacerlo tú mismo?

Depende. Si tienes equipo técnico, tiempo, y quieres controlar cada detalle, la Cloud API de Meta es gratuita y bien documentada (para desarrolladores). El proceso completo toma entre 3 y 7 días si todo sale bien — más si la verificación del negocio se retrasa.

Pero si lo que quieres es que tu negocio atienda por WhatsApp de forma profesional y automática — sin escribir código, sin mantener servidores, sin pelear con templates rechazados — entonces lo que necesitas es un sistema que ya tenga todo esto integrado.

En IA & Negocios, la integración de WhatsApp viene incluida dentro del Centro de Mando Inteligente. Nuestro colaborador digital ya maneja todo lo que describí arriba: webhooks, templates, ventana de 24 horas, automatización inteligente, tokens permanentes. El empresario se enfoca en su negocio, no en configurar APIs.

Mi punto de vista

La API de WhatsApp Business es una herramienta potente. Meta hizo bien en hacerla accesible con Cloud API. Pero hay una diferencia enorme entre tener acceso a una herramienta y saber integrarla dentro de tu operación de negocio.

Lo que yo veo en la realidad es que la mayoría de negocios necesitan WhatsApp funcionando como parte de algo más grande: conectado al CRM, a la agenda, al historial del cliente, a las métricas de ventas. WhatsApp solo, por más API que tenga, sigue siendo un canal aislado si no está dentro de una estructura que lo conecte con todo lo demás.

Eso es lo que construimos en IA & Negocios. No vendemos la configuración de una API. Construimos el sistema operativo digital donde esa API — y todas las demás — trabajan juntas como un equipo. Un organigrama híbrido donde humanos y colaboradores digitales operan desde el mismo Centro de Mando.

WhatsApp es un canal. Tu negocio necesita un sistema. No confundas tener un canal con tener operación.

— Francisco Ocaña — IA & Negocios

Preguntas frecuentes

¿La API de WhatsApp Business es gratis?

La API en sí no tiene coste de acceso. Meta cobra por cada mensaje de template que envías, con precios que van desde $0.003 hasta $0.22 USD según categoría y país. Los mensajes de respuesta dentro de la ventana de 24 horas (service messages) son completamente gratuitos.

¿Puedo usar mi número de WhatsApp actual con la API?

Sí, puedes migrar tu número existente a la API de WhatsApp Business. Ten en cuenta que durante el proceso dejarás de usar la app normal de WhatsApp Business en ese número, y el historial de conversaciones no se conserva. Lo recomendable es usar un número dedicado nuevo.

¿Cuánto tarda el proceso completo de configuración?

Si tienes todos los requisitos listos (cuenta Meta Business, número dedicado, documentación del negocio), el proceso técnico se completa en 1-2 días. La verificación del negocio puede añadir entre 2 y 14 días más, dependiendo de tu documentación y país.

¿Necesito un programador para configurar la API de WhatsApp?

La configuración de la cuenta en Meta (pasos 1-3, 5-7) la puede hacer cualquier persona con esta guía. El paso técnico es el webhook (paso 4) — ahí necesitas alguien con conocimientos técnicos o un proveedor que ya tenga la infraestructura montada.

¿Qué diferencia hay entre un token temporal y un System User token?

El token temporal caduca en 24 horas a 60 días y se genera automáticamente al crear la app. El System User token no caduca nunca y se genera manualmente desde el panel de usuarios del sistema en Meta Business Suite. Para producción, siempre usa el System User token. La sección de Paso 6 te explica cómo crearlo.

¿Qué pasa si supero el límite de mensajes permitidos?

Meta asigna límites de envío por niveles (1K, 10K, 100K mensajes/día) que aumentan automáticamente según tu reputación de envío. Si alcanzas el límite, simplemente no puedes iniciar nuevas conversaciones hasta el día siguiente, pero las conversaciones activas siguen funcionando.

¿Por qué Meta rechazó mi template?

Las causas más comunes son: tono demasiado comercial, falta de opción de baja, uso de variables en contextos no permitidos, o contenido que Meta considera spam. La regla de oro: templates informativos y útiles para el cliente, nunca agresivos ni promocionales.