Listar números disponíveis de uma WABA

GET

/api/v3/settings/channels-gateway/whatsapp/official

Consulta na Pontal Tech os números de telefone pertencentes a uma WABA
(WhatsApp Business Account). É o passo anterior ao cadastro: você escolhe aqui o
phoneNumberId que vai usar em POST /whatsapp/official.

Use pra:

Listar números que a WABA já tem provisionados na Meta

Descobrir o phoneNumberId de um número recém-comprado

Retorna a resposta da Pontal Tech como veio, sem envelope do api-core.

Requisição

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200OK

application/json

Números da WABA, conforme retornado pela Pontal Tech.

Bodyapplication/json

🟠400Pedido Inválido

🟠401Não Autorizado

🟠403Proibido

🔴500Erro Interno

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v3/settings/channels-gateway/whatsapp/official?wabaId=900000000000001' \
--header 'api-key: {{api-key}}'

Response Example

200 - Exemplo de retorno

[
    {
        "id": "700000000000001",
        "display_phone_number": "+55 11 99999-0000",
        "verified_name": "Empresa Exemplo",
        "quality_rating": "GREEN"
    }
]

Modificado em 2026-11-04 02:31:07

Página anterior

Listar conexões de WhatsApp (a tela Canais › WhatsApp oficial)

Próxima página

Criar conexão de WhatsApp oficial