Principal FLUXO COMO INTEGRAR O BOT COM PLATAFORMAS EXTERNAS?

COMO INTEGRAR O BOT COM PLATAFORMAS EXTERNAS?

Última atualização em Aug 05, 2026

Sobre

Em integrações do bot, é possível integrar com várias plataformas externas que podem ser usadas para melhorar ainda mais a experiência dos usuários e otimizar os processos da sua empresa.

Neste artigo você encontrará mais informações sobre as seguintes integrações:

  • Analytics

  • HTTP

  • E-mail

  • Toolzz Chat

  • Agent Bot

  • Pixel

  • Toolzz AI

  • Cal

  • QR Code

  • ElevenLabs

Passo a passo

1º passo: no fluxo do bot, role o menu lateral até encontrar a parte de integrações.

2º passo: para adicionar um bloco de integração ao fluxo do bot, basta clicar no item e arrastá-lo até a posição desejada. Depois, dê um nome ao grupo para identificá-lo.

No GIF abaixo, usamos o bloco e-mail como exemplo:

Analytics

A integração com Analytics permite monitorar e analisar o desempenho dos chatbots em tempo real, fornecendo insights valiosos sobre o comportamento dos usuários, a eficácia das interações e o engajamento geral. É possível acompanhar métricas como número de conversas, tempo médio de resposta, taxa de conclusão de objetivos e identificar pontos de melhoria. Isso permite otimizar continuamente o chatbot, melhorar a experiência do usuário e atingir metas estratégicas com maior precisão.

Clique em "Configure" e preencha as informações do formulário para configurar o bloco:

  • Measurement ID: o ID de métricas pode ser encontrado no dashboard do Google Analytics. Em caso de dúvidas, consulte o artigo de ajuda da Google clicando aqui.

  • Event action: defina qual evento de ação vai acontecer. Saiba mais sobre eventos no artigo de ajuda da Google clicando aqui.

  • Se quiser, clique em "Avançado" para realizar configurações avançadas relacionadas ao Google Analytics.

HTTP

A integração com HTTP request permite que o chatbot se comunique diretamente com APIs externas, enviando e recebendo dados em tempo real. Isso amplia as funcionalidades do chatbot, possibilitando a execução de operações dinâmicas como consultas a bancos de dados, envio de informações a sistemas externos, obtenção de dados atualizados, e personalização de respostas baseadas em informações contextuais. Assim, o bot pode oferecer respostas mais precisas e relevantes, melhorando a experiência dos usuários.

Clique em "Configure" e preencha as informações do formulário para configurar o bloco:

  • Insira a URL do endpoint da API que você deseja chamar.

  • Ative a chave "Advanced configuration" para ter acesso às configurações avançadas.

    • Method: define o tipo de solicitação HTTP que será feita (por exemplo, GET, POST, PUT, DELETE). Cada método tem um propósito específico:

      • GET: solicita dados de um servidor.

      • POST: envia dados para um servidor para criar/atualizar um recurso.

      • PUT: atualiza dados em um servidor.

      • DELETE: remove dados de um servidor.

    • Query params: parâmetros adicionados ao final da URL na forma de chave=valor (ex.: ?chave1=valor1&chave2=valor2). Usados para passar informações adicionais ao servidor, geralmente para filtrar ou modificar a solicitação.

    • Headers: informações adicionais enviadas junto com a solicitação HTTP. Podem incluir dados como tipo de conteúdo (Content-Type), autenticação (Authorization), entre outros. Eles ajudam o servidor a entender como processar a solicitação.

    • Body: contém os dados enviados no corpo da solicitação, principalmente em métodos como POST e PUT. Pode estar em diferentes formatos, como JSON, XML, ou formulário de dados.

    • Advanced parameters: parâmetros adicionais que permitem configurações como opções de timeout, que define o tempo máximo que a solicitação HTTP pode levar para receber uma resposta do servidor.

    • Variable values for test: usados para testar a solicitação. São úteis para simular diferentes cenários e verificar se a integração está funcionando conforme o esperado, sem a necessidade de modificar o código ou a configuração principal.

E-mail

A integração com e-mail permite que o chatbot envie e-mails automaticamente durante ou após interações com os usuários. Isso é útil para várias finalidades, como: enviar confirmações de pedidos, fornecer informações adicionais solicitadas, realizar follow-ups ou encaminhar informações para a equipe de suporte. Com essa funcionalidade é possível melhorar a comunicação e o engajamento, além de automatizar tarefas administrativas e de suporte, economizando tempo e recursos.

