Cómo obtener acceso a la API de WhatsApp: paso a paso

Actualizado el 25/10/2026

Para obtener acceso a la API oficial de WhatsApp necesitas un portafolio comercial en Meta, una cuenta de WhatsApp con un número registrado en Cloud API, una cuenta de mensajería con método de pago y una app (tuya o de un proveedor) con permiso para usar esos activos. Hay dos caminos: integrarte directo desde el panel de desarrolladores de Meta o pasar por el registro insertado (Embedded Signup) de un proveedor, que crea todo en pocas pantallas. No existe una fila de aprobación para «liberar la API»; lo que lleva tiempo es verificar la empresa y preparar el número.

Esta guía muestra qué dejar listo, los dos caminos paso a paso y los bloqueos más comunes.

Qué necesitas antes de empezar

Elemento	Para qué sirve	Nota
Portafolio comercial (Meta Business Suite)	Agrupa cuentas, números, usuarios y pago	Obligatorio para usar la plataforma
Cuenta de WhatsApp	Guarda el número, el nombre visible y el perfil	Con el nuevo modelo de cuentas de 2026, separada de la cuenta de mensajería
Cuenta de mensajería (antigua WABA)	Guarda plantillas, cobro y suscripción de webhooks	El waba_id sigue valiendo como su ID
Número de teléfono	Envía y recibe los mensajes	Debe recibir SMS o llamada
App de tipo empresa en Meta	Hace las llamadas a la API	Tuya (integración directa) o del proveedor
Método de pago	Paga los mensajes entregados	Vinculado a la cuenta de mensajería, salvo que el proveedor te facture

Fuentes: About the platform y Updates to WhatsApp Business accounts.

Requisitos del número

Según la documentación de números comerciales, el número debe:

• pertenecer a tu empresa;
• tener código de país y de área (no se aceptan códigos cortos);
• recibir una llamada de voz o un SMS con el código de verificación.

Los números que ya se usan en WhatsApp solo se pueden registrar después de eliminarlos de la app. La excepción es el número de la app WhatsApp Business, que puede pasar a la API sin salir de la app mediante la coexistencia. Si el número está en WhatsApp común, mira cómo liberar un número para la API. También se aceptan números fijos y gratuitos (0800), siempre que puedan recibir la llamada de verificación, incluso cuando hay un IVR.

Camino 1: integración directa con Meta

Es el camino de quien tiene equipo de desarrollo y usará la API solo para su propia empresa. Los pasos siguen la guía Get started de Meta.

1. Crea la app. En el panel de apps, crea una app y elige el caso de uso «Conectar con clientes a través de WhatsApp». Durante la creación, selecciona un portafolio existente o crea uno.
2. Usa los recursos de prueba. Meta crea automáticamente una cuenta y un número de prueba. Tienen límites relajados y no exigen método de pago para enviar plantillas.
3. Envía el primer mensaje. En WhatsApp > API Setup, genera un token temporal y manda un mensaje de prueba. Ese token vence rápido y sirve solo para el primer contacto.
4. Configura el webhook. Indica la URL de callback y el token de verificación en WhatsApp > Configuration y suscríbete al campo messages. Sin webhook no recibes mensajes ni estados.
5. Crea un token permanente. En Configuración del negocio > Usuarios del sistema, crea un usuario del sistema, dale acceso a la app y a las cuentas y genera un token con business_management, whatsapp_business_management y whatsapp_business_messaging. El detalle está en token permanente.
6. Agrega el número real. En WhatsApp Manager, agrega el número a la cuenta y confirma que es tuyo con el código por SMS o llamada. En este paso defines el nombre visible.
7. Registra el número en Cloud API. Agregar y verificar no basta: el registro se hace por API, con un PIN de seis dígitos de verificación en dos pasos.
8. Registra el método de pago. En el Billing Hub, vincula un medio de pago a la cuenta de mensajería.
9. Crea y aprueba plantillas. Fuera de la ventana de 24 horas, solo se pueden enviar plantillas aprobadas.

El registro del paso 7 queda así:

