WABA y Phone Number ID: endpoints WhatsApp API

El número visible en formato E.164 no sustituye al Phone Number ID. Los endpoints administrativos y de mensajería se construyen con IDs de Graph API. Conserva un inventario por empresa.

Listar números de una WABA

GET https://graph.facebook.com/{VERSION}/{WABA_ID}/phone_numbers
Authorization: Bearer {ACCESS_TOKEN}

La respuesta puede incluir verified_name, display_phone_number, id y quality_rating. Guarda el id como Phone Number ID.

Registrar el número

POST https://graph.facebook.com/{VERSION}/{PHONE_NUMBER_ID}/register
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "pin": "654321"
}

El PIN de seis dígitos forma parte de la verificación en dos pasos documentada. No uses valores de ejemplo en producción y protege el procedimiento de recuperación.

Suscribir la aplicación a la WABA

POST https://graph.facebook.com/{VERSION}/{WABA_ID}/subscribed_apps
Authorization: Bearer {ACCESS_TOKEN}

Este paso es crítico para que los eventos de los números bajo la cuenta lleguen al webhook configurado. Si envías mensajes correctamente pero no recibes entradas/estados, revisa tanto la configuración de Webhooks de la app como la suscripción de la WABA.

Modelo interno recomendado

wa_accounts
- tenant_id
- business_portfolio_id
- waba_id
- phone_number_id
- display_phone_number
- verified_name
- status
- graph_version
- credential_reference

Guarda una referencia al secreto, no el token en texto visible en tablas de soporte. Añade auditoría para cambios de WABA, número o credencial.

¿Tu empresa no necesita desarrollar esto?

Optimify ya integra la capa empresarial sobre WhatsApp API

Esta sección existe para equipos que realmente quieren construir o integrar. Si la empresa solo necesita CRM, multiagente, campañas, automatización e IA, MensajAPI recomienda comparar el costo de desarrollo y mantenimiento frente a usar Optimify, que ofrece una plataforma lista y soporte en español.

Ver alternativa gestionada con Optimify

Documentación oficial para mantener la integración actualizada

Versionado: los ejemplos usan {VERSION} en lugar de fijar una versión de Graph API. Sustituye esa variable por una versión vigente y soportada en tu aplicación y revisa cambios antes de actualizar producción.

WABA, Phone Number ID y registro de números en WhatsApp API