1º passo: clique em "Configure" para ter acesso ao formulário de configuração.

2º passo: caso ainda não tenha realizado uma conexão de e-mail, você precisará criar uma.
No campo "From", clique em "Nova conexão" e preencha o formulário de nova conexão.

Neste tutorial, vamos usar como exemplo uma conexão com o Gmail.

  • From e-mail: o endereço de e-mail com o qual deseja fazer a conexão.

  • From name: o nome da pessoa responsável pelo e-mail.

  • Host: o servidor que hospeda a conta de e-mail. No caso do Gmail, "smtp.gmail.com".

  • Username: sua identificação para entrar no Gmail, no caso, seu endereço de e-mail.

  • Password: sua senha do Gmail. Caso possua autenticação de dois fatores na sua conta, você precisará criar uma senha de aplicativo. Saiba mais sore o assunto no artigo de suporte da Google clicando aqui.

  • Secure: habilite esta chave caso vá utilizar o número de porta "465".

  • Port number: identificador numérico que indica um canal específico através do qual os dados de e-mail são transmitidos. Use o número "587" para o Gmail.

Para finalizar, clique em "Create".

3º passo: após realizar a conexão com seu e-mail, configure o e-mail que será enviado.

  • To: endereço de e-mail que vai receber o e-mail.

  • Advanced:

    • Reply to: direciona as respostas a um endereço de e-mail diferente daquele que enviou originalmente a mensagem.

    • Cc: adiciona um endereço de e-mail em cópia.

    • Bcc: adiciona um endereço de e-mail como cópia oculta.

  • Subject: insira o assunto do e-mail.

  • Custom content: ative esta chave para inserir o conteúdo personalizado (corpo de mensagem) do e-mail.

    • Text: escolha esta opção para criar o conteúdo de e-mail através de texto.

    • Code: escolha esta opção para criar o conteúdo de e-mail através de código.

  • Attach files: anexe arquivos que tenham sido coletados previamente no bloco upload de arquivo.

❗Informação importante

Se quiser adicionar uma variável, ou seja, uma informação que já foi coletada pelo bot, em um dos campos, basta clicar no botão com o desenho de uma pessoa e escolher um dos itens.

Toolzz Chat e Agente Bot

As duas integrações têm a mesma função: enviar o fluxo da conversa do Toolzz Bots para o Toolzz Chat e, assim, o usuário continuar a conversa com um ser humano.

Com essas integrações, é possível utilizar recursos de comunicação em tempo real, como mensagens instantâneas, transferências para operadores humanos e a utilização de ferramentas colaborativas, proporcionando uma experiência de atendimento mais dinâmica e personalizada. Isso é útil para oferecer suporte ao cliente, resolver problemas de forma rápida e eficiente, e manter um alto nível de engajamento e satisfação dos usuários.

Configurando Toolzz Chat

A configuração do Toolzz Chat é mais simples, necessitando apenas do token da caixa de entrada para qual deseja enviar a conversa. Nesta integração o usuário passa pela experiência de ter que ser redirecionado para outra janela de conversa. Por exemplo: se for uma janela de chatbot em um site a janela se fechará e abrirá outra, com a conversa do Toolzz Chat.

🚨Atenção!

  • Só funciona com integração com a "Caixa de entrada Web" do Toolzz Chat. Não funciona para integração com caixa de entrada de WhatsApp. Para esta, use o Agent Bot.

  • O fluxo do bot não será retomado do ponto onde foi interrompido após o transbordo para o Toolzz Chat.

