Como configurar o WhatsApp
Guia para conectar o WhatsApp oficial da Meta ao OSBChat, com testes, mensagens fora do prazo e custos.
Você pode conectar o WhatsApp de duas formas: pela conta oficial do WhatsApp Business (Meta), recomendada para operação de verdade, ou pelo seu aparelho, lendo um QR Code no aplicativo do WhatsApp, o que é bom para testes rápidos com o seu próprio celular. Este guia explica a conta oficial. Para uma visão geral dos canais, veja Canais — o que são e quais temos.
A conta oficial usa um número dedicado vinculado a uma conta do WhatsApp Business na Meta. Ela não usa o WhatsApp pessoal.
O que você precisa
- Uma conta Meta Business (business.facebook.com).
- Um aplicativo em developers.facebook.com com o produto WhatsApp adicionado.
- Uma conta do WhatsApp Business com um número registrado (a Meta confirma por SMS ou ligação).
- Uma chave de acesso com permissão para mensagens do WhatsApp, gerada na Meta.
Sobre o número:
- Pode ser um número novo, só para esse fim.
- Se o número já foi usado no aplicativo do WhatsApp, é preciso migrá-lo seguindo o processo oficial da Meta: o mesmo número não funciona ao mesmo tempo no aplicativo e na conta oficial.
Passo a passo
1. Prepare o aplicativo e o número na Meta
- Crie o aplicativo e adicione o produto WhatsApp.
- Registre o número e anote o identificador da conta do WhatsApp Business e o identificador do número. Atenção: o identificador do número não é o telefone que aparece para o cliente.
- Gere a chave de acesso e guarde-a em local seguro.
2. Crie o canal no OSBChat
- Em Canais, crie um canal do tipo WhatsApp API oficial Meta.
- Preencha o identificador do número, o identificador da conta, a chave de acesso e o segredo do aplicativo.
- A tela mostra o endereço de retorno e permite definir uma senha de verificação. Copie o endereço e use a mesma senha no aplicativo da Meta, no menu de configuração de mensagens recebidas, para que a Meta envie as mensagens ao OSBChat.
- Salve e ative o canal.
- Use Verificar conexão para conferir a chave e o número.
- Use Testar envio real para mandar uma mensagem a um número permitido pela Meta. Esse teste não aciona o bot.
- Vincule um bot ao canal.
3. Teste do começo ao fim
- Envie uma mensagem de texto do seu celular para o número do WhatsApp Business.
- A conversa deve aparecer em Conversas.
- Responda pelo painel e confira que a mensagem enviada aparece no histórico. O painel também mostra se ela foi enviada, entregue, lida ou se falhou, quando a Meta informa.
Testando antes de ir para produção
Enquanto o aplicativo está em modo de teste, a Meta oferece um número de teste e pede que você cadastre até 5 números que podem receber mensagens. Mensagens para números fora dessa lista costumam ser bloqueadas. Isso é normal e serve para você validar o envio e o recebimento com segurança antes de usar seu número de verdade.
Prazo de 24 horas e templates
- Quando o cliente escreve primeiro, você pode responder livremente por até 24 horas depois da última mensagem dele.
- Para começar uma conversa ou retomá-la depois desse prazo, o WhatsApp exige um template aprovado no WhatsApp Manager.
Veja Templates do WhatsApp na Meta — utilidade e marketing e a tabela de preços oficial.
Campanhas e custos
Ao criar uma campanha pelo WhatsApp oficial, o OSBChat pode mostrar uma estimativa do custo. O valor final é sempre o da fatura da Meta. Veja Campanhas no painel.
Uma dica sobre o histórico
Se você também responde pelo aplicativo WhatsApp Business no celular, essas mensagens aparecem no histórico. Para manter tudo claro e evitar respostas duplicadas, concentre o atendimento no painel do OSBChat.
Resumo
- Prepare a conta Meta Business, o aplicativo, a conta do WhatsApp Business e o número.
- Crie o canal no OSBChat e ligue a Meta ao endereço de retorno com a mesma senha de verificação.
- Verifique a conexão, faça o teste de envio e vincule um bot.
- Teste recebendo e respondendo uma mensagem.
- Use templates aprovados para iniciar conversas fora do prazo de 24 horas.