Tema
WhatsApp oficial (Cloud API)
Além da conexão comum por QR Code, o Bora aceita o WhatsApp Cloud API, a API oficial da Meta. É indicado para empresas que já têm conta no WhatsApp Business Platform ou que precisam de um canal oficial.
O que é preciso
Dados do app da Meta:
- ID do número de telefone
- ID da conta do WhatsApp Business (WABA)
- Token de acesso permanente (gerado como usuário do sistema no Gerenciador de Negócios da Meta)
- App secret
Só administradores podem ver e alterar as credenciais.
Passo a passo
- Em Conexões, clique em Adicionar WhatsApp e escolha o tipo WhatsApp Cloud API (oficial da Meta).
- Salve a conexão e abra-a de novo para informar as credenciais.
- Preencha os campos e clique em Conferir e salvar. O Bora testa as credenciais na Meta antes de gravar.
- Em Templates de mensagem, clique em Sincronizar com a Meta para trazer os templates aprovados.
Para trocar o token depois, preencha só o que mudou (em branco mantém o atual) e clique em Conferir e atualizar.
Janela de 24 horas e templates
No WhatsApp oficial vale a regra da Meta: depois de 24 horas da última mensagem do cliente, a empresa só pode mandar template aprovado, até o cliente responder de novo.
- No atendimento, uma barra mostra "Janela de atendimento aberta até..." ou avisa que a janela está fechada, com o botão Enviar template.
- Templates de marketing são cobrados pela Meta por mensagem entregue.
- Alguns tipos de template ainda não podem ser enviados pelo atendimento (aparecem como "não suportado").
Erros comuns
| Mensagem | O que fazer |
|---|---|
| A Meta recusou o token de acesso | Gere um token permanente de usuário do sistema e atualize |
| O app secret não corresponde ao app que gerou o token | Confira se o secret é do mesmo app |
| O token não tem acesso a essa conta (WABA) | Dê permissão ao usuário do sistema nessa conta |
| Esse ID de número não pertence à conta informada | Confira os IDs no painel da Meta |
| Esse número já está ligado a outra conexão | Use a conexão existente ou remova a outra |
| O servidor ainda não está configurado para guardar credenciais | Caso para o suporte humano |
| Esse template ainda não está aprovado pela Meta | Espere a aprovação na Meta e sincronize de novo |
| Limite de envio da Meta atingido | Aguarde e tente de novo |