1º passo: insira o bloco de Toolzz Chat no momento do fluxo que deseja encerrar o fluxo no Bot e enviar para o Toolzz Chat para iniciar a interação humana e clique em "Abrir Toolzz Chat". Preencha o formulário.

  • Insira a Base URL e o "Website token". Essas informações serão encontradas no Toolzz Chat através do caminho: Configurações > Caixas de Entrada > Ícone de configurações da sua caixa de entrada web > aba Configuração > Código Mensageiro script > websitetoken.

  • Em "Set user details" defina quais informações do usuário atendido você deseja passar do Bot para o Chat. Você pode inserir uma informação ou adicionar variáveis já coletadas pelo chatbot, assim a conversa será iniciada já com dados do contato.

  • Em "Custom attributes" você pode enviar dados personalizados do fluxo do bot para o Toolzz Chat, utilizando variáveis coletadas anteriormente para enriquecer o contexto do atendimento com informações adicionais do usuário ou da interação.

    Estes dados aparecerão na conversa, no formulário do contato, ao lado direito.

    🚨Atenção! Antes de configurar os dados no bot, é necessário criar um atributo personalizado do tipo contato no Toolzz Chat. Para isso, acesse o tutorial completo com o passo a passo de criação.

    Após a criação, retorne às configurações do bot, clique na seta para baixo para expandir o item "Custom attributes" e depois em "Add attribute". Insira a chave do atributo personalizado no campo "Key". Em seguida, no campo "Value", informe os dados que deseja enviar, como por exemplo a variável "empresa" coletada anteriormente no fluxo. Você pode adicionar quantos atributos personalizados desejar, basta repetir este passo a passo.

Configurando Agent Bot

Já 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 fluído e amigável.

Lembrando que a caixa de entrada no Toolzz Chat deve ser sempre do tipo API.

1º passo: clique em "Configure" e depois em "Select Toolzz Chat Account".

Caso ainda não tenha realizado uma conexão com o Toolzz Chat, você precisará criar uma. Clique em "Create new", preencha o nome da sua conta no Toolzz Chat e insira sua chave API.

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.

2º passo: após fazer a conexão da conta, em "Select an action" escolha a ação que o bloco vai executar e configure os campos correspondentes.

❗Informação importante

Cada ação terá configurações diferentes.

Exemplo de configuração das duas integrações:


Quer saber mais sobre essa funcionalidade? Acesse o artigo COMO USAR O AGENT BOT PARA INTEGRAR O TOOLZZ BOTS E TOOLZZ CHAT.

Histórico de conversas do Agent Bot nos resultados

A área de resultados conta com uma coluna, identificada com o nome "Agent Bot", que exibe o histórico completo de perguntas enviadas pelo usuário por sessão.

3º passo: acesse a aba "Resultados" e localize a coluna com o nome "Agent Bot" para visualizar o histórico de conversas.

💡 Dica! Utilize o ícone de expandir para visualizar o histórico completo.

Pixel

A integração com o Facebook permite rastrear as interações dos usuários com o chatbot e conectar esses dados às campanhas de publicidade no Facebook. É possível monitorar ações específicas realizadas pelos usuários, como cliques, preenchimento de formulários e conversões, diretamente no ambiente do chatbot. Esses dados são enviados ao Facebook para analisar o comportamento dos usuários, medir a eficácia das campanhas publicitárias, criar públicos personalizados e otimizar as estratégias de engajamento.

1º passo: clique em "Configure" para acessar o formulário de configuração.

  • Insira seu Pixel ID.

  • Se quiser pular a inicialização do bot, ative a chave da opção "Skip initialization".

  • Se deseja rastrear um evento ative a chave "Track event", escolha um evento específico e faça as configurações necessárias.

Para saber mais sobre a integração com o Pixel e encontrar seu Pixel ID, acesse o artigo de suporte a Meta clicando aqui.

💡 Dica!
A funcionalidade de Pixel permite enviar eventos do chatbot para o Meta Pixel, possibilitando acompanhar ações realizadas pelos usuários e mensurar a efetividade das campanhas de anúncios. Esses eventos podem ser configurados em pontos estratégicos do fluxo, como início de atendimento, preenchimento de formulário, solicitação de orçamento, geração de lead ou conclusão de uma compra.

Uma boa prática é capturar as UTMs no início da conversa e armazená-las em variáveis do bot. As UTMs são parâmetros enviados na URL (como utm_source, utm_medium e utm_campaign) que identificam a origem do usuário, o canal e a campanha responsável pelo acesso. Dessa forma, além de registrar a conversão, é possível analisar qual campanha gerou aquele resultado e otimizar os investimentos em mídia.

Na prática, o funcionamento costuma ser o seguinte: o usuário acessa o chatbot por um link com UTMs, essas informações são armazenadas em variáveis logo no início do fluxo e, conforme o usuário realiza ações importantes, os blocos de Pixel enviam os respectivos eventos para a Meta.

