Crear cuenta
← Blog

·

Dónde encontrar el Phone Number ID, el WABA ID y el App ID de la API de WhatsApp

Actualizado el 29/10/2026

El Phone Number ID de WhatsApp aparece en la sección API Setup de tu app en el panel de desarrolladores de Meta, junto al ID de la cuenta de mensajes (el antiguo WABA ID); el App ID está en la barra superior del panel de la app. Si no tienes acceso al panel, la API te da todo: GET /debug_token devuelve el App ID y los IDs de las cuentas de mensajes a las que llega el token, y GET /{waba-id}/phone_numbers lista los números con sus IDs.

Esta guía explica qué identifica cada ID, dónde encontrarlo en la interfaz de Meta, cómo obtenerlo con la Graph API y dónde está en Vectalk.

Los tres IDs (y por qué no se pueden intercambiar)

Quien empieza con la API oficial de WhatsApp suele confundir los IDs, porque todos son números largos sin prefijo. Cada uno apunta a un objeto distinto de la Graph API:

IDQué identificaDónde se usa
Phone Number IDUn número de teléfono registrado en la Cloud APIPOST /{phone-number-id}/messages, multimedia, registro del número, perfil de empresa
WABA ID (ID de la cuenta de mensajes)La cuenta que guarda plantillas, facturación y suscripción de webhooksGET/POST/DELETE /{waba-id}/message_templates, GET /{waba-id}/phone_numbers, suscripción de webhooks
App IDLa app creada en el panel de desarrolladores de MetaConfiguración de webhooks, registro insertado (Embedded Signup), depuración de tokens
ID del portafolio empresarialLa empresa en el Business ManagerUsuarios del sistema, activos y verificación de la empresa

El error clásico es poner el WABA ID en la ruta de /messages. La llamada falla porque ese objeto no es un número de teléfono. También pasa al revés: intentar listar plantillas con el Phone Number ID. Si las siglas son nuevas para ti, el glosario de la API de WhatsApp explica cada una.

Qué cambió con la nueva estructura de la WABA

Desde el 23/09/2026, Meta separa la WABA en dos cuentas (la migración fue escalonada y, según el cronograma de Meta, llega a todas las empresas a mediados de octubre de 2026): la cuenta de WhatsApp, que guarda el número y el perfil, y la cuenta de mensajes, que guarda plantillas, facturación y webhooks. Según la página de actualizaciones de las cuentas de WhatsApp Business, los WABA IDs existentes no cambian y pasan a designar el ID de la cuenta de mensajes. Los Phone Number IDs también siguen funcionando en todas las APIs.

El ID de la cuenta de WhatsApp todavía no se expone: Meta lo prevé para una nueva versión de la Graph API en el primer semestre de 2027, y solo a partir de la fase 3 (primer semestre de 2028) las rutas que hoy reciben el Phone Number ID en el camino exigirán ese nuevo ID. Los detalles están en cuenta de WhatsApp vs. cuenta de mensajes. Por eso, en este artículo, «WABA ID» e «ID de la cuenta de mensajes» son el mismo número.

Dónde encontrarlos en el panel de desarrolladores de Meta

Los pasos siguen la guía de primeros pasos de la Cloud API.

  1. Entra a developers.facebook.com/apps y abre la app que usa el caso de uso de WhatsApp.
  2. Abre API Setup en el menú lateral (al crear la app llegas a Customize use case > Connect on WhatsApp > Quickstart, y API Setup está en el menú de la izquierda).
  3. Cuando la app ya está conectada a una cuenta de mensajes, el ID de la cuenta de mensajes aparece en el panel API Setup.
  4. En el mismo panel eliges el número en el campo From para enviar un mensaje de prueba. La guía de Meta pide guardar el phone number ID y el ID de la cuenta de mensajes de este paso para usarlos después.

Si tienes más de un número, revisa cuál está seleccionado en From antes de copiar: cada número tiene su propio Phone Number ID, y todos pueden pertenecer a la misma cuenta de mensajes.

App ID

El App ID se genera al crear la app. La documentación del panel de apps dice que la barra superior del panel, cuando seleccionas una app, muestra el App ID y permite cambiar entre apps. La configuración está en Settings, dividida en Basic y Advanced; en Basic encuentras el App Secret, que se usa para validar la firma de los webhooks. El App ID puede aparecer en el front-end (en el registro insertado, por ejemplo); el App Secret, nunca.

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

