Glosario de la API de WhatsApp: WABA, Phone Number ID, plantillas y más

Actualizado el 25/10/2026

Una WABA (WhatsApp Business Account) es la cuenta que, en la API oficial de WhatsApp, reunía los números, las plantillas y el cobro de una empresa. Con el nuevo modelo de cuentas de Meta, desplegado entre septiembre y octubre de 2026, se dividió en dos: la cuenta de WhatsApp, que guarda el número y la identidad de la empresa, y la cuenta de mensajería, que guarda plantillas, cobro y webhooks. El waba_id que ya usas sigue funcionando y ahora identifica la cuenta de mensajería.

Este glosario reúne más de 40 términos que aparecen en la documentación de Meta, en los payloads y en los paneles, agrupados por tema. Cada definición tiene una o dos frases y, cuando existe, un enlace al artículo que profundiza el tema.

Cuentas y activos

Término	Qué es	Dónde aparece
Portafolio comercial	Cuenta de la empresa en Meta (antes Business Manager). Contiene cuentas de WhatsApp, cuentas de mensajería, usuarios y apps. Es obligatorio.	business_id, Meta Business Suite
WABA (WhatsApp Business Account)	Cuenta que reunía números, plantillas y cobro. En el modelo nuevo, su ID identifica la cuenta de mensajería.	waba_id
Cuenta de mensajería (Messaging account)	Guarda plantillas, método de pago y suscripciones de webhook. Cada socio que atiende un mismo número tiene la suya.	waba_id, pestaña «Cuentas de mensajería»
Cuenta de WhatsApp (WAAC)	Guarda el número, el perfil comercial y, en el futuro, el nombre de usuario. Siempre es de la empresa y se puede compartir con socios.	Pestaña «Cuentas de WhatsApp»
Número de teléfono comercial	Número registrado en Cloud API para enviar y recibir mensajes. Puede ser móvil, fijo o virtual.	WhatsApp Manager
Phone Number ID	Identificador del número en la API. Va en la URL de envío. No es el número en sí.	phone_number_id, POST /<PHONE_NUMBER_ID>/messages
display_phone_number	El número con formato, tal como lo ven las personas.	Webhooks, GET /phone_numbers
wa_id	ID del usuario de WhatsApp, por lo general el número sin +. Puede no coincidir con lo que enviaste en to.	Respuesta de envío, webhooks
Nombre visible	Nombre de la empresa que aparece en el perfil y, una vez aprobado, arriba del chat. Mira nombre visible en la API.	verified_name, name_status
Perfil comercial	Dirección, sitio web, descripción, correo y categoría que se muestran en el perfil del número.	whatsapp_business_profile
Cuenta comercial oficial (OBA)	Número de una empresa verificada que obtiene una insignia azul junto al nombre.	WhatsApp Manager
Verificación del negocio	Proceso con el que Meta confirma que el portafolio pertenece a una empresa real. Habilita límites más altos.	Centro de seguridad
PIN de verificación en dos pasos	PIN de seis dígitos definido al registrar el número. Se pide para cambiar el PIN o eliminar el número de la plataforma.	POST /<PHONE_NUMBER_ID>/register
WhatsApp Manager	Panel de Meta para gestionar números, plantillas, calidad y métricas.	business.facebook.com
Billing Hub y línea de crédito	Billing Hub es donde se registra el método de pago. La línea de crédito es el crédito que un Solution Partner extiende al cliente.	Meta Business Suite

Fuentes: About the platform, Updates to WhatsApp Business accounts, Business phone numbers, Official Business Accounts.

Mensajes

