Sobre
Incorporar o seu agente de IA do Toolzz AI ao WhatsApp Business permite automatizar o atendimento e facilitar a comunicação direta com seus clientes, 24 horas por dia. Com essa integração, seu bot pode responder perguntas frequentes, enviar informações importantes e até auxiliar em processos de vendas e suporte, tudo de forma rápida e personalizada pelo WhatsApp.
Atualmente, essa funcionalidade está em versão beta, o que significa que ela ainda está em fase de testes e pode passar por ajustes ou apresentar algumas limitações temporárias. Mesmo assim, já é possível utilizá-la para otimizar seu atendimento e experimentar as vantagens da automação no aplicativo.
É possível incorporar sua IA no WhatsApp usando dois tipos de credenciais: Meta Business ou Z-API. Vamos falar sobre cada uma delas neste artigo.
🚨Atenção!
A parte "Agente" e "Cérebro" do agente de IA já devem estar configuradas antes de iniciar a configuração do WhatsApp. Se ainda não fez isso, visite o tutorial COMO CRIAR UM AGENTE DE IA NO TOOLZZ AI.
Passo a passo
1º passo: caso você esteja editando um agente de IA que já foi criado, acesse a opção "Agentes de IA" no menu lateral.
Depois, clique no botão com o desenho de três pontos no card do agente de IA e escolha a opção "Editar".
Caso você esteja criando um agente de IA, pule para o próximo passo.
2º passo: na página "Agente" role a tela até encontrar a parte de "Recurso do Agente".
Clique no botão com uma seta para baixo para expandir a seção.
3º passo: localize a funcionalidade "WhatsApp" e clique na chave de ativação referente a ela para ativar. Repare que a chave ficará colorida.
💡Dica: quando quiser desativar a funcionalidade, basta clicar na chave novamente. Ela voltará a ficar cinza.
4º passo: ao ativar a funcionalidade, o botão "WhatsApp" aparecerá no menu superior. Clique nele para acessar a página da funcionalidade.
Nesta página você verá a parte de configuração do lado esquerdo e parte de pré-visualização e testes do lado direito.
Credencial
5º passo: na parte "Credencial" clique no campo "Escolha uma credencial" para ter acesso a um menu suspenso.
Se você já possui uma credencial, basta selecioná-la na lista.
Se você ainda não possui, precisa criá-la. Para isso clique na opção "Criar credencial".
Veja o passo a passo de como criar uma credencial de WhatsApp no artigo COMO CRIAR CREDENCIAIS DA META BUSINESS E Z-API NO TOOLZZ AI.
❗Informação importante: a opção "Sem credencial" serve para remover uma credencial que esteja conectada, fazendo com que o WhatsApp cadastrado nela pare de enviar mensagens nesse bot.
Vinculando uma credencial da Meta Business
1º passo: se você escolheu uma credencial da Meta Business, clique no botão "Verificar".
Se estiver tudo certo com os dados, ao lado de "Credencial" aparecerá o símbolo de check "✅" e a palavra "Conectado", e logo abaixo a mensagem "Credencial verificada com sucesso".
❗Informação importante: se a credencial estiver sendo usada em outro bot, não será possível fazer a verificação. É preciso desconectar essa credencial do outro bot, ou usar outra credencial.
Conectando uma credencial Meta Business
Após vincular uma credencial válida a Meta, o bloco "Conexão" ficará disponível. Nele você encontrará o "Webhook Url" e o "Webhook Token" que são necessários para a conexão da sua credencial com sua conta Businnes da Meta.
2º passo: copie o "Webhook Url" e o "Webhook Token".
Para que a integração com o Whatsapp funcione corretamente, é necessário configurar a sua credencial na conta Business da Meta. Este processo precisa ser feito apenas uma vez por credencial.
3º passo: acesse seu Painel de Apps da Meta clicando aqui e escolha em qual aplicativo deseja configurar a credencial.
4º passo: no menu lateral, na parte de "Produtos" escolha a opção "Webhooks".
5º passo: confira se está com a opção "User" selecionada e clique no botão "Subscribe to this object".
6º passo: preencha o campo "URL de retorno de chamada" com a "Webhook Url" gerada no Toolzz AI. Já no campo "Token de verificação", insira o "Webhook Token" gerado no Toolzz AI.
Se você quiser que as cargas de notificação de eventos incluam os nomes dos campos que mudaram, além dos novos valores, altere a opção "Incluir valores" para "Sim".
Para finalizar, clique em "Verificar e salvar".
7º passo: a Meta vai enviar uma solicitação para testar se o seu webhook está funcionando que deverá ser validada. Se tudo estiver certo, uma mensagem de sucesso será exibida.
A última etapa é assinar campos individuais. Para isso, clique no botão "Subscribe" referente aos campos desejados.
🚨Atenção!
Essas configurações são realizadas em uma plataforma externa, por isso, atualizações e mudanças podem ocorrer no passo a passo.
Para tirar dúvidas, ou se aprofundar mais no assunto, acesse a documentação criada pela própria Meta clicando aqui.
Vinculando uma credencial da Z-API
1º passo: se você escolheu uma credencial da Z-API, clique no botão "Vincular".
Se estiver tudo certo com os dados, ao lado de "Credencial" aparecerá o símbolo de check "✅" e a palavra "Conectado", e logo abaixo a mensagem "Credencial verificada com sucesso".
❗Informação importante: se a credencial estiver sendo usada em outro bot, não será possível fazer o vínculo. É preciso desconectar essa credencial do outro bot, ou usar outra credencial.
Conectando uma credencial Z-API
Após vincular uma credencial válida a Meta, o bloco "Conexão" ficará disponível. Nele você encontrará o "Webhook Url", que é necessário para a conexão da sua credencial com sua conta Z-API.
2º passo: copie o "Webhook Url".
Para que a integração com o WhatsApp funcione corretamente, é necessário conferir se a vinculação do Webhook aconteceu corretamente com a Z-Api.
3º passo: acesse sua conta na plataforma Z-Api e na parte de "Instanciâcias Web" selecione a instância usada para conectar ao Toolzz AI.
Acesse a aba "Weebhooks e configurações gerais" e confira se o campo "Ao receber" foi preenchido com a URL da API gerada no Toolzz AI.
Caso não tenha sido preenchido, cole o "Webhook Url" copiado no Toolzz AI.
💡Dica: recomendamos ativar as chaves das opções "Rejeitar chamadas automático" e "Ler mensagens automático".
Para finalizar, clique no botão "Salvar".
🚨Atenção!
Essas configurações são realizadas em uma plataforma externa, por isso, atualizações e mudanças podem ocorrer no passo a passo.
Para tirar dúvidas, ou se aprofundar mais no assunto, acesse a documentação criada pela própria Z-Api clicando aqui.
💡Dica: do lado direito da tela você consegue testar seu agente de IA.
Salvando as configurações
Se você estiver apenas editando um agente de IA, clique em "Salvar".
Se você ainda precisa terminar a configuração do agente de IA, clique no botão "Continuar".
Pronto! Agora você já sabe como inserir seu agente de IA Toolzz AI no WhatsApp.