Gerenciando números WhatsApp
Acesse Numbers para ver seus números WhatsApp, o status de conexão e as contas comerciais. Para adicionar um número, siga Conectar seu número.

Verificar o status de conexão
| Status | O que fazer |
|---|---|
| Preparing | Aguarde enquanto Bird verifica um número que seu espaço de trabalho possui. |
| Pre-verified | Selecione Finish setting up para conectá-lo pelo Meta. |
| Pending | Aguarde enquanto Bird registra o número no Meta. |
| Connected | Seu número está pronto para enviar. |
| Failed | Abra o número para verificar o motivo da falha. |
Para verification_code_not_received ou verification_rate_limited, selecione Try again na página do número. Veja falhas de pré-verificação para o tempo de nova tentativa. Para outras falhas de configuração, desconecte o número com falha antes de conectá-lo novamente.
Revisar um número conectado
Abra um número para ver seu Quality rating, Messaging limit e Send rate. Esses valores vêm do Meta. Not rated significa que o Meta ainda não tem histórico suficiente para pontuar o número.

Use Business profile para atualizar o nome de exibição, descrição, endereço e foto de perfil que os destinatários veem. A seção Activity mostra a atividade de envio.
Revisar a conta comercial
Selecione a conta na coluna WABA para revisar a WhatsApp Business Account proprietária do número.

- Business verification afeta o acesso a recursos como seus próprios templates de autenticação.
- Marketing Messages API mostra se o Meta aceitou a conta para suas otimizações de entrega de marketing. Mensagens de marketing podem ser enviadas antes do onboarding, mas cabeçalhos GIF exigem isso.
- Last read from WhatsApp mostra quando Bird atualizou esses detalhes pela última vez.
Um espaço de trabalho pode ter várias contas comerciais. Verifique a conta vinculada ao número pelo qual você pretende enviar.
Leia seus números pela API
Use uma chave API com acesso de leitura a whatsapp_management. Listar números retorna uma página dos seus números com paginação por cursor:
for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
console.log(number.id, number.phone_number, number.status);
}for number in client.whatsapp.numbers.list(limit=25):
print(number.id, number.phone_number, number.status)for number, err := range client.Whatsapp.Numbers.List(ctx, bird.WhatsappNumbersListParams{Limit: 25}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(number.Id, number.PhoneNumber, number.Status)
}foreach ($bird->whatsapp->numbers->list() as $number) {
echo $number->getId(), ' ', $number->getPhoneNumber(), ' ', $number->getStatus(), PHP_EOL;
}curl -sS "https://us1.platform.bird.com/v1/whatsapp/numbers?limit=25" \
-H "Authorization: Bearer $BIRD_API_KEY"Consulte um número para ver seu status, classificação de qualidade e limites de envio. Leituras relacionadas incluem:
| Endpoint | Retorna |
|---|---|
| Perfil do número | Descrição, endereço e sites. |
| Eventos do número | Alterações de configuração, status, qualidade, limite e nome de exibição, do mais recente ao mais antigo. |
| Contas comerciais | As WhatsApp Business Accounts do espaço de trabalho. |
| Detalhes da conta comercial | Revisão da conta, verificação comercial, onboarding de marketing e status de integridade do Meta. |
meta_synced_at indica a data da última leitura dos valores no Meta. Está ausente em números padrão. meta_health_status está ausente até que Bird tenha lido a conta. O waba de um número contém o ID da conta no Meta.
Durante a configuração, status pode ser preparing ou awaiting_signup. O campo next descreve a próxima ação, e finish_setup_url abre a etapa no navegador. O type do evento é um enum aberto, portanto trate valores desconhecidos sem falhar.
Use o dashboard ou CLI para conectar, renomear ou desconectar um número; essas ações não fazem parte da API pública nem dos SDKs. Os comandos CLI são bird whatsapp numbers create|update|delete e bird whatsapp numbers profile update. Criar uma conexão retorna finish_setup_url porque a etapa de consentimento do Meta exige um navegador.
Receber mensagens
Mensagens para seus números conectados aparecem no log WhatsApp. As métricas Inbound mostram o volume recebido por número. Cada mensagem recebida abre a janela de atendimento ao cliente de 24 horas para respostas livres.
Opções de número
Para um número que seu espaço de trabalho possui em Bird, Conectar seu número mostra a verificação automática e a configuração do Meta. Para um número em outro provedor, escolha I have my own number e receba o SMS ou código de voz do Meta você mesmo. Use o caminho de migração compatível ou de coexistência de Business app elegível para um registro existente. Insira um Phone registration PIN apenas se o número já tiver um em WhatsApp.
Números padrão enviam templates compatíveis sem a necessidade de conectar seu próprio número.
Próximos passos
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaConnecting WhatsApp to Bird: from buying a number to a live channelEntenda o conceitoWhat is the 24-hour customer service window on WhatsApp?Use a ferramentaWhatsApp message builderExplore a funcionalidadeWhatsApp
Experimente na prática e obtenha um resumo de implementação