❗Informação importante
Esse tipo de rastreamento por UTMs funciona apenas quando o chatbot é acessado por uma URL que contenha esses parâmetros, como em um widget no site ou em uma landing page. Em fluxos executados exclusivamente no WhatsApp, não é possível capturar UTMs, pois a conversa é iniciada diretamente pelo aplicativo e esses parâmetros não são transmitidos. Nesse cenário, caso seja necessário identificar a origem dos usuários, é preciso utilizar outras estratégias de rastreamento, de acordo com a arquitetura da solução.

Toolzz AI

A integração com o Toolzz AI permite conectar o seu bot a uma inteligência artificial. Com essa integração, o bot coleta a pergunta do usuário e a envia para o Toolzz AI, que processa a solicitação e gera uma resposta automaticamente. Em seguida, a resposta gerada é retornada e exibida para o usuário diretamente no bot.

1º passo: arraste o bloco de input de texto para coletar a pergunta do usuário. Em seguida, salve a resposta em uma variável para utilizá-la nos próximos passos, por exemplo: "pergunta".

2º passo: adicione o bloco de integração com o Toolzz AI dentro do grupo criado no passo anterior. Clique em “Configure” e depois em “Selecionar Conta do Toolzz AI”.

Se você já tiver uma conta conectada, basta selecionar o e-mail de login correspondente. Caso ainda não tenha uma conta conectada, clique em “Nova conexão”.

3º passo: você será redirecionado para a página de login do Toolzz AI. Informe seus dados de acesso, preencha o captcha e clique em “Entrar”.

Em seguida, clique em “Permitir compartilhar” para autorizar a integração. Pronto! Sua conta do Toolzz AI foi conectada com sucesso.

4º passo: após realizar o login, selecione a unidade e, em seguida, o agente que deseja conectar.

5º passo: adicione um prompt inicial para encaminhar a pergunta coletada para a IA. Esse prompt funciona como uma instrução de direcionamento, semelhante a iniciar uma ligação com o Toolzz AI e informar o contexto da solicitação antes de enviar a pergunta do usuário.
Não se preocupe: a IA continuará respeitando o dataset e o prompt configurados diretamente no Toolzz AI, garantindo que as respostas sigam as regras e conteúdos definidos na plataforma.

6º passo: após testar a conexão, o campo "Salvar em variáveis" ficará ativo. Clique na seta para baixo para expandir e clique no botão "Adicionar variável".

No campo data, selecione a opção "data.message.content" que corresponde a resposta da IA gerada lá no Toolzz AI.

Dica💡: selecione a opção "data.message.conversationId "para salvar o id da conversa. Dessa forma, a IA vai entender que qualquer mensagem enviada no fluxo se trata da mesma conversa e manterá o contexto.

IA em tempo real no Chat

Ao usar o bloco de integração com o Toolzz AI com esta opção habilitada, uma conversa é criada automaticamente no Toolzz Chat.

Um atendente humano pode assumir a conversa a qualquer momento, interrompendo a IA.

7º passo: clique na chave "IA em tempo real no Chat" para ativar os campos de configuração.


8º passo: clique em "Selecionar Conta Toolzz Chat". Se você já tiver uma conta conectada, basta selecioná-la na lista. Caso ainda não tenha uma conexão criada, clique em "Nova conexão" para conectar sua conta do Toolzz Chat. Neste caso, insira a URL base "https://chat.toolzz.ai" e a chave API no formulário que abrirá.


🚨Atenção! 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.


9º passo: após conectar a conta, selecione a caixa de entrada onde a conversa será criada. Opcionalmente, você também pode selecionar um time para que a conversa seja atribuída automaticamente.

🚨Atenção! A caixa de entrada selecionada precisa ser do tipo API.


10º passo: quando a conversa for finalizada no Toolzz Chat, você pode definir uma mensagem de encerramento para ser exibida ao usuário. Caso não personalize, a mensagem enviada por padrão será "Conversa encerrada".


11º passo: em "Dados do participante", configure as informações que serão usadas para criar o contato no Toolzz Chat. Os campos nome e telefone são obrigatórios e devem ter sido coletados anteriormente no fluxo e armazenados em variáveis.


O campo "Observação" pode ser utilizado para enviar informações adicionais ao agente. Esses dados aparecerão no formulário que ele receberá assim que a conversa for criada.

12º passo: para finalizar, exiba a resposta da IA utilizando o bloco bubble de texto. Arraste o bloco para o fluxo e clique no ícone de uma pessoa para selecionar a variável onde a resposta da IA foi armazenada no passo 6.


