{"id":797,"date":"2026-10-29T13:30:04","date_gmt":"2026-10-29T13:30:04","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/encontrar-phone-number-id-whatsapp\/"},"modified":"2026-10-29T13:30:37","modified_gmt":"2026-10-29T13:30:37","slug":"encontrar-phone-number-id-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/es\/encontrar-phone-number-id-whatsapp\/","title":{"rendered":"D\u00f3nde encontrar el Phone Number ID, el WABA ID y el App ID de la API de WhatsApp"},"content":{"rendered":"\n

Actualizado el 29\/10\/2026<\/em><\/p>\n\n\n\n

El Phone Number ID<\/strong> de WhatsApp aparece en la secci\u00f3n API Setup<\/strong> 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<\/strong> est\u00e1 en la barra superior del panel de la app. Si no tienes acceso al panel, la API te da todo: GET \/debug_token<\/code> devuelve el App ID y los IDs de las cuentas de mensajes a las que llega el token, y GET \/{waba-id}\/phone_numbers<\/code> lista los n\u00fameros con sus IDs.<\/p>\n\n\n\n

Esta gu\u00eda explica qu\u00e9 identifica cada ID, d\u00f3nde encontrarlo en la interfaz de Meta, c\u00f3mo obtenerlo con la Graph API y d\u00f3nde est\u00e1 en Vectalk.<\/p>\n\n\n\n

Los tres IDs (y por qu\u00e9 no se pueden intercambiar)<\/h2>\n\n\n\n

Quien empieza con la API oficial de WhatsApp<\/a> suele confundir los IDs, porque todos son n\u00fameros largos sin prefijo. Cada uno apunta a un objeto distinto de la Graph API:<\/p>\n\n\n\n

ID<\/th>Qu\u00e9 identifica<\/th>D\u00f3nde se usa<\/th><\/tr><\/thead>
Phone Number ID<\/td>Un n\u00famero de tel\u00e9fono registrado en la Cloud API<\/td>POST \/{phone-number-id}\/messages<\/code>, multimedia, registro del n\u00famero, perfil de empresa<\/td><\/tr>
WABA ID (ID de la cuenta de mensajes)<\/td>La cuenta que guarda plantillas, facturaci\u00f3n y suscripci\u00f3n de webhooks<\/td>GET\/POST\/DELETE \/{waba-id}\/message_templates<\/code>, GET \/{waba-id}\/phone_numbers<\/code>, suscripci\u00f3n de webhooks<\/td><\/tr>
App ID<\/td>La app creada en el panel de desarrolladores de Meta<\/td>Configuraci\u00f3n de webhooks, registro insertado (Embedded Signup), depuraci\u00f3n de tokens<\/td><\/tr>
ID del portafolio empresarial<\/td>La empresa en el Business Manager<\/td>Usuarios del sistema, activos y verificaci\u00f3n de la empresa<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

El error cl\u00e1sico es poner el WABA ID en la ruta de \/messages<\/code>. La llamada falla porque ese objeto no es un n\u00famero de tel\u00e9fono. Tambi\u00e9n pasa al rev\u00e9s: intentar listar plantillas con el Phone Number ID. Si las siglas son nuevas para ti, el glosario de la API de WhatsApp<\/a> explica cada una.<\/p>\n\n\n\n

Qu\u00e9 cambi\u00f3 con la nueva estructura de la WABA<\/h3>\n\n\n\n

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

El ID de la cuenta de WhatsApp todav\u00eda no se expone: Meta lo prev\u00e9 para una nueva versi\u00f3n 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\u00e1n ese nuevo ID. Los detalles est\u00e1n en cuenta de WhatsApp vs. cuenta de mensajes<\/a>. Por eso, en este art\u00edculo, “WABA ID” e “ID de la cuenta de mensajes” son el mismo n\u00famero.<\/p>\n\n\n\n

D\u00f3nde encontrarlos en el panel de desarrolladores de Meta<\/h2>\n\n\n\n

Los pasos siguen la gu\u00eda de primeros pasos de la Cloud API<\/a>.<\/p>\n\n\n\n

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

    Si tienes m\u00e1s de un n\u00famero, revisa cu\u00e1l est\u00e1 seleccionado en From<\/strong> antes de copiar: cada n\u00famero tiene su propio Phone Number ID, y todos pueden pertenecer a la misma cuenta de mensajes.<\/p>\n\n\n\n

    App ID<\/h3>\n\n\n\n

    El App ID se genera al crear la app. La documentaci\u00f3n del panel de apps<\/a> dice que la barra superior del panel, cuando seleccionas una app, muestra el App ID y permite cambiar entre apps. La configuraci\u00f3n est\u00e1 en Settings<\/strong>, dividida en Basic<\/strong> y Advanced<\/strong>; 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.<\/p>\n\n\n\n

    D\u00f3nde encontrarlos en Business Settings<\/h2>\n\n\n\n

    Si no eres desarrollador de la app pero s\u00ed administrador de la empresa, el camino es el Business Manager. La p\u00e1gina de Meta sobre usuarios del sistema<\/a> indica:<\/p>\n\n\n\n