Pular para o conteúdo principal
GET
Status e limites do número
Retorna os números da conta com o status de conexão, a classificação de qualidade e o limite de mensagens em vigor. É a consulta usada para verificar se o número está apto a enviar mensagens e quantos destinatários ele alcança por dia.

Campos

Os campos são selecionados pelo parâmetro fields. Sem ele, a Meta retorna um conjunto reduzido, que não inclui status nem o limite de mensagens.
O campo messaging_limit_tier foi descontinuado pela Meta e substituído por whatsapp_business_manager_messaging_limit. Requisições que utilizam o nome antigo retornam apenas o id, sem o limite.

Limite de mensagens

O limite define quantos destinatários distintos o número pode alcançar em um período móvel de 24 horas, considerando apenas conversas iniciadas pela empresa. O aumento de nível depende da verificação da empresa e do volume de mensagens entregues com qualidade alta. As regras estão em limites de mensagens da Meta.

Consultar um número específico

Para consultar apenas um número, use o phone_number_id diretamente:

Saúde do número

O campo health_status informa se o número está apto a enviar mensagens e, quando não está, qual entidade impede o envio:
O campo can_send_message assume AVAILABLE, LIMITED ou BLOCKED, e é informado tanto no resultado geral quanto em cada entidade: o número, a conta do WhatsApp Business, o portfólio comercial e o aplicativo. Quando há restrição, errors e additional_info descrevem a causa e a solução.
A entidade APP refere-se ao aplicativo da Datafy, responsável pela conexão com a Meta.

Autorizações

Authorization
string
header
obrigatório

Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.

Parâmetros de caminho

waba_id
string
obrigatório

ID da conta do WhatsApp Business. Descubra com GET /me.

Parâmetros de consulta

fields
string

Campos retornados, separados por vírgula.

Resposta

Números da conta.