❗Informações importantes

  • Quando uma conversa é criada no Toolzz Chat, um atendente humano pode interromper o fluxo da IA a qualquer momento, basta enviar uma mensagem ou atribuir a conversa a um atendente.

  • Ao utilizar a opção de IA em tempo real no Chat, é necessário manter a conversa em looping. Para isso, adicione um bloco de condicionais "Pular" e redirecione o fluxo para a etapa de coleta da pergunta novamente, criando assim um fluxo contínuo de conversa com a IA.

Histórico de conversas da IA nos resultados

A área de resultados conta com uma nova coluna para cada IA conectada, identificada com o nome do agente, exibindo o histórico completo de perguntas e respostas por sessão.

13º passo: acesse a aba "Resultados" e localize a coluna com o nome do seu agente de IA para visualizar o histórico de conversas.

💡 Dica! Utilize o ícone de expandir para visualizar o histórico completo.

Cal

A integração com o cal.com permite incorporar sua agenda diretamente no bot, tornando o processo de agendamento mais simples e fluído para o usuário. O cal.com é uma plataforma de agendamentos que permite compartilhar sua disponibilidade e gerenciar compromissos de forma automatizada. Com essa integração, os usuários podem visualizar horários disponíveis e realizar agendamentos sem sair da conversa. Para mais informações sobre a plataforma, acesse: https://cal.com.

1º passo: clique em "Configure" e em "Selet an action", selecione a opção "Book event".


2º passo: em "Event link" inclua o link do evento criado no cal.com, ou seja, o link público da agenda configurada.


3º passo: escolha qual modelo de layout que será exibido para o usuário(mensal, semanal ou colunas).


4º passo: no campo "Prefill information", clique na seta para baixo para expandir as configurações. Nesse campo, você pode utilizar variáveis coletadas anteriormente no fluxo para preencher automaticamente as informações do contato no formulário de agendamento. Esse preenchimento é opcional.


5º passo: o campo "Save booked date" permite salvar a data e o horário do agendamento em uma variável para utilização em etapas posteriores do fluxo.

QR code

A integração com o QR code permite que o chatbot gere códigos QR dinâmicos que podem ser usados para diversas finalidades, como direcionar usuários para URLs específicas, acessar informações adicionais ou até gerar QR codes para pagamentos via pix. Para isso, basta que eles escaneiem o código QR com seus dispositivos móveis e se conectem diretamente ao chatbot para obter informações ou realizar ações específicas.

1º passo: clique em "Configure", selecione a opção "Generate a QR Code" e preencha as informações do formulário para configurar o bloco.

  • Data: insira uma URL de redirecionamento ou qualquer dado de texto que você deseja codificar em um código QR.

  • Save QR code image URL: selecione ou crie uma variável para salvar o QR code. Ex: "QR code Tutoriais".

2º passo: para exibir o QR dentro da conversa do chatbot, use o bloco de imagem, como mostramos no exemplo abaixo. Insira o bloco de imagem.

3º passo: na aba link, adicione a variável que você usou para salvar o QR code (criada no passo 1 das configurações do QR code). No nosso exemplo, variável "QR code Tutoriais".

Eleven Labs

A integração permite transformar texto em áudio. Isso torna as interações com o bot mais dinâmicas e acessíveis, permitindo que ele fale com os usuários em vez de apenas enviar mensagens de texto. Isso é útil para criar assistentes virtuais, melhorar o atendimento ao cliente e qualquer situação onde a comunicação por voz seja importante.

1º passo: clique em "Configure", depois em "Select ElevenLabs account" e escolha a opção "Connect New" para conectar sua conta da ElevenLabs ao Toolzz Bots.

Insira o nome da sua conta, sua chave API da ElevenLabs e depois clique em "Create".

Veja como criar sua chave API consultando o artigo de suporte da ElevenLabs clicando aqui.

2º passo: após conectar uma conta, o campo "Select an action" aparecerá. Clique nele e escolha a opçãp "Convert text to speech".

  • Digite o texto que deseja transformar em áudio.

  • Escolha o "Voice ID" que será usado.

  • Selecione o "Model ID" para definir qual modo de conversão será usado.

  • Selecione ou crie uma variável para salvar esse áudio.

Caso tenha dúvidas sobre as configurações da ElevenLabs, acesse a documentação de suporte da plataforma clicando aqui.

Pronto! Agora você já sabe como integrar o Toolzz Bots com plataformas externas.