Como já explicamos no primeiro artigo COMO USAR O AGENT BOT PARA INTEGRAR O TOOLZZ BOTS E TOOLZZ CHAT - PARTE 1, para configurar o Agente Bot é preciso construir um fluxo de bot e inseri-lo nele, além de escolher a ação que o bloco vai realizar e configurá-la. Com o Agente Bot o usuário não passará pela experiência de mudar de conversa nem de janela de chatbot, tornando o fluxo mais fluido e amigável. Uma vantagem de usar esse fluxo no WhatsApp é que você precisará de apenas um único número.

É importante ressaltar que a caixa de entrada no Toolzz Chat deve ser sempre do tipo API.

Dica para uso em múltiplas plataformas

8º passo: para utilizar o mesmo fluxo tanto no WhatsApp, quanto em outras plataformas, adicione uma condicional para identificar se o atendimento é via WhatsApp e ajuste o fluxo conforme necessário.

💡Dica

Conheça mais sobre o bloco de condição citado acima no artigo CONDICIONAIS - TOOLZZ BOTS.

Configurações para Web

• Insira o bloco de integrações "Agent Bot".

  • Clique para configurar e, primeiro, selecione um Token;

  • Depois, escolha a ação "Modo Chat";

  • Preencha os campos "Account ID", "Conversation ID" com as variáveis correspondentes coletadas anteriormente;

  • Em "PubSub Token" selecione a variável criada no bloco "Configurar conta" para armazenar esta informação;

  • Selecione sua API Key configurada no bloco "Configurar conta".

Configurações WhatsApp

• Insira o bloco de input de "Texto" e no campo "Salve a resposta em uma variável" escolha uma variável já existente ou crie uma nova.

• Insira o bloco de integrações "Agent Bot".

  • Clique para configurar e, primeiro, selecione sua conta Toolzz Chat já configurada;

  • Depois, escolha a ação "Enviar mensagem para o Toolzz Chat";

  • No campo "Message" selecione a mesma variável inserida no bloco de texto anterior;

  • Preencha os campos "Account ID" e "Conversation ID" com as variáveis correspondentes coletadas anteriormente.

• Adicione o bloco de condicional "Pular”. No campo "Select a group" selecione o nome do grupo (bloco de texto + agent bot) criado anteriormente para que a troca de mensagens seja continua.

No final, o fluxo para múltiplas plataformas ficará assim:

Preenchimento automático de atributos de conversa no Toolzz Bots

Para criar um fluxo no bot que envie valores de variáveis para alimentar atributos personalizados da conversa no Toolzz Chat, siga os passos abaixo.

1º passo: insira o bloco "HTTP request" após o bloco "Enviar mensagem para o Toolzz Chat".

🚨Atenção! É essencial que este bloco seja inserido após a criação da conversa, pois o conversationId já deve ter sido coletado.

2º passo: clique em "Configure".

No campo "Paste URL" insira a URL do endpoint da API, substituindo ${accountId} e ${conversationId} da URL pelas variáveis correspondentes ao ID da conta e ID da conversa, respectivamente:
​https://chat.toolzz.ai/api/v1/accounts/${accountId}/conversations/${conversationId}/custom_attributes

​💡Dica

Passe o mouse sobre as configurações do bloco e clique no ícone de duas setas opostas para expandi-lo, facilitando a substituição das variáveis na URL.
​
3º passo: termine a configuração do bloco.

• Ative as configurações avançadas clicando na chave de ativação "Advanced configuration";

• Em "Method" selecione a opção POST.

• Clique em "Headers" para expandir e depois clique em "+Add a value".

  • Preencha o campo "Key" com api_access_token

  • Preencha o campo "Value" com o token do seu perfil no Toolzz Chat.

• Cliquem no botão "+Add a value" para adicionar mais uma entrada no header.

  • Preencha o campo "Key" com Content-Type

  • Preencha o campo "Value" com application/json

• Clique em "Body" para expandir a opção.

  • Clique na chave de ativação da opção "Custom body".

  • No campo de texto, insira o modelo de JSON abaixo, substituindo [chave] pela chave do atributo personalizado criado no Toolzz Chat e [valor] pela variável que coleta a informação correspondente no Toolzz Bots.
    ​{
"custom_attributes": {
"[chave]": "[valor]"
}
}

Encontre a chave API do Toolzz Chat através do caminho: foto de perfil, localizada no canto inferior esquerdo da tela > Configurações do perfil > role a página até encontrar a opção Token de Acesso > copie o código.

❗Informação importante: onde encontrar a [chave] do atributo no Toolzz Chat

Encontre a chave do atributo do Toolzz Chat através do caminho: menu lateral > Configurações > Atributos personalizados > coluna "CHAVE" > copie a chave.

Se você ainda não sabe como criar um atributo personalizado, consulte o artigo COMO CRIAR E GERENCIAR ATRIBUTOS PERSONALIZADOS NO TOOLZZ CHAT.
​

Pronto! Agora você já sabe como usar o Agent Bot para integrar o Toolzz Bots e o Toolzz Chat.