curl 'https://graph.facebook.com/v26.0/TU_PHONE_NUMBER_ID/register' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer TU_TOKEN_DE_USUARIO_DEL_SISTEMA' \
  -d '{
    "messaging_product": "whatsapp",
    "pin": "212834"
  }'

Si el número aún no tiene verificación en dos pasos, el PIN que envías se convierte en su PIN. Guárdalo: lo necesitarás para cambiar el PIN o eliminar el número de la plataforma. La página de registro limita este endpoint a 10 solicitudes por número en 72 horas; si te pasas, la API devuelve el error 133016 y bloquea nuevos intentos por 72 horas.

Para confirmar que funcionó, consulta el estado del número. Debe estar CONNECTED para enviar y recibir:

curl 'https://graph.facebook.com/v26.0/TU_PHONE_NUMBER_ID?fields=status,verified_name,quality_rating' \
  -H 'Authorization: Bearer TU_TOKEN_DE_USUARIO_DEL_SISTEMA'

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

Camino 2: con un proveedor, mediante el registro insertado

Los proveedores (Solution Partners y Tech Providers, explicados en qué es un BSP y un Tech Provider) ofrecen el registro insertado, una ventana de Meta que se abre desde el sitio del proveedor. En ella, la empresa:

1. inicia sesión con su cuenta de Facebook o de Meta Business;
2. acepta los términos de Cloud API, WhatsApp Business y Meta;
3. elige un portafolio existente o crea uno;
4. elige una cuenta de WhatsApp existente o crea una;
5. ingresa y verifica el número;
6. define el nombre visible;
7. autoriza a la app del proveedor a acceder a esos activos.

Al terminar, Meta le devuelve al proveedor el waba_id, el phone_number_id y un código que él cambia por un token limitado a ese cliente. Luego el proveedor registra el número, suscribe los webhooks y, si es Solution Partner, comparte su línea de crédito.

El siguiente paso depende del tipo de proveedor. Con un Solution Partner (o un socio de uno), la empresa ya puede enviar mensajes. Si no, primero debe vincular un método de pago a la cuenta de mensajería.

Los activos creados quedan en el portafolio de la empresa, que mantiene acceso total a WhatsApp Manager. El proveedor no puede restringir ese acceso.

Directo o con proveedor: comparación

	Integración directa	Con proveedor
Quién crea y mantiene la app en Meta	Tú	El proveedor
Credencial de acceso	Token de usuario del sistema de tu portafolio	La define el proveedor, que guarda el token de Meta
Webhook	Un endpoint por app, configurado por ti	Lo configura el proveedor
Registro del número	Tú llamas a /register	Lo hace el proveedor en el onboarding
Pago a Meta	Tu método de pago	Tu método de pago o la factura del proveedor, según el modelo
Coexistencia con la app Business	Meta exige Solution Partner o Tech Provider	Disponible si el proveedor la ofrece
Esfuerzo técnico inicial	App, token, webhook y registro por tu cuenta	Completar el registro e integrarte con la API del proveedor

Las preguntas frecuentes de WhatsApp Business resumen la elección: el acceso directo es para empresas con desarrolladores propios, y el camino con socio sirve a quien no desarrolla o quiere conectar WhatsApp a herramientas como bandeja de entrada, CRM o chatbot.

Verificación del negocio y nombre visible

La verificación no es obligatoria para empezar, pero cambia lo que puedes hacer:

• Límite de mensajes. Los portafolios nuevos empiezan con 250 destinatarios únicos en 24 horas fuera de la ventana de atención. Verificar la empresa es uno de los caminos para llegar a 2.000 (límites de mensajes).
• Números. Los portafolios nuevos pueden registrar dos números; con verificación o al llegar al límite de 2.000, el tope sube a 20.
• Plantillas. Las cuentas de mensajería de portafolios no verificados tienen hasta 250 plantillas; las verificadas, con un nombre visible aprobado, llegan a 6.000.

El nombre visible se define en el registro y pasa por una revisión automática cuando sube el límite de mensajes. Puedes cambiarlo hasta 10 veces cada 30 días. Las reglas y los motivos de rechazo están en nombre visible en la API de WhatsApp.

