Números de teléfono

Last update: 4 days ago by Irais Aguirre

Resumen para integración
URL base: https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services
Token: de administración, en el encabezado Authorization: Bearer {{admin-token}} (cómo generarlo)
Endpoints en esta página:
GET /v1/wba/{{waba_id}}/phone_numbers: Listar números de teléfono de la WABA
GET /v1/wba/{{waba_id}}/phone-numbers-status: Consultar calidad de números de teléfono

Lista los números de teléfono de tu WABA y consulta la calificación de calidad de cada uno.

Listar números de teléfono de la WABA

Petición

Petición de Listar números de teléfono de la WABA:


URL	https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/wba/{{waba_id}}/phone_numbers
Método	GET

Encabezados

Encabezados de Listar números de teléfono de la WABA:

Nombre	Descripción	Tipo	Requerimientos
Authorization	Token de administración. Consulta Generar Token de Autenticación.	String	Obligatorio

Parámetros

Parámetros de Listar números de teléfono de la WABA:

Nombre	Descripción	Tipo	Requerimientos
waba_id	ID de la cuenta de WhatsApp Business.	String	Obligatorio

Ejemplo

Ejemplo completo de Listar números de teléfono de la WABA:

curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/wba/{{waba_id}}/phone_numbers' \
--header 'Authorization: Bearer {{admin-token}}'

Respuesta

Respuesta de Listar números de teléfono de la WABA:

Nombre	Descripción	Tipo
-	Lista con los números de teléfono (phone_number_id) de la WABA. Son los valores que piden otros endpoints de administración, como Bloqueo de usuarios.	Array

[
    "5215500000001",
    "5215500000002"
]

Consultar calidad de números de teléfono

Petición

Petición de Consultar calidad de números de teléfono:


URL	https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/wba/{{waba_id}}/phone-numbers-status
Método	GET

Encabezados

Encabezados de Consultar calidad de números de teléfono:

Nombre	Descripción	Tipo	Requerimientos
Authorization	Token de administración. Consulta Generar Token de Autenticación.	String	Obligatorio

Parámetros

Parámetros de Consultar calidad de números de teléfono:

Nombre	Descripción	Tipo	Requerimientos
waba_id	ID de la cuenta de WhatsApp Business.	String	Obligatorio

Ejemplo

Ejemplo completo de Consultar calidad de números de teléfono:

curl --location 'https://{{url}}/whatsapp-bsp-admin-ext-endpoint-ws/services/v1/wba/{{waba_id}}/phone-numbers-status' \
--header 'Authorization: Bearer {{admin-token}}'

Respuesta

Respuesta de Consultar calidad de números de teléfono:

Nombre	Descripción	Tipo
data	Lista con la calidad de cada número de teléfono de la WABA.	Array
wabaId	ID de la WABA.	String
fbPhoneNumberId	ID del número de teléfono en Meta.	String
displayPhoneNumber	Número de teléfono.	String
qualityRating	Calificación de calidad del número. Los valores pueden ser: GREEN YELLOW RED UNKNOWN	String
status	Estado del número en Meta, alineado con su calidad. Por ejemplo, CONNECTED.	String
messagingLimitTier	Nivel de límite de mensajes del número. Por ejemplo, TIER_1K.	String
processedAt	Fecha y hora en que se obtuvo la información de Meta; a partir de ella cuenta el periodo de 12 horas.	String (fecha ISO 8601)

{
    "data": [
        {
            "wabaId": "173276950931742",
            "fbPhoneNumberId": "101422592747549",
            "displayPhoneNumber": "+57 310 6576307",
            "qualityRating": "GREEN",
            "status": "CONNECTED",
            "messagingLimitTier": "TIER_1K",
            "processedAt": "2025-07-25T00:40:20.236Z"
        },
        {
            "wabaId": "173276950931742",
            "fbPhoneNumberId": "105303135793776",
            "displayPhoneNumber": "+52 1 649 118 0000",
            "qualityRating": "GREEN",
            "status": "CONNECTED",
            "messagingLimitTier": "TIER_1K",
            "processedAt": "2025-07-25T00:40:20.235Z"
        }
    ]
}

Whatsapp — Anterior

Semaforización

Plantillas