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.

É 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.

Conectando via QR Code

Você também pode conectar o seu número à credencial Z-API escaneando o QR Code

Após clicar em "Conectar " em "Conectar com QR Code" você irá visualizar um pop-up exibindo o QR Code com instruções para ajudar a escanear com sucesso pelo Whatsapp

🚨Atenção: O QR Code tem duração de 60s, após tempo expirado, o usuário poderá solicitar a criação de outro

💡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".

Resetando a conversa no Whatsapp

Caso queira começar um novo atendimento do zero, basta digitar e enviar a mensagem /restart no WhatsApp. Esse comando serve para limpar a conversa atual e iniciar uma nova.

Após enviar /restart, aparecerá uma mensagem dizendo:
"Sessão encerrada. Digite qualquer coisa para começar novamente."

⚠️Lembre-se de que, ao fazer isso, o assistente não se lembrará das mensagens enviadas anteriormente

Follow up e Repescagem

Ao ativar a funcionalidade você permitirá que seu agente envie mensagem para os usuário caso este não responda o agente ou para retornar uma conversa com seu usuário.

Você poderá escolher entre 2 tipos de envio de mensagem:

1. Inteligência Artificial:

Envie um prompt para que seu agente responda de forma personalizada!

• Tempo de espera sem resposta (Em minutos): Selecione quanto tempo o agente deve esperar a última mensagem do usuário para enviar a mensagem. A contagem será reiniciada a cada vez que o usuário responder a mensagem do agente

• Tentativas máximas de contato: Selecione quantas vezes o agente entrará em contato com o usuário após não receber respostas. A contagem será reiniciada a cada vez que o usuário responder a mensagem do agente

• Usar contexto da conversa: Ao ativar, permite que o agente leia as últimas mensagens com o usuário, e utilize de contexto para realizar follow-up/repescagem

• Mensagens consideradas no contexto: Insira a quantidade de mensagens (até 50) que o agente utilizará como contexto da conversa para gerar a mensagem de repescagem.

2. Bot/Automação:

Envie uma mensagem automática, está não será modificada e o agente enviará exatamente a mensagem configurada

• Tempo de espera sem resposta (Em minutos): Selecione quanto tempo o agente deve esperar a última mensagem do usuário para enviar a mensagem. A contagem será reiniciada a cada vez que o usuário responder a mensagem do agente

• Tentativas máximas de contato: Selecione quantas vezes o agente entrará em contato com o usuário após não receber respostas. A contagem será reiniciada a cada vez que o usuário responder a mensagem do agente

Pronto! Agora você já sabe como inserir seu agente de IA Toolzz AI no WhatsApp