A API Oficial (WhatsApp Business Platform, também chamada de Cloud API) é o WhatsApp da empresa homologado pela Meta. Diferente do QR, ela não depende de um celular ligado e permite enviar templates aprovados para quem não falou com você nas últimas 24 horas.
O que você precisa ter antes
- Uma conta comercial na Meta (Business Manager).
- Um número de telefone que não esteja ativo em outro WhatsApp — nem no app comum, nem em outra plataforma.
- Acesso ao Facebook da empresa para autorizar a conexão.
- Na Heyoo, clique em Adicionar número. Abre uma janela da própria Meta.
Na janela da Meta — fora da Heyoo
A partir daqui quem conduz é a Meta. O passo a passo é sempre este:
- Entre com o Facebook que administra a empresa.
- Escolha (ou crie na hora) a conta comercial — o Business Manager.
- Escolha (ou crie) a conta do WhatsApp Business, a WABA.
- Informe o número de telefone. Ele não pode estar ativo em nenhum outro WhatsApp.
- Confirme o código que a Meta envia por SMS ou ligação.
- Aceite as permissões solicitadas e finalize.
De volta à Heyoo: o número aparece na tabela com Phone ID e WABA ID, e o status da API fica pronto para enviar.
Ler a tabela de números
| Coluna | O que significa |
|---|---|
| Número / Phone ID | O telefone e o identificador dele na Meta. |
| WABA ID | A conta de WhatsApp Business a que o número pertence. |
| Qualidade | A nota que a Meta dá ao número (alta, média, baixa). Cai quando as pessoas bloqueiam ou denunciam. |
| Origem | Como a conexão foi feita — login embutido ou credenciais manuais. |
| Modo | Se o número está em produção ou em coexistência com o app. |
- Sincronizar perfil — puxa da Meta o nome, a foto e a descrição do número.
- Atualizar credenciais — troca o token quando ele expira ou é revogado.
- Desconectar — desliga o número da Heyoo (não apaga nada na Meta).
Qualidade em quedaSe a qualidade do número cair, a Meta reduz o seu limite de envio. Revise para quem você está disparando e a frequência antes de aumentar o volume de novo.