Dónde encontrarlos en Business Settings

Si no eres desarrollador de la app pero sí administrador de la empresa, el camino es el Business Manager. La página de Meta sobre usuarios del sistema indica:

  • ID de la cuenta de mensajes (WABA ID): Business Settings > Accounts > WhatsApp Business Accounts. Selecciona la cuenta y el panel de detalles muestra el ID.
  • ID del portafolio empresarial: Business Settings > Business Info.

Después de la migración, Meta informa que el menú Accounts de Meta Business Suite pasa a tener dos pestañas, WhatsApp Accounts y Messaging Accounts, en lugar de la vista única de WABA; el ID de la cuenta de mensajes está en la pestaña Messaging Accounts. Recuerda que el ID que aparece en la URL del Business Manager es el del portafolio que estás usando, no necesariamente el dueño de la cuenta de WhatsApp.

Cómo obtener los IDs por API

Cuando solo tienes un token (de un cliente, de un colega o de un registro insertado), la API es la forma más confiable de descubrir los IDs. Los ejemplos usan la versión v26.0 de la Graph API, la de los ejemplos actuales de Meta.

1. App ID y WABA ID con debug_token

El endpoint debug_token inspecciona un token. Según la referencia de debug_token, la respuesta incluye app_id, application, is_valid, expires_at, scopes y granular_scopes, entre otros. Para llamarlo, usa un token de app o un token de usuario del desarrollador de la app; en el flujo de socios, Meta envía el token del usuario del sistema en el encabezado.

curl -G "https://graph.facebook.com/v26.0/debug_token" \
  --data-urlencode "input_token=TOKEN_A_INSPECCIONAR" \
  -H "Authorization: Bearer TOKEN_DEL_USUARIO_DEL_SISTEMA"

Respuesta resumida (valores de ejemplo):

{
  "data": {
    "app_id": "670843887433847",
    "application": "Mi Integración",
    "is_valid": true,
    "scopes": ["whatsapp_business_management", "whatsapp_business_messaging"],
    "granular_scopes": [
      {
        "scope": "whatsapp_business_management",
        "target_ids": ["102289599326934"]
      },
      {
        "scope": "whatsapp_business_messaging",
        "target_ids": ["102289599326934"]
      }
    ]
  }
}

app_id es el App ID. En granular_scopes, los target_ids del alcance whatsapp_business_management son los IDs de las cuentas de mensajes que dieron ese permiso a la app. La página de gestión de cuentas para socios explica que las cuentas incorporadas más recientemente aparecen primero, así que justo después de un registro insertado el primer ID de la lista es el de la cuenta recién compartida.

2. Phone Number IDs con /phone_numbers

Con el WABA ID, lista los números de la cuenta, como muestra la documentación de números de teléfono:

curl "https://graph.facebook.com/v26.0/102289599326934/phone_numbers" \
  -H "Authorization: Bearer TU_TOKEN"
{
  "data": [
    {
      "verified_name": "Tienda Ejemplo",
      "display_phone_number": "+52 55 5000 0000",
      "id": "1906385232743451",
      "quality_rating": "GREEN"
    }
  ]
}

El id de cada elemento es el Phone Number ID. display_phone_number ayuda a saber cuál es cuál cuando la cuenta tiene varios números, y quality_rating muestra la calidad del número.

3. Revisar un número específico

Si ya tienes un Phone Number ID y quieres confirmar a qué número corresponde:

curl "https://graph.facebook.com/v26.0/1906385232743451" \
  -H "Authorization: Bearer TU_TOKEN"

La respuesta trae display_phone_number, verified_name, quality_rating, code_verification_status y el propio id.

4. Desde el webhook

Los IDs también llegan en cada evento. En un webhook de mensaje, entry[].id es el WABA ID (ahora, el ID de la cuenta de mensajes) y value.metadata.phone_number_id es el Phone Number ID del número que recibió el mensaje. Sirve para enrutar eventos cuando un mismo endpoint atiende varios números.

{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "102289599326934",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "525550000000",
          "phone_number_id": "1906385232743451"
        }
      }
    }]
  }]
}

