Sign inGet Started

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.
A página Numbers do WhatsApp no Bird, mostrando o status dos números e suas contas comerciais

Verificar o status de conexão

StatusO que fazer
PreparingAguarde enquanto Bird verifica um número que seu espaço de trabalho possui.
Pre-verifiedSelecione Finish setting up para conectá-lo pelo Meta.
PendingAguarde enquanto Bird registra o número no Meta.
ConnectedSeu número está pronto para enviar.
FailedAbra 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.
Um número WhatsApp conectado no Bird, com sua classificação de qualidade, limite de mensagens, taxa de envio e aba Business profile
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.
Uma WhatsApp Business Account no Bird, com seu status de revisão, verificação comercial e detalhes da conta
  • 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);
}
Consulte um número para ver seu status, classificação de qualidade e limites de envio. Leituras relacionadas incluem:
EndpointRetorna
Perfil do númeroDescrição, endereço e sites.
Eventos do númeroAlterações de configuração, status, qualidade, limite e nome de exibição, do mais recente ao mais antigo.
Contas comerciaisAs WhatsApp Business Accounts do espaço de trabalho.
Detalhes da conta comercialRevisã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