Término	Qué es	Dónde aparece
Plantilla (template)	Mensaje aprobado previamente por Meta, con variables. Único tipo que se puede enviar fuera de la ventana de atención.	type: "template"
Categoría de la plantilla	Marketing, utilidad o autenticación. Define la revisión y el precio.	category
Parámetros con nombre y posicionales	Variables de la plantilla en formato {{first_name}} o {{1}}.	parameter_format
Mensaje de servicio	Mensaje libre (texto, multimedia, botones) enviado dentro de la ventana de atención.	Categoría service
Ventana de atención (24 h)	Período de 24 horas que abre cada mensaje o llamada del cliente. Fuera de ella, solo plantillas.	Error 131047
Ventana de punto de entrada gratuito (FEP)	Ventana de hasta 7 días que se abre cuando la empresa responde a quien llegó por un anuncio de clic a WhatsApp. Los mensajes en ella no se cobran.	pricing.type
Click-to-WhatsApp (CTWA)	Anuncio de Facebook o Instagram que abre un chat de WhatsApp.	Objeto referral en el webhook
wamid	ID del mensaje de WhatsApp. Vuelve en la respuesta del envío y aparece en los webhooks de estado.	messages[0].id
Mensajes interactivos	Botones de respuesta (hasta 3), listas, botón de enlace (CTA URL), solicitud de ubicación.	type: "interactive"
WhatsApp Flows	Formularios de varias pantallas dentro del chat, para reservas, registros o encuestas.	interactive.type: "flow"
Media ID	ID que devuelve la carga de un archivo, usado en lugar del enlace al enviar multimedia.	image.id, document.id
Estado del mensaje	sent, delivered, read y failed, entre otros, recibidos por webhook. Mira estados de mensaje.	Webhook statuses
Meta Business Agent	Agentes de IA de la propia Meta que atienden en WhatsApp, con categoría de precio propia.	Categoría de precio

Fuentes: Templates, Service messages, Pricing, Status webhook.

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

Límites, calidad y precio

Término	Qué es	Dónde aparece
Límite de mensajes	Cuántos destinatarios únicos alcanza el portafolio en 24 horas fuera de la ventana: 250, 2.000, 10.000, 100.000 o ilimitado. Es del portafolio, no del número.	whatsapp_business_manager_messaging_limit
Throughput (mps)	Mensajes por segundo que envía un número: 80 por defecto, hasta 1.000 con mejora automática, 20 fijo en coexistencia.	Error 130429
Calificación de calidad	Nota del número basada en bloqueos, denuncias y otras señales de los últimos 7 días.	quality_rating (p. ej. GREEN)
Límite por usuario de marketing	Tope de plantillas de marketing que cada persona recibe de todas las empresas, según su interacción.	Error 131049
Pausa de plantilla	Una plantilla de baja calidad se pausa; tras pausas repetidas, se desactiva.	Errores 132015 y 132016
Opt-in	Permiso del cliente para recibir mensajes de la empresa. Lo exige la política de WhatsApp.	Política de mensajería
Cobro por mensaje (PMP)	Modelo vigente desde el 1 de julio de 2025: Meta cobra cada mensaje entregado según categoría y país.	pricing_model: "PMP"
Objeto pricing	Bloque del webhook de estado que indica si el mensaje se cobra, su categoría y su tipo de precio.	billable, category, type

Fuentes: Messaging limits, Throughput, Error codes, Pricing.

Integración y autenticación

Término	Qué es	Dónde aparece
Cloud API	La API oficial de mensajes y llamadas de WhatsApp, alojada por Meta. Mira WhatsApp Cloud API.	graph.facebook.com
Graph API	La API HTTP de Meta sobre la que se construye Cloud API. Tiene versiones (p. ej. v26.0).	URL base
Business Management API	La parte de la plataforma que gestiona cuentas, números, plantillas y métricas.	Endpoints de WABA
Marketing Messages API	API para enviar marketing con optimizaciones que Cloud API no tiene.	Documentación de Meta
API On-Premises	Versión antigua, alojada por la empresa. Meta la dio de baja el 23 de octubre de 2025.	Documentación heredada
Webhook	URL de tu sistema que recibe mensajes y estados en JSON.	object: "whatsapp_business_account"
Verify token y hub.challenge	En la configuración, Meta hace un GET con hub.verify_token y hub.challenge; tú validas el token y devuelves el challenge.	Query string
X-Hub-Signature-256	Encabezado con el HMAC-SHA256 del cuerpo, calculado con el secreto de la app, para confirmar que el webhook vino de Meta.	Encabezado HTTP
Usuario del sistema	Usuario técnico del portafolio que representa un servicio, no una persona. Puede ser administrador o empleado.	Configuración del negocio
Token de usuario del sistema	Token de larga duración para integración directa. Mira token permanente.	Authorization: Bearer
Business token	Token limitado a un cliente, que el socio obtiene al final del registro insertado.	Flujo de socios
Registro insertado (Embedded Signup)	Ventana de Meta que crea portafolio, cuentas y número y autoriza la app de un socio.	Sitio del proveedor
App Review y Advanced access	Revisión de la app por Meta, exigida a los socios para acceder a cuentas de otras empresas. Sin ella, error 200.	Panel de apps
Coexistencia	Uso del mismo número en la app WhatsApp Business y en Cloud API.	is_on_biz_app
smb_message_echoes	Campo de webhook que avisa cuando la empresa responde desde la app en coexistencia.	Suscripción de webhook