Errores comunes con los IDs

  • WABA ID en lugar del Phone Number ID en /messages: la llamada falla porque ese objeto no admite la operación. Consulta GET /{id} para ver qué representa ese ID.
  • Phone Number ID del número de prueba en producción: el número de prueba de API Setup tiene su propio ID. Al pasar al número real, cambia el ID en tu configuración.
  • Token sin acceso al activo: el ID es correcto, pero el token (de otra app o de un usuario del sistema sin el activo asignado) no ve la cuenta. Genera un token permanente con usuario del sistema con los activos correctos.
  • ID del portafolio confundido con el WABA ID: el ID de la URL del Business Manager es del portafolio.

Los códigos de error de cada caso están en errores de la API de WhatsApp. Para probar estas llamadas sin escribir código, mira cómo probar la API de WhatsApp en Postman.

Dónde ver los IDs en Vectalk

En Vectalk, cada número conectado se convierte en una instancia. Al conectar la cuenta con el registro insertado en Instancias → Conectar cuenta, la plataforma importa el phone_number_id, el waba_id y el token de acceso, como describe la guía rápida. Según la documentación de instancias, cada instancia reúne phone_number_id, waba_id (con la nueva estructura, el ID de la cuenta de mensajes), business_id y el token, que gestiona Vectalk.

En el panel, la pantalla de instancias muestra el perfil y los IDs del número, además de webhooks, API keys y el envío de mensaje de prueba. Por API, con un token de instancia:

# Datos del número de la instancia (el Phone Number ID se resuelve por el token)
curl "https://apis.vectalk.com.br/api/phone-numbers?fields=id,display_phone_number,verified_name,quality_rating" \
  -H "Authorization: Bearer TU_TOKEN_DE_INSTANCIA"

# Todos los números de la cuenta de mensajes (el WABA ID se resuelve por el token)
curl "https://apis.vectalk.com.br/api/phone-numbers/list" \
  -H "Authorization: Bearer TU_TOKEN_DE_INSTANCIA"

Las dos rutas están en Obtener número y Listar números de la WABA (documentación en portugués). Con token de instancia ni siquiera necesitas pasar el Phone Number ID para enviar mensajes; con token de organización, incluye phone_number_id en el cuerpo, como explica la página de autenticación. Lo mismo vale para enviar plantillas. Para empezar, crea tu cuenta en apps.vectalk.com.br/register.

Preguntas frecuentes

¿El Phone Number ID es el número de teléfono?

No. Es un identificador interno de Meta para ese número en la Cloud API. El número en sí aparece en display_phone_number. En el campo to de los mensajes usas el teléfono del destinatario; en la ruta de la URL, el Phone Number ID del remitente.

¿Cambió mi WABA ID con la nueva estructura de cuentas?

No. Meta informa que los WABA IDs existentes no cambian y pasan a designar el ID de la cuenta de mensajes. El ID de la cuenta de WhatsApp solo se expondrá en una nueva versión de la Graph API prevista para 2027.

¿Dónde está el App Secret?

En Settings > Basic del panel de la app. Sirve para validar la firma de los webhooks y nunca debe ir al front-end ni al repositorio.

¿Puedo descubrir el WABA ID solo con el token?

Sí. Llama a GET /debug_token con el token en input_token y lee los target_ids del alcance whatsapp_business_management. Después usa GET /{waba-id}/phone_numbers para llegar a los Phone Number IDs.

¿Un número puede tener dos Phone Number IDs?

La documentación no indica eso: cada número tiene un Phone Number ID. Lo que cambia en el nuevo modelo es que un mismo número puede estar vinculado a más de una cuenta de mensajes, cada una con su ID. Si empiezas de cero, mira cómo obtener acceso a la API de WhatsApp.

Fuentes oficiales consultadas el 29/10/2026: Get started (Meta), Phone numbers (Meta), Manage accounts para socios (Meta), Usuarios del sistema (Meta), Actualizaciones de las cuentas de WhatsApp Business (Meta), Debug Token (Graph API), Panel de apps (Meta), Instancias (Vectalk), Números de teléfono (Vectalk).

Pon a funcionar el WhatsApp oficial de tu empresa

Crea tu cuenta, conecta tu número a la API oficial (puedes mantener la app con coexistencia) y empieza a atender y enviar mensajes.

Crear cuenta gratis
Leer la documentación