← Voltar às documentações

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

  1. Uma conta Meta Business (business.facebook.com).
  2. Um aplicativo em developers.facebook.com com o produto WhatsApp adicionado.
  3. Uma conta do WhatsApp Business com um número registrado (a Meta confirma por SMS ou ligação).
  4. 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

  1. Em Canais, crie um canal do tipo WhatsApp API oficial Meta.
  2. Preencha o identificador do número, o identificador da conta, a chave de acesso e o segredo do aplicativo.
  3. 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.
  4. Salve e ative o canal.
  5. Use Verificar conexão para conferir a chave e o número.
  6. Use Testar envio real para mandar uma mensagem a um número permitido pela Meta. Esse teste não aciona o bot.
  7. 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

  1. Prepare a conta Meta Business, o aplicativo, a conta do WhatsApp Business e o número.
  2. Crie o canal no OSBChat e ligue a Meta ao endereço de retorno com a mesma senha de verificação.
  3. Verifique a conexão, faça o teste de envio e vincule um bot.
  4. Teste recebendo e respondendo uma mensagem.
  5. Use templates aprovados para iniciar conversas fora do prazo de 24 horas.