Método de pago

Meta cobra por mensaje entregado, según la categoría y el país del destinatario. Desde el 1 de octubre de 2026, cada número tiene 1.000 mensajes de servicio gratis al mes, y la página de precios advierte que, sin método de pago, los mensajes de servicio dejan de entregarse después de ese nivel gratuito.

Las empresas con país de facturación Brasil pueden tener cuentas de mensajería en reales (BRL), facturadas por Facebook Brasil, la entidad local de Meta. Meta exige que esas empresas pasen todas sus cuentas a BRL antes del 30 de junio de 2027.

Bloqueos más comunes

Síntoma	Causa probable	Qué hacer
El número no acepta el registro	Sigue en WhatsApp o en la app Business	Eliminar la cuenta de la app o usar coexistencia con un proveedor
Error 133016	Más de 10 intentos de registro en 72 horas	Esperar 72 horas
Error 133010 al enviar	Número agregado, pero no registrado	Llamar a /register con el PIN
Error 200 en cuentas de clientes	App sin Advanced access	Completar la revisión de la app (solo para quien atiende a terceros)
Error 131042	Problema con el método de pago	Revisar el medio de pago de la cuenta de mensajería
Error 190	Token vencido	Cambiar el token temporal por uno de usuario del sistema

Fuentes: códigos de error y registro de números.

Cómo hacerlo con Vectalk

Con Vectalk, el acceso sigue el Camino 2, y Vectalk se encarga de la app, de los tokens de Meta y del enrutamiento de webhooks:

1. Crea tu cuenta en apps.vectalk.com.br/register.
2. En Instancias, haz clic en Conectar cuenta y completa el registro insertado. Vectalk importa el phone_number_id, el waba_id y el token de Meta.
3. En Configuración → API Tokens, genera un token de organización o de instancia.
4. Envía el primer mensaje con POST /api/messages y registra un webhook con POST /api/webhooks.

La guía rápida pide una cuenta de Meta Business verificada para conectar el número. En el cobro, tú le pagas a Vectalk y Vectalk le paga a Meta, sin tarjeta registrada en Meta. Vectalk también ofrece coexistencia para mantener el número en la app WhatsApp Business. Para ver los primeros envíos en código, lee cómo enviar un mensaje con la API de WhatsApp.

Preguntas frecuentes

¿Meta tiene que aprobar mi acceso a la API?

No existe una aprobación general para «liberar la API». Para uso propio, creas la app, registras el número y agregas el método de pago. La revisión de la app con acceso avanzado se exige a los proveedores, que acceden a cuentas de otras empresas. Lo que Meta sí revisa es tu empresa (verificación), el nombre visible y cada plantilla.

¿Puedo probar sin pagar?

Sí, con los recursos de prueba que Meta crea junto con la app: una cuenta y un número de prueba que envían plantillas sin método de pago registrado. Para producción con tu número, el método de pago pasa a ser necesario.

¿Puedo usar el número que ya tengo en el celular?

Si está en la app WhatsApp Business, sí, mediante la coexistencia, que requiere un proveedor. Si está en WhatsApp común, debes eliminar la cuenta de la app antes de registrar el número en Cloud API.

¿Cuánto tiempo lleva?

La parte técnica se puede hacer el mismo día. La verificación de la empresa, la revisión del nombre visible y la aprobación de plantillas dependen de Meta, así que conviene empezar por ellas.

¿Todavía se puede usar la API On-Premises?

No. Meta dio de baja la API On-Premises el 23 de octubre de 2025; los números solo se pueden registrar en Cloud API. Mira qué es la WhatsApp Cloud API.

---

Fuentes oficiales consultadas el 25/10/2026: Get started, About the platform, Business phone numbers, Register a business phone number, Embedded Signup, Access tokens, Messaging limits, Display names, Templates, Pricing, Error codes, Updates to WhatsApp Business accounts, On-Premises API Sunset, Preguntas frecuentes de WhatsApp Business.