Fuentes: About the platform, Create a webhook endpoint, Access tokens, Embedded Signup, On-Premises API Sunset.

Socios

Término	Qué es
Solution Partner (BSP)	Meta Business Partner con línea de crédito: puede facturar el uso de la API directamente al cliente.
Tech Provider	Ofrece los servicios de la plataforma sin línea de crédito; Meta cobra al cliente directamente.
Tech Partner	Tech Provider que además es Meta Business Partner.

La diferencia entre ellos se explica en qué es un BSP y un Tech Provider.

Cómo encajan los IDs en una llamada real

Un envío por Cloud API reúne varios términos de este glosario: el Phone Number ID en la URL, el token en el encabezado, el número del cliente en to y la plantilla en el cuerpo.

curl 'https://graph.facebook.com/v26.0/PHONE_NUMBER_ID/messages' \
  -H 'Authorization: Bearer TOKEN_DE_USUARIO_DEL_SISTEMA' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "to": "+5215512345678",
    "type": "template",
    "template": { "name": "recordatorio_cita", "language": { "code": "es_MX" } }
  }'

La respuesta trae el wa_id del cliente y el wamid del mensaje. Ese wamid es el que usas para relacionar los webhooks de estado con el envío. Más ejemplos en cómo enviar un mensaje con la API de WhatsApp.

Los mismos términos en Vectalk

Vectalk es un proxy de la WhatsApp Cloud API oficial: los payloads y webhooks son los de Meta, así que todo este glosario vale igual. Solo cambia el acceso. En la documentación de Vectalk, cada número conectado es una instancia, que guarda phone_number_id, waba_id, business_id y el token de Meta. Te autenticas con un token de organización, que accede a todas las instancias y exige phone_number_id en el cuerpo del envío, o con un token de instancia, que resuelve el número solo. Los detalles están en Instancias y Autenticación. Para empezar, crea tu cuenta.

Preguntas frecuentes

¿La WABA es lo mismo que la cuenta de WhatsApp Business del celular?

No. La app WhatsApp Business del celular es una cuenta de uso manual. WABA es el término de la plataforma para la cuenta que usa la API. Con la coexistencia, la cuenta de la app puede convertirse para funcionar también en la API.

¿Qué diferencia hay entre el Phone Number ID y el número de teléfono?

El número de teléfono es lo que ve el cliente, como +52 55 1234 5678. El Phone Number ID es un identificador numérico que Meta genera para ese número dentro de la API, y es el que va en la URL de envío.

¿Qué cambió con la división de la WABA?

La WABA se convirtió en dos cuentas: la cuenta de WhatsApp, con el número, y la cuenta de mensajería, con plantillas y cobro. Los IDs, endpoints y tokens anteriores siguen funcionando. La novedad principal es que un número puede compartirse con varios socios, cada uno con su cuenta de mensajería.

¿El wa_id siempre es igual al número que envié?

No necesariamente. Meta advierte que el wa_id puede no coincidir con el valor enviado en to. En Brasil y México, la API puede ajustar el prefijo del número. Guarda el wa_id que devuelve la API como identificador del contacto.

---

Fuentes oficiales consultadas el 25/10/2026: About the platform, Updates to WhatsApp Business accounts, Business phone numbers, Display names, Official Business Accounts, Templates, Service messages, Status webhook, Messaging limits, Throughput, Pricing, Error codes, Access tokens, Create a webhook endpoint, Embedded Signup, Partners, On-Premises API Sunset.