Whatsapp Cloud (API Oficial)
Premissas para fazer a conexão com o WhatsApp API Cloud
Ter uma conta no facebook
Ter uma conta em https://business.facebook.com/
Ter uma conta em https://developers.facebook.com/
Ter um número de telefone para receber SMS de validação da Meta (pode ser antigo, desde que desvincule o whatsapp dele)
Ter uma conta e agente na Zaia
Passo a passo simplificado(checklist)
Criar um app na em https://developers.facebook.com/ com a função "Outros"
No app, adicionar/vincular um número de telefone
No app, copiar o ID do número do telefone (aqui, antes de copiar o ID, é importante garantir que você selecionou o número certo, pois a Meta deixa exposto todos que você tiver. Quase pegadinha)
Na BM , criar um "usuário do sistema" (token permanente) com a função admin
Na BM , no menu lateral, clicar em "apps"
Na BM , selecionar o app que você está trabalhando e clicar em "atribuir/add pessoa", selecionar o usuário do sistema e dar todas permissões
Ir na Zaia, em Onde Usar -> WhatsApp API Cloud e inserir o token permanente + o ID do telefone
Na Zaia, copiar o webhook e token gerado
No app, em developers.facebook, dentro da configuração do app, ir em webhooks e inserir o link gerado pela Zaia como URL de redirecionamento e o token como validação
No app, em webhooks, após o passo 9, "assinar" o evento "messages"
Garantir que tem um meio de pagamento vinculado ao app
Fim.
Passo a passo detalhado
Antes de tudo, é importante saber que este tutorial explica como integrar seu agente ao WhatsApp utilizando a API Oficial. Se você está buscando uma forma mais rápida e simples, pode fazer a integração via QR code. Para aprender como, clique aqui.
Para começar, lembre-se que para esta integração você já deve ter criado uma contra empresarial na Meta. Você pode fazer isso clicando nesse link.
Também temos um tutorial completo no Zaia Academy sobre a configuração da API oficial do Whatsapp. Clique aqui para acessar. E um outro vídeo alternativo aqui.
Com a conta criada, siga esses passos: seu aplicativo comercial. Feito isso, siga os passos:
1.Selecione seu aplicativo.
2.Na barra lateral esquerda, selecione a opção “Painel”.
3.Na seção “Adicionar produtos ao seu aplicativo”, escolha “WhatsApp”. Se você já ativou a opção “WhatsApp” na barra lateral esquerda, pule para o passo 5.
4.Crie ou selecione uma conta comercial.
5.Se você não possui um número de telefone configurado na Meta, siga o guia passo a passo fornecido.
6.Após configurar o número, no canto superior esquerdo, clique em “Painel de Apps” e selecione a opção “Config. do negócio”.
7.Na categoria"Usuários”, clique em "Pessoas
” e vá em ”Editar permissões do portfólio empresarial
" no seu usuário
.
Pessoas
” e vá em ”Editar permissões do portfólio empresarial
" no seu usuário
.8.Garanta que seu usuário tenha permissão para ”Apps e integrações
”, para isso habilite a opção mencionada.
Apps e integrações
”, para isso habilite a opção mencionada.9.Na categoria “Usuários
”, clique em “Usuários do sistema
”.
Usuários
”, clique em “Usuários do sistema
”.10.Se você não possui um usuário Administrador
criado, crie um com a função de Administrador
e clique em Gerar novo token.
Administrador
criado, crie um com a função de Administrador
e clique em Gerar novo token.
11.Ao clicar em Gerar novo token
selecione o Aplicativo que foi criado.
12.Selecione todas as opções relacionadas ao WhatsApp Business
e clique em “Gerar token”.
WhatsApp Business
e clique em “Gerar token”.13.Copie e salve o token exibido (ele não será armazenado pela Meta
).
ele não será armazenado pela Meta
).14.Com o token permanente copiado, cole-o no campo “Token Permanente” da Zaia.
15.Volte para “Configuração API” e copie a “Identificação do número de telefone”.
16.Cole-o no campo “Número de identificação do telefone” e clique em “Gerar token”.
17.Depois que os dados forem gerados, copie o URL de retorno de chamada.
18. Na Meta, selecione na aba da barra lateral esquerda “WhatsApp -> Configurações” e cole as informações fornecidas pela plataforma Zaia e clique em “Verificar e salvar”..
Parabéns, seu agente agora responderá através do seu WhatsApp Business.
Observações
Se você estiver tendo problemas com a resposta do Agente, aqui estão algumas soluções possíveis:
Certifique-se de que esteja com a opção de messages marcada.
Atualizado