🤖

FLUXO

Eduardo
Por Eduardo
10 artigos

BUBBLES - CONTEÚDOS DO BOT

Sobre As funcionalidades da categoria "Bubbles" são essenciais para criar uma experiência de conversa mais interativa e fluida. Elas representam os tipos de mensagens que o bot pode enviar para o usuário e podem ser usadas para exibir mensagens de texto, botões de ação, imagens e outros elementos interativos, tornando a interação mais intuitiva e eficiente. Nos bubbles podem ser encontrados blocos de funcionalidades: - Texto; - Vídeo; - Áudio; - Imagem; - Incorporar. Neste artigo, vamos explorar como configurar e utilizar essas funcionalidades. ❗Informação importante Em vários campos dos bubbles você vai se deparar com o botão com desenho de uma pessoa. Esse botão serve para inserir ou criar variáveis. As variáveis são dados, como o nome, respostas a perguntas específicas ou qualquer informação relevante coletadas ao longo da conversa com o usuário. Ao clicar neste botão é possível inserir uma variável já existente. Também há como criar uma variável digitando seu nome no campo de busca e depois clicando no botão "Criar". As variáveis poder podem ser usadas nos bubbles para acrescentar informações personalizadas aos itens adicionados ao bot. Na imagem, usamos como exemplo o bubble de imagem: Texto O bloco de texto é usado para exibir mensagens de texto simples, em formato de balões, ao usuário. Ele serve para transmitir informações, fazer perguntas ou guiar a conversa dentro do bot. Ao criar um bubble de texto, você pode inserir o conteúdo desejado e personalizar a mensagem para que ela se encaixe no contexto da conversa. Os blocos de texto podem ser encadeados, ou seja, ligar uma mensagem de texto à próxima automaticamente. Isso cria uma transição suave entre diferentes partes da conversa, facilitando a leitura e compreensão das informações. Exemplo na visão do usuário: Passo a passo 1º passo: insira um bloco de texto no fluxo do bot. Para isso, clique no bubble "Texto" e arraste para a tela de edição do bot. 2º passo: dê um nome para o novo grupo (isso ajuda na identificação) e escreva o texto que será enviado para o usuário. 3º passo: por meio dos botões na barra de edição do bloco de texto, é possível formatar o texto. - Ícone com o desenho de uma pessoa: insira uma variável coletada pelo bot; - Ícones de edição de texto: "B" para colocar o texto em negrito, "I" para itálico e "U" com o traço embaixo para sublinhar; - Ícone de corrente: insira um link para redirecionar o usuário. - Selecione o texto no qual o link será vinculado e clique no ícone de link. - Insira a URL de destino no campo "Paste link" e aperte a tecla "Enter". - Se quiser, clique no link que acabou de inserir para ter acesso às opções "Edit Link", para alterar o link inserido e ícone de elo de corrente riscado, para remover o link do texto. Ao clicar no texto vinculado ao link o usuário será redirecionado para a URL configurada. ​ 4º passo: para inserir mais blocos de textos e encadear as mensagens, basta clicar no bubble texto e arrastar para o grupo criado anteriormente. Vídeo O bloco de vídeo permite que você incorpore vídeos diretamente na conversa do bot. Ele serve para compartilhar conteúdo visual, como tutoriais, demonstrações de produtos ou mensagens informativas, de maneira mais envolvente. Ao adicionar um vídeo, você pode proporcionar uma experiência mais rica e dinâmica, ajudando a capturar a atenção do usuário e transmitir informações de forma clara e eficaz. Você pode colar a URL de um vídeo de várias fontes, incluindo YouTube, Vimeo, Gumlet, Tik Tok, entre outros. Exemplo visão do usuário de um bloco de texto + um bloco de vídeo: Passo a passo: ​ 1º passo: insira um bloco de vídeo no fluxo do bot. Para isso, clique no bubble "Vídeo" e arraste para a tela de edição do bot. 2º passo: dê um nome para o novo grupo (isso ajuda na identificação). Clique no campo "Clique para editar" e insira a URL do vídeo no campo "Colar o link do vídeo". 3º passo: defina a proporção e largura máxima de como o vídeo será exibido. Repare que, do lado direito, é possível visualizar uma prévia de como o vídeo aparecerá para o usuário. Ao clicar no "play" do vídeo o usuário assistirá o vídeo incorporado sem precisar sair do bot. Áudio O bloco "áudio" permite que você incorpore e reproduza arquivos de áudio diretamente na conversa do bot. Ele serve para transmitir informações auditivas, como mensagens de voz, músicas ou sons explicativos. Ao usar o bubble de áudio, você pode oferecer uma experiência auditiva enriquecedora, ajudando a comunicar mensagens de maneira mais diversificada e atraente para o usuário. Você pode carregar um arquivo de áudio ou inserir a URL do áudio. Exemplo visão do usuário bloco de texto + bloco de áudio: Passo a passo: 1º passo: insira um bloco de áudio no fluxo do bot. Para isso, clique no bubble "Áudio" e arraste para a tela de edição do bot. 2º passo: dê um nome para o novo grupo (isso ajuda na identificação). Clique no campo "Clique para editar". 3º passo: na aba "Incorporar link", insira a URL do áudio (MP3s e WAVs). Se desejar, ative a opção "Ativar reprodução automática" para o áudio iniciar automaticamente. Repare que, do lado direito, é possível visualizar uma prévia de como o áudio aparecerá para o usuário. 4º passo: na aba "Carregar", clique no botão "Escolher um arquivo" para fazer o upload de um arquivo de áudio do seu computador. Se desejar, ative a opção "Ativar reprodução automática". Soluções para erros com o bloco de áudio 💡 - O primeiro balão de áudio não está sendo reproduzido automaticamente Isso é esperado. A maioria dos navegadores da web possui uma política que impede a reprodução automática do áudio. O usuário precisa interagir com a página antes que o áudio possa ser reproduzido. - O áudio não está sendo reproduzido no iOS/Safari Provavelmente, significa que seu arquivo de áudio está corrompido. Dependendo da origem do arquivo, é importante garantir que a codificação foi feita corretamente. Você pode verificar se o arquivo está codificado da maneira correta baixando-o e reproduzindo-o localmente em seu computador. Imagem O bloco "imagem" permite que você exiba imagens diretamente na conversa do bot. Ele serve para compartilhar conteúdo visual, como gráficos, fotos de produtos ou ilustrações, para complementar as informações textuais e tornar a interação mais atraente. Usar imagens ajuda a captar a atenção do usuário e pode tornar a comunicação mais clara e impactante. Você pode inserir o link da imagem, fazer upload dela, escolher um GIF, uma imagem do Unsplash ou um ícone. Exemplo visão do usuário bloco de texto + bloco de imagem: Passo a passo: 1º passo: insira um bloco de imagem no fluxo do bot. Para isso, clique no bubble "Imagem" e arraste para a tela de edição do bot. 2º passo: dê um nome para o novo grupo (isso ajuda na identificação). Clique no campo "Clique para editar". 3º passo: é possível inserir uma imagem no seu bot de quatro maneiras diferentes. Link Na aba "Link", insira a URL da imagem que deseja incorporar ao bate-papo do bot. Se desejar, ative a chave da opção "Link ao clicar", assim, ao clicar na imagem, o usuário será redirecionado para este link. No primeiro campo que apareceu insira a URL de redirecionamento. O segundo campo é para inserir um texto alternativo. Ele serve para descrever o conteúdo da imagem para usuários que não podem vê-la, como aqueles que utilizam leitores de tela. Além disso, o texto alternativo é exibido quando a imagem não pode ser carregada, proporcionando contexto sobre o que a imagem representa. Repare que, do lado direito, é possível visualizar uma prévia de como a imagem aparecerá para o usuário. ❗Informação importante A funcionalidade "Link ao clicar" aparece em todas as opções de inclusão de imagem no bot, e, em todas elas, é configurada da mesma forma como detalhamos acima. Upload Acesse a aba "Upload". Clique em "Escolha uma imagem", e faça o upload de uma imagem do seu computador. Se quiser, ative e configure a funcionalidade "Link ao clicar". ​ Giphy Acesse a aba "Giphy" e use a barra de busca para encontrar um GIF. Depois é só clicar na imagem deseja para que ela seja inserida no bot. Se quiser, ative e configure a funcionalidade "Link ao clicar". Unsplash Acesse a aba "Unsplash" e use a barra de busca para encontrar uma imagem neste banco de dados. Depois é só clicar na imagem deseja para que ela seja inserida no bot. Se quiser, ative e configure a funcionalidade "Link ao clicar". Icon Acesse a aba "Icon" e selecione o ícone que desejar. É possível buscar ícones de cores diferentes, para isso clique no ícone de círculo colorido, localizado ao lado da barra de busca, e selecione uma cor clicando nas cores já disponíveis, cores avançadas ou incluindo o código da cor. Incorporar O bloco "incorporar" permite que você integre conteúdo externo diretamente na conversa do bot, como PDF, iframes, sites, mapas do Google, postagens de redes sociais, entre outros. Ele serve para enriquecer a interação com conteúdo dinâmico e interativo, proporcionando aos usuários acesso direto a informações ou funcionalidades adicionais sem sair da conversa. Exemplo visão do usuário bloco de texto + bloco de incorporar: Passo a passo: 1º passo: insira um bloco de incorporar no fluxo do bot. Para isso, clique no bubble "Incorporar" e arraste para a tela de edição do bot. 2º passo: dê um nome para o novo grupo (isso ajuda na identificação). Clique no campo "Clique para editar". 3º passo: insira o link ou código no primeiro campo de texto. No campo "Altura", defina a medida da altura, em pixels, que o conteúdo será mostrado. 🚨Atenção! Alguns sites não permitem a incorporação. Se você encontrar um espaço em branco, isso significa que o site que está tentando incorporar não autoriza essa função. Testando o funcionamento dos bubbles Testar o funcionamento dos bubbles na pré-visualização do bot é essencial para garantir que todos os elementos, como texto, imagens, vídeos e links, funcionem corretamente e proporcionem uma boa experiência ao usuário. Na pré-visualização, você pode verificar se as interações fluem como esperado, identificar e corrigir erros, e ajustar o conteúdo antes de lançar o bot ao público. Selecione o grupo criado. Alguns botões aparecerão logo acima do bloco. Clique no primeiro botão, com o ícone de uma seta. Ao lado direito aparecerá a pré-visualização, simulando a conversa do chat. Veja se todos os bubbles adicionadas ao fluxo estão funcionando corretamente. Pronto! Agora você já sabe como utilizar os bubbles do bot.

Última atualização em Aug 21, 2024

COMO COLETAR INPUTS NO TOOLZZ BOTS?

Sobre "Input" significa entrada de dados. As funcionalidades dos "Inputs" são ferramentas essenciais para coletar informações dos usuários durante a interação com o bot. Elas permitem que você crie campos para entrada que vão coletar dados de texto, e-mail, data, arquivo e muito mais. Usando os blocos de Inputs, você pode coletar dados específicos e personalizar a experiência do usuário com base nas respostas fornecidas. Nesta categoria encontramos blocos de funcionalidades: - Texto; - E-mail; - Data; - Botão; - Pagamento; - Arquivo; - Documento; - Número; - Website; - Telefone; - Seleção de Imagem; - Avaliação; - Sala. Neste artigo, vamos explorar como configurar e utilizar essas funcionalidades para otimizar a coleta de informações no seu bot. ❗Informação importante Em vários campos dos blocos de inputs você vai se deparar com o botão com desenho de uma pessoa. Esse botão serve para inserir ou criar variáveis. As variáveis são dados, como o nome, respostas a perguntas específicas ou qualquer informação relevante coletadas ao longo da conversa com o usuário. Ao clicar neste botão é possível inserir uma variável já existente. Também há como criar uma variável digitando seu nome no campo de busca e depois clicando no botão "Criar". As variáveis poder podem ser usadas nos inputs para acrescentar informações personalizadas aos itens adicionados ao bot. Além disso, todo bloco arrastado para o fluxo recebe um título padrão no grupo. No entanto, você pode modificar esse título para facilitar a identificação. Texto O input "texto" permite que os usuários digitem respostas de forma livre durante a interação com o bot. Esse tipo de input é flexível e pode ser usado em diversas situações para capturar dados essenciais e personalizar a experiência da conversa. O bloco de texto possibilita solicitar ao usuário uma resposta curta ou longa. Exemplo visão do usuário bloco bubble de texto + bloco input de texto: Passo a passo 1º passo: insira um bloco de texto no fluxo do bot. Para isso, clique no input "Texto" e arraste para a tela de edição do bot. Em seguida, clique no campo "Digite sua resposta". 2º passo: por padrão, o bloco é configurado para receber uma resposta de texto curta. Caso queira coletar um resposta de texto longa ative a chave da opção "Texto longo?". ❗Informação importante As configurações dos demais campos do formulário funcionam da mesma forma para reposta de texto curto ou longo. 3º passo: preencha os demais campos do formulário. - Placeholder: texto de exemplo que aparece dentro do campo de entrada antes do usuário começar a digitar. Ele serve como dica ou instrução sobre o que deve ser inserido naquele campo, desaparecendo quando o usuário começa a digitar. ​Exemplo: Digite seu nome. - Legenda do botão: é o texto exibido no botão que o usuário clica para enviar ou confirmar a entrada de texto. Ele deve indicar claramente a ação que será realizada. Exemplos: "Enviar", "Confirmar" ou "Próximo". - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Digite o nome da variável no campo e depois clique em "Criar". ​Exemplo: Nome do lead. Email O input "e-mail" serve para coletar o endereço de e-mail dos usuários, garantindo que o dado inserido seja um endereço no formato correto. Esse tipo de input é útil para registros, assinaturas de newsletters, ou qualquer situação onde seja necessário capturar um e-mail para comunicação futura. Uma mensagem de nova tentativa será exibida sempre que o Toolzz Bots detectar que o e-mail não está formatado corretamente (por exemplo, sem o @). Entretanto, ele não verifica se o endereço de e-mail é válido. Para essa validação, será necessário acionar um bloco Webhook e utilizar uma API de serviço de validação de e-mails. Exemplo visão do usuário bloco bubble de texto + bloco input de e-mail: Passo a passo 1º passo: insira um bloco de e-mail no fluxo do bot. Para isso, clique no input "Email" e arraste para a tela de edição do bot. Em seguida, clique no campo "Digite sua resposta". 2º passo: preencha os demais campos do formulário. - Placeholder: texto de exemplo que aparece dentro do campo de entrada antes do usuário começar a digitar. Ele serve como dica ou instrução sobre o que deve ser inserido naquele campo, desaparecendo quando o usuário começa a digitar. ​Exemplo: Digite seu e-mail. - Legenda do botão: é o texto exibido no botão que o usuário clica para enviar ou confirmar a entrada de texto. Ele deve indicar claramente a ação que será realizada. Exemplos: "Enviar", "Confirmar" ou "Próximo". - Mensagem de nova tentativa: é possível personalizar a mensagem que avisará ao usuário que o e-mail não está no formato correto. Exemplo: Este não é um e-mail válido. Poderia digitá-lo novamente? - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Digite o nome da variável no campo e depois clique em "Criar". ​Exemplo: E-mail lead. Data O input "Data" permite que os usuários selecionem uma data específica a partir de um calendário interativo. Ele serve para coletar informações relacionadas a datas, como datas de nascimento, agendamentos de compromissos ou datas de eventos. Esse tipo de input facilita a entrada de dados precisos e formatados corretamente, melhorando a experiência do usuário e a precisão das informações coletadas. É possível solicitar uma data específica, inclusive incluindo às horas ou um intervalo de tempo. O input usará o seletor de data nativo do dispositivo ou navegador usado para responder ao bot. Exemplo visão do usuário bloco buuble de texto + bloco input de data: Passo a passo 1º passo: insira um bloco de data no fluxo do bot. Para isso, clique no input "Data" e arraste para a tela de edição do bot. Em seguida, clique no campo "Selecione uma data". 2º passo: preencha os demais campos do formulário. - Ative a chave da opção "Intervalo?" para permitir que o usuário selecione duas datas, para marcar o início e o fim de um período. Com a opção ativada aparecerão duas novas opções: - Legenda de: insira um texto descritivo que será exibido junto ao campo onde o usuário selecionará a data de início do intervalo. Por exemplo, "Data de início". - Legenda até: igual ao campo anterior, mas será exibido onde é selecionada a data de fim do intervalo. Por exemplo, "Data de término". - Ative a chave da opção "Com tempo?" para adicionar campos de seleção de hora ao input de data, permitindo ao usuário escolher além de uma data, também um horário. - Legenda do botão: insira um texto que será exibido no botão usado para confirmar a seleção da data. Por exemplo, "Confirmar". - A opção "Min" define a data mínima que o usuário pode selecionar. Por exemplo, se você quiser permitir que os usuários escolham datas apenas a partir de 1º de janeiro de 2024, configure o campo com "01-01-2024". - A opção "Máx" define a data máxima que o usuário pode selecionar. Por exemplo, se se os usuários podem escolher datas até 31 de dezembro de 2024, configure como "31-12-2024". - Formatar: defina como a data selecionada será exibida. Você pode usar formatos como "DD/MM/AAAA" para exibir a data como "31/12/2024". - Exemplos de formatação de data sendo dd para dia / MM para mês / yyyy para ano / HH para hora / mm para minuto / ss para segundo: - dd - MM - yyyy - dd - MM - yyyy HH: mm : ss - dd / MM/ yy - dd / MM / yyyy HH: mm:ss - d.MM.yy - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Digite o nome da variável no campo e depois clique em "Criar". ​Exemplo: Data da reunião x. Botão O input "botão" permite adicionar botões interativos na conversa, que os usuários podem clicar para selecionar uma opção ou realizar uma ação específica. Ele serve para simplificar a interação, guiando os usuários de forma clara e direta através de escolhas predefinidas, como "Sim" ou "Não", "Próximo" ou "Anterior", ou qualquer outra ação relevante. Exemplo visão do usuário bloco bubble de texto + bloco input de botão + bloco bubble de texto de novo: Passo a passo 1º passo: insira um bloco de botão no fluxo do bot. Para isso, clique no input "Botão" e arraste para a tela de edição do bot. 2º passo: clique no campo "Clique aqui para editar" e digite o que você quer que apareça escrito no seu botão. Exemplo: SIM. Para adicionar mais botões, passe o mouse por cima do botão já criado e clique no ícone de "+". 3º passo: clique no ícone com o desenho de um quadro e um check, localizado do lado esquerdo do botão criado e preencha o formulário. - "Múltipla escolha?": quando ativada, essa opção permite que os usuários cliquem em vários botões para selecionar múltiplas respostas em vez de apenas uma. Neste caso, independente do que selecionar, poderá ser direcionado à apenas um fluxo. Com a opção desativada, o usuário pode escolher apenas um botão. Assim, é possível vincular cada botão à um fluxo, e o caminho do usuário será definido de acordo com a opção que ele escolher. - Legenda do botão de envio: o que estará escrito no botão que o usuário deve clicar após selecionar múltiplas respostas. Exemplo: Enviar. - "É pesquisável?": esta opção permite que os botões sejam pesquisáveis, ou seja, o usuário filtrar e encontrar rapidamente a opção desejada entre os botões disponíveis. - Placeholder do input: será o texto de instrução que aparecerá dentro do campo de pesquisa antes do usuário começar a digitar. Serve para orientar sobre o que pode ser digitado. Exemplo: "Procure por uma opção". - Dados dinâmicos: permite que o conjunto de botões apresentados ao usuário seja gerado dinamicamente com base nas variáveis salvas. Para isso, selecione as variáveis na lista. - Salve a resposta em uma variável: permite que a escolha do usuário seja salva em uma variável específica. Isso facilita o uso da resposta em outras partes da conversa ou para processamento posterior. Digite o nome da variável no campo e depois clique em "Criar". ​Exemplo: Resposta usuário X. 4º passo: passando o mouse por cima de cada botão criado, aparecerá um botão com o ícone de engrenagem. Se quiser criar condições específicas para definir se um botão será exibido para determinados usuários, clique na engrenagem e ative a opção "Condição de exibição". 5º passo: clique no botão "Adicionar comparação" e preencha os campos. - Pesquise uma variável: insira uma variável que contém um dado já coletado pelo bot. Exemplo: Idade. - Selecione um operador: o operador define a lógica de comparação que será usada para avaliar a condição. Por exemplo, se você quer que o botão apareça apenas se a variável for maior que um determinado valor, você pode selecionar "Greater than" (maior que). - Digite um valor: insira o valor que será comparado com o valor da variável selecionada. Por exemplo, se a condição é exibir o botão apenas quando a variável "idade" é maior que 18, você colocará "18" neste campo. Com esta configuração, este botão só será exibido se o valor da variável "idade" for maior que 18, permitindo que você controle dinamicamente o fluxo de conversa baseado em condições específicas. Pagamento O bloco de input de pagamento coleta informações de pagamento, como detalhes do cartão de crédito ou outras formas de pagamento suportadas, e processa a transação de forma segura. 🚨 Atenção! Você precisa ter uma conta ativa e configurada na Stripe. O bloco "Pagamento" não funciona ao embedar o bot no WhatsApp. Exemplo visão do usuário bloco bubble de texto + bloco input de pagamento: Passo a passo 1º passo: insira um bloco de pagamento no fluxo do bot. Para isso, clique no input "Pagamento" e arraste para a tela de edição do bot. 2º passo: clique em "Configure" para iniciar as configurações. Na opção "Conta", clique em "Selecionar conta Stripe" e, se ainda não se conectou na sua conta Stripe, clique em "+ Nova Conexão". 3º passo: preencha o formulário de conexão. - Nome da conta: dê um nome para sua conta; - Chaves teste: insira chaves de teste, que serão usadas na visualização do bot. Elas podem ser encontradas aqui: https://dashboard.stripe.com/test/apikeys - Chaves de produção: insira as chaves ativas, que serão usadas no bot publicado. Elas podem ser encontradas aqui: https://dashboard.stripe.com/apikeys - Clique no botão "Connect", que ficará disponível quando os campos estiverem preenchidos. ❗Informações importantes - Se você quiser usar as chaves de teste no bot publicado, você só precisa inseri-las no campo "Chaves de produção". - Habilite os métodos de pagamento (Cartões, Apple Pay, Google Pay, Alipay, WeChat Pay etc.) que você deseja que apareça no seu painel do Stripe nesta URL: https://dashboard.stripe.com/settings/payment_methods . 4º passo: após selecionar sua nova conexão no campo "Conta", termine de realizar as configurações: - Valor do preço: defina o valor da transação. Pode ser um valor fixo ou calculado com base nas escolhas do usuário anteriores no fluxo (use uma variável); - Moeda: escolha em qual moeda ocorrerá a transação; - Legenda do botão: insira o que estará escrito no botão de compra. Exemplo: Pagar - Mensagem de sucesso: escreva uma mensagem para ser enviada quando a transação for realizada com sucesso. Exemplo: Transação realizada com sucesso! - Em informações adicionais você pode inserir mais informações sobre a compra preenchendo os campos ou usando variáveis já coletadas pelo bot. Arquivo O input "Arquivo" permite que os usuários enviem arquivos diretamente através da conversa com o bot. Ele serve para coletar documentos, imagens, ou qualquer outro tipo de arquivo que o usuário precise enviar, facilitando processos como envio de formulários, anexos para suporte técnico, ou qualquer situação onde seja necessário receber arquivos dos usuários. Exemplo visão do usuário bloco bubble de texto + bloco input de arquivo: 1º passo: insira um bloco de upload de arquivo no fluxo do bot. Para isso, clique no input "Arquivo" e arraste para a tela de edição do bot. 2º passo: clique em "Coletar arquivo" e configure os campos do formulário. - Ative esta opção para tornar o upload de arquivos obrigatório, permitindo que o usuário prossiga na conversa apenas após a conclusão do envio; - Ative a chave desta opção para permitir que os usuários façam o upload de vários arquivos ao mesmo tempo; - Placeholder é um texto que aparecerá dentro do campo de upload antes que o usuário interaja com ele. Serve como uma instrução ou exemplo, ajudando a guiar o usuário. Você pode usar código HTML simples para personalizar esse texto; - Labels - A "Legenda do botão" é o texto exibido no botão que o usuário clica para confirmar o upload do arquivo. Exemplo: Enviar. - Esta mensagem será exibida ao usuário após o upload bem-sucedido de um arquivo. Exemplo: Arquivo enviado. - Use este campo para determinar quem pode ver os arquivos enviados. "Público" significa que qualquer pessoa com o link pode ver os arquivos. "Privado" significa que apenas os membros deste workspace podem ver os arquivos. "Auto" significa que os arquivos serão públicos se carregados pela web, mas privados se carregados pelo WhatsApp. O link de arquivos privados não pode ser usado em outros blocos como, por exemplo, no campo anexo no bloco de enviar e-mail ou outros. - Salve a URL carregada numa variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. ❗Informação importante Só é possível enviar arquivos com até 10 MB. Se precisar enviar algo maior, peça para o usuário carregar o arquivo em um serviço como Google Drive ou Dropbox e compartilhar o link com você. Número O input "Número" permite que o usuário insira apenas valores numéricos durante a conversa com o bot. Ele é útil para coletar informações como idades, quantidades, valores monetários ou qualquer dado que precise ser registrado em formato numérico. Ele ajuda a garantir que o usuário forneça apenas números, evitando erros e simplificando a validação dos dados. Exemplo visão do usuário bloco bubble de texto + bloco input de número maior ou igual a 18: 1º passo: insira um bloco número no fluxo do bot. Para isso, clique no input "Número" e arraste para a tela de edição do bot. 2º passo: clique em "Digite um número" e configure os campos do formulário. - Placeholder: é o texto que aparece no campo de input antes de o usuário digitar qualquer coisa. Ele serve como uma dica visual para o usuário sobre o que deve ser inserido. Exemplo: Insira sua idade; - Legenda do botão: é o texto exibido no botão que o usuário clica para confirmar a informação. Exemplo: "Enviar"; - Mín: defina o valor mínimo que o usuário pode inserir. É útil para garantir que os números inseridos estejam dentro de um intervalo válido. Por exemplo, você pode definir como 18 se o fluxo for somente para usuários maiores de idade; - Máx: defina o valor máximo que o usuário pode inserir. Ele ajuda a restringir as respostas a um intervalo específico. Por exemplo, você pode definir como 60 se o fluxo for somente para usuários que não sejam idosos; - Intervalo: determina o intervalo entre os números permitidos. Por exemplo, se o intervalo for definido como 5, o usuário só poderá inserir números como 5, 10, 15, 20, etc. Se não quiser restringir a entrada a intervalos específicos, deixe esse campo em branco; - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Exemplo: idade. Website O input "website" permite que o usuário insira um endereço de site ou URL durante a interação com o bot. Ele serve para coletar links de sites, páginas específicas ou qualquer URL que seja relevante para o fluxo da conversa. Ele ajuda a garantir que o usuário forneça um endereço de site válido, facilitando a coleta de informações relacionadas a websites. Exemplo visão do usuário bloco bubble de texto + bloco input de website + bloco bubble de imagem: 1º passo: insira um bloco de website no fluxo do bot. Para isso, clique no input "Website" e arraste para a tela de edição do bot. 2º passo: clique em "Insira uma URL" e configure os campos do formulário. - Placeholder: é o texto que aparece no campo de input antes de o usuário digitar qualquer coisa. Ele serve como uma dica visual para o usuário sobre o que deve ser inserido. Exemplo: Insira uma URL; - Legenda do botão: é o texto exibido no botão que o usuário clica para confirmar a informação. Exemplo: "Enviar"; - Mensagem de nova tentativa: o bloco de "Website" verificará se a URL está formatada corretamente, caso não esteja, será enviada uma mensagem para o usuário tentar novamente. Exemplo: Esta URL não está no formato correto. Verifique o link e envie novamente. 🚨Atenção: a plataforma não verificará se a URL de e-mail é válida. Para isso, será preciso acionar um bloco "Webhook/API" e chamar uma API de serviço de validação de URL. - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Exemplo: URL. Telefone O input "telefone" serve para coletar números de telefone de forma padronizada, garantindo que o formato esteja correto e possa ser utilizado posteriormente. Esse tipo de input é ideal para capturar informações de contato, como número de celular, telefone fixo ou whatsapp de maneira rápida e eficaz. Exemplo visão do usuário bloco bubble de texto + bloco input de telefone: 1º passo: insira um bloco de telefone no fluxo do bot. Para isso, clique no input "Telefone" e arraste para a tela de edição do bot. 2º passo: clique em "Escreva seu telefone" e configure os campos do formulário. - Placeholder: é o texto que aparece no campo de input antes de o usuário digitar qualquer coisa. Ele serve como uma dica visual para o usuário sobre o que deve ser inserido. Exemplo: Insira seu número de whatsapp; - Legenda do botão: é o texto exibido no botão que o usuário clica para confirmar a informação. Exemplo: "Enviar"; - País padrão: defina o código do país que será usado, automaticamente, quando o usuário inserir um número de telefone ou escolha a opção "Internacional" para que o próprio usuário preencha essa código. Isso é útil para padronizar a coleta de números de telefone, especialmente se a maioria dos usuários for de um determinado país. - Mensagem de nova tentativa: o bloco verificará se o número está formatado corretamente, caso não esteja, será enviada uma mensagem para o usuário tentar novamente. Exemplo: Este número não está no formato correto. Corrija e envie novamente. - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Exemplo: whatsapp. Seleção de imagem O input "seleção de imagem" permite que o usuário escolha entre imagens pré-definidas que o bot apresenta. Funciona como um botão, mas em formato de imagem. Isso é útil em situações onde o bot precisa que o usuário selecione uma imagem específica de um conjunto, como para ilustrar preferências, escolher entre diferentes produtos, ou personalizar uma experiência. Exemplo visão do usuário bloco bubble de texto + bloco input de seleção de imagem: 🚨Atenção! O bloco "Seleção de imagem" não funciona ao embedar o bot no WhatsApp. 1º passo: insira um bloco de seleção de imagem no fluxo do bot. Para isso, clique no input "Seleção de imagem" e arraste para a tela de edição do bot. 2º passo: clique no bloco de imagem e configure os campos do formulário. - Imagem: clique em "Escolha uma imagem" e adicione a imagem que o usuário verá e poderá selecionar. É possível inserir uma imagem no seu bot de quatro maneiras diferentes. - Na aba "Link", insira a URL da imagem que deseja incorporar ao bate-papo do bot. - Na aba "Upload", clique em "Escolha uma imagem", e faça o upload de uma imagem do seu computador. - Em "Giphy" use a barra de busca para encontrar um GIF. Depois, é só clicar na opção desejada para que ela seja inserida no bot. - Em "Unsplash" use a barra de busca para encontrar uma imagem neste banco de dados. Em seguida, é só clicar na imagem deseja para que ela seja inserida no bot. - Na aba "Icon" selecione o ícone que desejar. É possível buscar ícones de cores diferentes, para isso clique no ícone de círculo colorido, localizado ao lado da barra de busca, e selecione uma cor clicando nas cores já disponíveis, cores avançadas ou incluindo o código da cor. - Título: serve como uma breve descrição ou rótulo da imagem. Ele ajuda o usuário a entender o que cada imagem representa. Exemplo: Praia; - Descrição: fornece mais detalhes sobre a imagem, ajudando o usuário a tomar uma decisão mais informada sobre sua escolha. É um complemento ao título. Exemplo: Caminhar em uma praia deserta; - Se quiser criar condições específicas para definir se uma imagem será exibida para os usuários, ative a chave da opção "Condição de exibição". Clique no botão "Adicionar comparação" e preencha os campos. - Pesquise uma variável: insira uma variável que contém um dado já coletado pelo bot. Exemplo: Idade. - Selecione um operador: o operador define a lógica de comparação que será usada para avaliar a condição. Por exemplo, se você quer que a imagem apareça apenas se a variável for maior que um determinado valor, você pode selecionar "Greater than" (maior que). - Digite um valor: insira o valor que será comparado com o valor da variável selecionada. Por exemplo, se a condição é exibir a imagem apenas quando a variável "idade" é maior que 18, você colocará "18" neste campo. Com esta configuração, este imagem só será exibida se o valor da variável "idade" for maior que 18, permitindo que você controle dinamicamente o fluxo de conversa baseado em condições específicas. 3º passo: para adicionar mais imagens, passe o mouse por cima da imagem já criada, clique no ícone de "+" e repita as configurações ensinadas nos passos anteriores. Avaliação O input "avaliação" permite que o usuário dê uma nota ou avaliação durante a interação com o bot, utilizando estrelas ou ícone personalizado. Ele serve para coletar feedback de forma rápida e intuitiva, permitindo que o usuário expresse sua satisfação ou opinião sobre um produto, serviço, ou experiência. Exemplo visão do usuário bloco bubble de texto + bloco input de avaliação: 1º passo: insira um bloco de avaliação no fluxo do bot. Para isso, clique no input "Avaliação" e arraste para a tela de edição do bot. 🚨Atenção! O bloco "Avaliação" não funciona ao embedar o bot no WhatsApp. 2º passo: clique em "Avalie de 0 a 10" e configure os campos do formulário. - Máximo: insira o valor máximo que deseja para a avaliação. Exemplo: se você definir 10, o usuário poderá escolher de 1 a 10 estrelas ou números; - Tipo: defina o formato visual da avaliação, escolhendo entre números ou ícones. Ao selecionar uma das opções, novos campos de personalização serão exibidos. - Numbers: o usuário escolherá números específicos como forma de avaliação; - Starts At: defina o número inicial a partir do qual a avaliação começa; - Icons: cada ícone representará um nível de avaliação, por exemplo, 1 estrela pode significar "ruim" e 5 estrelas "excelente". O usuário clica no ícone que representa sua opinião, e a quantidade de ícones selecionados reflete a nota que ele está dando. O ícone padrão é estrela; - Ative a chave da opção "Customizar ícone" para usar um ícone personalizado para a avaliação; - Ícone SVG: insira um ícone personalizado em formato SVG através do código específico deste formato; - Legenda 1: adicione um texto descritivo para a avaliação mais baixa. Exemplo: Muito ruim; - Legenda 10: adicione um texto para a avaliação mais alta. Exemplo: Excelente; - Ative a chave da opção "Enviar em um clique" para permitir que o usuário envie sua avaliação imediatamente ao clicar na nota desejada; - Ao deixar a opção anterior desmarcada, você precisará definir a legenda do botão que o usuário precisará clicar para enviar sua avaliação. Exemplo: Enviar; - Salve a resposta em uma variável: essa opção permite armazenar a resposta do usuário em uma variável específica. Ou seja, o dado será guardado com um nome identificador, que pode ser usado posteriormente no fluxo da conversa. Exemplo: avaliação atendimento. Sala O input "sala" é uma funcionalidade que permite transferir automaticamente o atendimento do bot para uma caixa de entrada específica do Toolzz Chat, onde um agente humano pode assumir a conversa. Esta funcionalidade está disponível apenas para fluxos web conectados a caixas de entrada do tipo API do Toolzz Chat. 1º passo: insira um bloco de sala no fluxo do bot. Para isso, clique no input "Sala" e arraste para a tela de edição do bot. 2º passo: clique em "Configure..." e configure os campos do formulário. - Em "Selecionar conta Toolzz Chat" escolha uma conta conectada. Caso ainda não tenha realizado uma conexão, você precisará criá-la. - Clique em "Nova Conexão"; - Preencha o campo URL com https://chat.toolzz.ai/ ; - Insira sua chave API do Toolzz Chat; - 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. - Clique em "Verificar"; - Se a verificação ocorrer corretamente, o campo "Nome" aparecerá. Dê um nome para esta conexão; - Para finalizar, clique em "Conectar". - Em "Caixas", selecione uma das caixas de entradas existentes na conta do Toolzz Chat conectada. 🚨Atenção! Lembrando que você só pode selecionar caixa de entrada do tipo API. - Em "Dados do participante", insira as informações que serão usadas para criar o contato no Toolzz Chat. - Você pode escrever cada dado (Nome, E-mail e Celular) ou você pode adicionar uma variável já coletada no fluxo; ❗Informação importante: o ideal é que os três campos estejam preenchidos, porque assim o contato ficará salvo de maneira completa no Toolzz Chat, mas, apenas com o nome o fluxo já funciona. 💡Dica: é possível continuar a criação do fluxo do bot após o input de sala. Quando o agente encerra a conversa no Toolzz Chat, o usuário retorna automaticamente ao fluxo, caso ele exista. Isso é útil, por exemplo, para enviar uma pesquisa de satisfação após o atendimento. Pronto! Agora você já sabe como utilizar os blocos de input do Toolzz Bots.

Última atualização em Jun 16, 2025

CONDICIONAIS - TOOLZZ BOTS

1.Variável Passo a passo: 1º passo: após arrastar o bloco de "Variável" pra dentro do seu fluxo e clicar em "Clique aqui para editar...", selecione ou crie uma variável. 2º passo: defina um valor específico para uma variável. Com a opção "Custom" selecionada, é possível definir uma variável de texto simples e incorporar código Javascript . Além disso, você pode criar funções com variáveis ja existentes para tratar o dado. Seguem alguns exemplos abaixo: - Adicione um valor à sua variável: {{Nome}} + 5 - Calcule uma soma de variáveis: {{Nome}} + {{ID do usuário}} - Multiplique as variáveis: {{Pontuação}} * {{Idade}} - Calcule uma porcentagem: {{Pontuação}} * 100 / {{Pontuação Máxima}} - Extraia o primeiro nome de um nome completo: {{Nome completo}}.split(' ')[0] - Transforme a variável existente em: maiúsculas: {{Nome}}.toUpperCase() minúsculas: {{Nome}}.toLowerCase() - Também pode ser código Javascript. Ele lerá o valor retornado do código e o definirá como sua variável: const name = 'Luana' + 'Maria' return name 2.Redirecionar Redirecione o seu usuário para uma determinada URL, na guia atual ou em uma nova guia. 🚨Atenção! Os dispositivos Safari e iOS agora bloqueiam redirecionamentos automáticos para novas guias por padrão. Certifique-se de testar essa funcionalidade em seu código de redirecionamento nessas plataformas. 3.Bot O bloco "Bot" permite encaminhar o fluxo para um bot ou grupo já existente. Com essa funcionalidade, é possível manter seus fluxos limpos e reutilizá-los em vários lugares. - Compartilhe variáveis ​​entre bots Os valores das variáveis ​​existentes são automaticamente compartilhados com o bot vinculado. Isso significa que se este bot vinculado contiver nomes de variáveis ​​semelhantes, ele será automaticamente preenchido com os valores do bot anterior. Exemplo: meu primeiro bot pede o nome do usuário e o armazena na variável Nome. Em seguida, vinculo a outro bot que exibe uma variável Nome em um balão de texto. Isso exibirá o nome coletado no primeiro bot. Passo a passo: 1º passo: após arrastar o bloco "Bot" para dentro do seu fluxo, clique em "Configure...". 2º passo: selecione um bot já existente. Se desejar que o bot atual seja direcionado para algum grupo dentro desse fluxo, clique em "Current Bot". 3º passo: no novo campo que surgirá, selecione o grupo desejado dentro desse fluxo. 4º passo: ative a opção "Merge answers" se quiser mesclar as respostas coletadas de um bot vinculado ao bot atual. Isso é útil se você quer reunir respostas de vários bots e enviá-las de uma vez para outro aplicativo. Ou se só deseja unir todas as respostas em uma única tabela de resultados. 4.Pular O bloco "Pular" permite saltar para um bloco de um grupo específico. Isso ajuda manter seu fluxo limpo. 5.Condição Divida seu fluxo em duas partes com base em uma condição. Uma condição pode conter diferentes comparações que são avaliadas em ordem e vinculadas a um operador lógico: "AND" ou "OR". Passo a passo: 1º passo: após arrastar o bloco de "Condição" para o seu fluxo, clique em "Configure..". Em seguida, clique no botão "+ Adicionar uma comparação". 2º passo: selecione uma variável já existente ou crie uma nova. 3º passo: em "Selecionar um operador", selecione uma condição de acordo com a lógica do seu fluxo. 4º passo: digite o valor da variável de comparação. 5º passo: se desejar adicione mais comparações e selecione um operador lógico(AND ou OR). - Exemplo de um fluxo com condicional: se a quantidade de usuários for igual a 500 AND a quantidade de acessos mensal for menor que 20, ele será encaminhado para o fluxo A. Se a quantidade de usuários for menor que 500, ele será encaminhado para o fluxo B. 6.Script O bloco "Script" permite executar código JavaScript dentro do seu fluxo. ❗Informações importantes - Este bloco não permite criar um bloco visual personalizado. - As variáveis dentro do script são avaliadas como JavaScript real. Exemplo: Em vez de console.log("{{Minha Variável}}"), use console.log({{Minha Variável}}). Definindo variáveis no Script A maneira mais recomendada de definir variáveis é usando o bloco "Variável". No entanto, se precisar fazer isso dentro do bloco Script, use a função setVariable: if({{Minha Variável}} === 'valor1') { setVariable('Minha Variável', 'novoValor') } else { setVariable('Minha Variável', 'outroValor') } 🚨 Atenção! A função setVariable só funciona se o script for executado no servidor. Se a opção "Execute on client?" estiver ativada, essa função não funcionará. Limitações do Script no Servidor Os scripts executados no servidor rodam em um ambiente isolado e seguro, o que traz algumas restrições: - Funções globais como console.log, setTimeout e setInterval não estão disponíveis. - A função fetch funciona de forma diferente: não é possível usar await response.text() ou await response.json(). Exemplo de código que gera erro: const response = await fetch('https://jsonplaceholder.typicode.com/todos/1') const data = await response.text() Exemplo de código correto: const data = await fetch('https://jsonplaceholder.typicode.com/todos/1') O response será sempre uma string, mesmo que a resposta seja um objeto JSON. Se tiver certeza de que o retorno é JSON, use JSON.parse(response). Código que gera erro: const response = await fetch('https://jsonplaceholder.typicode.com/todos/1') const data = await response.json() Código correto: const response = await fetch('https://jsonplaceholder.typicode.com/todos/1') const data = JSON.parse(response) - Não é possível importar bibliotecas externas usando import ou require. - APIs do navegador como window, document e localStorage não estão acessíveis. Se precisar usar APIs do navegador, ative a opção "Execute on client?" para que o script seja executado diretamente no navegador do usuário. Exemplos: Recarregar a página window.location.reload() Redirecionar com base em uma variável if({{Categoria}} === 'qualificado') { window.location.href = 'https://meu-site.com' } 7.Espera Com o bloco "Espera", é possível pausar a conversa por um determinado período, em segundos. Isso é útil se você deseja que o bot enfatize o que foi dito ou espere antes de um redirecionamento, por exemplo, para ter certeza de que o usuário leu tudo. 📌 Lembre-se que ao ativar a opção de "Pausar o fluxo", automaticamente o fluxo fica pausado até que o cliente envie outra mensagem. 8.Teste AB Divida o fluxo em 2 caminhos aleatoriamente. É uma ótima maneira de testar o desempenho de dois caminhos diferentes. Você pode empilhar vários blocos de teste AB para adicionar mais caminhos aleatórios. Após definir os caminhos e publicar o seu bot, é possível analisar o seu teste através do passo a passo abaixo: 1º passo: dentro do fluxo do seu bot, selecione a aba "Resultados". Lembrando que essa aba só aparece em bots publicados. 2º passo: clique em "Analytics". 3º passo: em "Analytics", existem dados como: - Visualizações: quantidade total de visualizações que o bot possui. - Inícios: quantidade de inputs iniciados. - Taxa de conclusão: porcentagem total de conclusão do fluxo do bot. Atrelado a cada input, tem uma etiqueta colorida com a quantidade de usuários que abandonaram e a porcentagem de usuários que visualizaram esse input. Pronto! Agora você já sabe como utilizar os blocos de condicionais.

Última atualização em Apr 22, 2025

COMO INTEGRAR O BOT COM PLATAFORMAS EXTERNAS? - PARTE 1

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. Este artigo será dividido em duas partes. Nesta primeira parte você encontrará mais informações sobre as seguintes integrações: - Analytics - HTTP - E-mail - Toolzz Chat - Agent Bot 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 melhor 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 a 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 da Gmail, "smtp.gmail.com". - Username: sua identificação para entrar na Gmail, no caso, seu endereço de e-mail. - Password: sua senha da 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 a 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 é especialmente ú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 intergração com a "Caixa de entrada Web" do Toolz 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 funciona mais após o bloco de 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 interações 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. Caso não envie os dados, a conversa será aberta como um novo contato. Configurando Agente 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 experiencia de mudar de conversa nem de janela de chatbot, tornando o fluxo mais fluido 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çã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: Pronto! Agora você pode avançar para conhecer as próximas integrações. Acesse o artigo COMO INTEGRAR O BOT COM PLATAFORMAS EXTERNAS? - PARTE 2

Última atualização em Aug 02, 2024

COMO INTEGRAR O BOT COM PLATAFORMAS EXTERNAS? - PARTE 2

Sobre Como já explicamos no primeiro artigo COMO INTEGRAR O BOT COM PLATAFORMAS EXTERNAS? - PARTE 1, 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. Este artigo é a segunda partes. Nela você encontrará mais informações sobre as seguintes integrações: - Pixel - OpenAI - 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: 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. OpenAI A integração com a OpenAI permite que o chatbot utilize avançados modelos de linguagem natural, como o GPT-4, para gerar respostas mais inteligentes, contextuais e humanas. Essa integração aprimora significativamente as capacidades do chatbot, possibilitando conversas mais naturais e fluídas, compreensão e processamento de consultas complexas, e a oferta de respostas detalhadas e precisas. 1º passo: clique em "Configure", depois em "Select OpenAI account" e escolha a opção "Connect New" para conectar sua conta da OpenAI aos Toolzz Bots. 2º passo: insira o nome da sua conta, sua chave API da Open AI e depois clique em "Create". Gerando uma chave API da Open AI - Caso ainda não tenha uma chave API, clique em "here" na mensagem abaixo do campo "API key". A plataforma vai te redirecionar para a página de login da IA. Faça seu login ou crie uma conta, se ainda não tiver. - Na página de "API keys" clique no botão "+ Create new secret key". E na janela que se abrirá, dê um nome para sua chave, escolha um tipo de permissão e clique no botão "Create secret key". Copie a chave gerada para utilizar no formulário do Toolzz Bots. 🚨Atenção! Salve esta API key em um lugar seguro e acessível. Por motivos de segurança, você não poderá visualizá-la novamente. Se você perder esta chave secreta, precisará gerar uma nova. 3º passo: após ter uma conta da OpenAI conectada, clique em "Customize provider" para customizar seu provedor. Em seguida, clique em "Selec an action" para selecionar ação que o bloco de OpenAI vai executar. São três tipos de ação disponíveis: - Creation chat completion: integre seu bot com o ChatGPT. Consulte a documentação completa da Open AI clicando aqui. - Ask assistent: integre o bot com seu assistente criado e treinado na OpenAI. Saiba mais sobre Assistentes API no artigo da suporte da Open AI clicando aqui. - Create speech: integre o bot com uma IA que enviará as mensagens em áudio para os usuários. Conheça mais detalhes sobre o assunto no artigo da suporte da Open AI clicando aqui. 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é realizar check-ins em eventos. 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: adicione a variável salva em um bloco, de e-mail ou Toolzz Conecct por exemplo, para enviar o QR Code. Para enviar 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.

Última atualização em May 27, 2025

COMO USAR O AGENT BOT PARA INTEGRAR O TOOLZZ BOTS E TOOLZZ CHAT? - PARTE 2

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.

Última atualização em Nov 28, 2024

COMO USAR O AGENT BOT PARA INTEGRAR O TOOLZZ BOTS E TOOLZZ CHAT? - PARTE 1

Sobre 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. Criando a variável "envId" 1º passo: em um bloco de variável conectado no fluxo ativo, crie a variável obrigatória para armazenar o Environment ID, com o nome de envId, para que seu fluxo funcione corretamente. Isso permite que o histórico de conversa entre o usuário e o bot seja enviado para o agente no Toolzz Chat. Criando variáveis adicionais para WhatsApp Se desejar integrar seu bot no WhatsApp, será necessário cria variáveis no início do fluxo para armazenar o nome do contato e o número de WhatsApp. Estas variáveis capturam essas informações diretamente da conta do cliente no WhatsApp, sem que ele precise fornecê-las ao acionar o bot. A variável deve ser nomeada como waContactName, com o campo "Valor" configurado como "Contact name". Da mesma forma, para a variável waPhoneNumber, o "Valor" deve ser "Phone number". 🚨Atenção! Os nomes das variáveis devem estar exatamente como escrito acima para que seu fluxo funcione corretamente. Além disso, se essas variáveis forem usadas em plataformas diferentes do WhatsApp, elas ficarão em branco, mas não causarão erros. Configurando o bloco "Agent Bot" 2º passo: clique no bloco de integrações "Agent Bot", segure e arraste para a tela de construção de fluxo do bot. Dê um nome para o novo grupo (isso ajuda na identificação). 3º 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. Configurando as ações do Agent Bot Após fazer a conexão inicial com o Toolzz Chat, você precisará adicionar blocos de Agent Bot ao longo do fluxo para executar diferentes ações do bot. ❗Informações Importantes - A cada novo bloco de Agent Bot adicionado ao fluxo é preciso selecionar a conta do Toolzz Chat que foi conectada anteriormente; - Em todo bloco de Agent Bot é preciso escolher a ação que ele vai executar através do botão "Select an action". As ações podem variar conforme as necessidades do fluxo; - Cada ação do Agent Bot terá campos de configurações diferentes. Algumas possuem campos específicos com informações necessárias para que o Toolzz Chat pesquise e localize os dados relevantes a serem coletados. Os campos obrigatórios estão marcados com asterisco “*” na cor vermelha. - Sempre use a opção "Salvar resultado em uma variável" para armazenar as informações coletadas. Esse passo é fundamental, pois as variáveis salvas serão utilizadas para executar as ações de outros blocos do AgentBot no fluxo. Configurar conta do Toolzz Chat Essa deve ser a primeira ação no fluxo: coletar o accountid e o pubSubToken do Toolzz Chat. Armazene essas informações em variáveis para uso futuro. 4º passo: após selecionar a conta do Toolzz Chat e a ação "Configurar conta do Toolzz Chat", clique em “Salvar resultado em variáveis” e depois em "Add" para incluir campos de variáveis. Em um campo de variável selecione “Accountid” e em outro “Pubsubtoken” para armazenar essas informações do Toolzz Chat. Nos campos "Selecione uma variável" correspondentes, armazene essas informações em variáveis para uso posterior. Criar/buscar contato no Toolzz Chat Cria ou encontra um contato no Toolzz Chat. Se o contato já existir, ele será localizado; se não, será criado. Recebe informações importantes sobre o contato para outras etapas. 🚨Atenção! Antes de configurar esta ação, você precisa ter coletado o e-mail do usuário e salvado esta informação em uma variável. 5º passo: após selecionar a conta do Toolzz Chat e a ação "Criar/buscar contato no Toolzz Chat". Preencha os campos obrigatórios - "Account ID" com a variável "accountid" coletada no bloco “Configurar conta do ToolzzChat”. - "Variável do email do contato" com a variável de e-mail do usuário coletada anteriormente. - "Variavel do número do contato" com a variável de telefone que deve ser coletada anteriormente no fluxo. Clique em “Salvar resultado em variáveis”. Em um campo selecione “contactId” e no outro “contactName” para armazenar essas informações. Nos campos "Selecione uma variável" correspondentes, armazene essas informações em variáveis para uso posterior. Definir inbox Define a caixa de entrada onde as conversas serão armazenadas. Isso ajuda a organizar as mensagens recebidas e a garantir que os dados sejam utilizados nas etapas seguintes. 6º passo: após selecionar a conta do Toolzz Chat e a ação "Definir inbox". Preencha os campos obrigatórios - "Account ID" com a variável "accountid" coletada no bloco “Configurar conta do Toolzz Chat”. - "Nome da Inbox" deve corresponder exatamente ao nome da caixa de entrada cadastrada no Toolzz Chat. Clique em “Salvar resultado em variáveis”. Selecione “inboxId” e no campo "Selecione uma variável" armazene essa informação em uma variável para uso posterior. ❗Informações importantes - A caixa de entrada deve ser do tipo API. Para criar e configurar uma caixa de entrada API, consulte o artigo COMO CRIAR E CONFIGURAR CAIXA DE ENTRADA API NO TOOLZZ CHAT. - Se quiser usar o Agent Bot integrado com o WhatsApp: - após embedar o bot no WhatsApp uma "Credencial de Webhook" será gerada para este número de WhatsApp que está sendo usado. Essa credencial deve ser inserida no formulário de criação de caixa de entrada de API, no Toolzz Chat, no campo "URL do Webhook". Encontre essa URL acessando Configurações e membros no menu superior > Credenciais > Webhook URL. - Para sabe como incorporar seu bot no WhatsApp acesse o artigo COMO PERSONALIZAR URL DE COMPARTILHAMENTO E INCORPORAR O BOT. - Se o Agent Bot não for integrado com o WhatsApp: no campo "URL do Webhook" no formulário de criação de caixa de entrada e API, no Toolzz Chat, deve ser colocada a URL de compartilhamento. Saiba como encontrá-la clicando aqui. Definir conversa no Toolzz Chat Cria uma nova conversa no Toolzz Chat usando as informações do contato e da caixa de entrada. Recebe dados importantes para futuras ações no fluxo. 7º passo: após selecionar a conta do Toolzz Chat e a ação "Definir conversa no Toolzz Chat". Preencha os campos obrigatórios - "Account ID" com a variável correspondente coletada no bloco “Configurar conta do Toolzz Chat”; - "ContactId" com a variável correspondente coletada no bloco “Configurar conta do Toolzz Chat”; - "Inbox ID" com a variável correspondente coletada no bloco “Definir inbox”. Clique em “Salvar resultado em variáveis”. - Selecione “conversationID” e no campo "Selecione uma variável" armazene essa informação em uma variável para uso posterior. Configurando horário de atendimento do Bot A configuração da variável "conversationStatus" serve para enviar, automaticamente, no bot, a mensagem sobre disponibilidade de atendimento, de acordo com o horário de funcionamento definido na caixa de entrada do Toolzz Chat. Para isso, é necessário incluir um bloco de condicional para verificar a variável e depois um bloco de texto para exibir a mensagem configurada na caixa de entrada e encerrar o bot. Sem em essa configuração, quando o usuário entrar em contato fora do horário de atendimento, o fluxo morrerá e ele não terá uma resposta. Veja como configurar: - Na parte “Salvar resultado em variáveis”, selecione “conversationStatus” e no campo "Selecione uma variável" armazene essa informação em uma variável para uso posterior. Ex: horário-atendimento - Inclua um bloco de "Condição". - Clique em "Configure..." e no campo "Pesquise uma variável" selecione a variável criada no bloco anterior. No caso do nosso exemplo: horário-atendimento. - No campo "Selecione um operador", escolha a opção "Is set". - Inclua um bloco "Bubble" de "Texto". Ele servirá para exibir a mensagem configurada na caixa de entrada do Toolzz Chat. - Clique no ícone com o desenho de uma pessoa e selecione a variável criada para essa ação. No caso do nosso exemplo: horário-atendimento. - Ligue esse bloco de texto à condição "SE + a variável adicionada" no bloco anterior. - Crie o restante do fluxo do bot e ligue o próximo bloco à condição "Senão" do bloco anterior. Com essa configuração, o fluxo funcionará da seguinte forma: se o usuário entrar em contato fora do horário de atendimento definido na caixa de entrada do Toolzz Chat, receberá a mensagem configurada e o fluxo será finalizado. Se estiver dentro do horário de atendimento, o fluxo do bot seguirá normalmente. 💡Dica A mensagem que será enviada ao usuário e o horário de atendimento, são definidos nas configurações da sua caixa de entrada no Toolzz Chat. No Toolzz Chat, acesse a aba "Horário de funcionamento", marque a caixa de seleção da opção "Permitir a disponibilidade de negócios para essa caixa de entrada". Escreva a mensagem que será exibida ao usuário fora do horário comercial e selecione o horário de atendimento disponível. Você pode saber mais sobre configurações das caixas de entrada do Toolzz Chat acessando os artigos da nossa Central de Ajuda. Enviar histórico de mensagens para o Toolzz Chat (opcional) Envia o histórico das mensagens do bot para a conversa no Toolzz Chat. Isso ajuda o atendente a ver o que já foi conversado e usar essas informações para continuar o atendimento. Após selecionar a conta do Toolzz Chat e a ação "Enviar histórico de mensagens para o Toolzz Chat". Preencha os campos obrigatórios - "Account ID" com a variável correspondente coletada no bloco “Configurar conta do Toolzz Chat”; - "Conversation ID" com a variável correspondente coletada no bloco "Definir conversa no Toolzz Chat”. Clique em “Nome da variável”, depois em "Add". Selecione uma variável para enviar o resultado como histórico de conversa. Se quiser enviar mais variáveis, basta adicionar mais campos. ​ ❗Informações importantes: - O bloco "Enviar histórico" deve sempre vir após o bloco "Definir conversa"; - Nunca deixe uma variável vazia; - Sempre que usar o bloco de variáveis, inclua ao menos uma variável para envio; - Quando nenhuma variável é inserida, o histórico ficará em branco, logo não será enviado nada para o Chat. Enviar protocolo para o Toolzz Chat (opcional) Envia um número de protocolo para a conversa no Toolzz Chat. Esse número ajuda a identificar a conversa facilmente e é importante para o gerenciamento da conversa. Crie um atributo de conversa personalizado no Toolzz Chat com o nome "Protocolo" e a chave "protocolo" para alimentar o campo automaticamente. Após selecionar a conta do Toolzz Chat e a ação "Enviar protocolo para o Toolzz Chat". Preenchas os campos obrigatórios - "Account ID" com a variável correspondente coletada no bloco “Configurar conta do Toolzz Chat”; - "Conversation ID" com a variável correspondente coletada no bloco "Definir conversa no Toolzz Chat”. Clique em “Salvar protocolo em variáveis”. No campo "Selecione uma variável" salve o resultado em uma variável. ​ ❗Informação importante: se estiver usando o bloco "Assumir Atendimento", o bloco de "Enviar protocolo" deve vir depois, nunca antes. Assumir atendimento (opcional) Permite que um atendente do Toolzz Chat assuma o controle da conversa passada pelo bot. Isso é útil para equipes de vendas que precisam usar as informações recebidas para continuar o atendimento. As conversas são passadas pelo bot através de um modal em tela. ❗Informações importantes - O agente poderá assumir as conversas a partir de uma fila, sem a opção de escolher qual atendimento vai aceitar. Ao clicar em “confirmar” para assumir um atendimento, ele aceitará o primeiro da fila, e o modal será fechado, reaparecendo apenas quando uma nova conversa estiver na fila. - Mais indicado para time de vendas comissionada. Após selecionar a conta do Toolzz Chat e a ação "Assumir atendimento". Preencha os campos obrigatórios - "Account ID" com a variável correspondente coletada no bloco “Configurar conta do Toolzz Chat”; - "Conversation ID" com a variável correspondente coletada no bloco "Definir conversa no Toolzz Chat”. - "Bot Agent ID" com o id do agente. Para obter o "Bot Agent ID", acesse as configurações do Toolzz Chat > agentes > localize o Bot Agente da sua empresa > clique em editar e obtenha o id dele. Habilite a função "Requer assistência humana" e preencha ao menos um filtro para indicar para quem o modal deve ser exibido: - Nome do Time; - Nome da Marca; - Nome da Caixa de Entrada; - Tipo de Agente (tipo de perfil atribuído ao usuário). 🚨Atenção! Os nomes dos filtros devem ser exatamente iguais aos nomes correspondentes no Toolzz Chat. Caso contrário, o modal não será disparado. Salve o resultado em uma variável. Esta variável deve ter o nome exato da informação coletada, ou seja, crie uma variável chamada “requireHumanAssistance” para armazenar essa informação. Pronto! Agora você pode avançar para conhecer os próximos passos a seguir para usar o Agent Bot pra integrar Bots e Chat. Acesse o artigo COMO USAR O AGENT BOT PARA INTEGRAR O TOOLZZ BOTS E TOOLZZ CHAT? - PARTE 2

Última atualização em Apr 22, 2025

COMO INTEGRAR O TOOLZZ BOTS COM O TOOLZ AI?

Sobre Integrar o Toolzz Bots com o Toolzz AI permite potencializar a automação e a personalização das interações feitas pelos seus bots. Com essa integração, os bots podem utilizar inteligência artificial para compreender melhor as mensagens dos usuários, oferecer respostas mais precisas e realizar tarefas complexas de forma autônoma. Integrado o Toolzz AI através de um template Para facilitar ainda mais a integração entre o Toolzz Bots e o Toolzz AI, você pode utilizar um template pronto. Esses modelos são pré-configurados com os principais fluxos e funcionalidades já integrados, permitindo que você economize tempo e comece rapidamente. 1º passo: clique em "Criar um bot" e depois na opção "Comece a partir de um modelo". 2º passo: escolha o modelo "IA de Atendimento". Repare que na janela ao lado será mostrada uma pequena prévia do modelo de bot. ​ Clique no botão "Usar esse modelo". A plataforma vai te redirecionar para a tela de edição do bot. Por ser um modelo pronto, o fluxo do bot já estará construído, agora, basta você fazer os ajustes necessários (como inserir o ID do bot da sua IA) para conectar com sua IA do Toolzz AI e outras configurações que achar necessárias de acordo com o objetivo do seu fluxo. 💡Dica: encontre o ID do bot do Toolzz AI acessando: sua IA do Toolzz AI > aba Visual > aba Curl do código. Criando um fluxo para integrar o Toolzz AI Se preferir mais controle e personalização, você também pode construir o fluxo de integração entre o Toolzz Bots e o Toolzz AI do zero. Essa abordagem permite adaptar cada etapa às suas necessidades específicas, criando uma solução única e totalmente alinhada aos seus objetivos. 1º passo: na página inicial, clique em "Criar um bot" e depois escolha a opção "Comece do zero". 2º passo: adicione o bloco de texto da categoria "Inputs" para coletar a dúvida do usuário. Configure uma variável para armazenar a reposta do usuário. Exemplo: pergunta1. 💡Dica Se o seu bot estiver integrado ao WhatsApp, você pode aproveitar as variáveis "Phone number" e "Contact name" no início do bot para capturar automaticamente o número de WhatsApp e o nome do contato, sem exigir que o usuário forneça essas informações manualmente. 🚨 Atenção! Este recurso é exclusivo para o WhatsApp. 3º passo: adicione o bloco HTTP request, da categoria "Integrações", no grupo. No campo “Paste url” insira a API do Toolzz AI: https://kratos.api.toolzz.com.br/api/v1/chat/send-message/ ❗Informação importante: está é a API do Toolzz AI. Utilize sempre esta mesma API quando for integrar com o Toolzz AI. 4º passo: clique na chave da opção “Advanced configuration” para ativá-la e faça as configurações a seguir. - No campo “Method” selecione a opção “Post”; - Clique na seta para baixo referente a opção “Headers” e depois clique no botão "Add a value". Preencha os campos: - Em “Key” escreva “Content-Type”; - Em “Value” escreva “application/json”. - Clique na seta para baixo referente a opção “Body” para mostrar os campos ocultos. - Habilite a opção “custom body”. - No campo de código, inclua duas informações: - 1.”message”: envie a pergunta do usuário que foi armazenada em uma variável (se tiver coletado outros dados, também deve inserir essas variáveis aqui) e dê uma breve instrução para direcionar a resposta da IA. Lembrando que o comportamento da IA é definido lá no Toolzz AI. - 2.”bot id”: insira o ID do bot do Toolzz AI. ​ ​Exemplo: ​*{"message":"Pergunta do cliente é {{pergunta1}}. Não precisa dizer Olá, pois já estamos no meio de uma conversa. Seja direto e objetivo, responda de forma resumida.",* ​*"botId":"0d8a7199-aa97-4292-9db1-38c240aa5e99"}* 💡Dica: encontre o ID do bot do Toolzz AI acessando: sua IA do Toolzz AI > aba Visual > aba Curl do código. - Clique na seta para baixo referente a opção “Variables value for test” e depois clique no botão "Add an entry". - Em "Variable name" inclua a variável (pergunta do usuário) coletada no 2º passo deste artigo. No nosso exemplo: {{pergunta1}} - Em "Testar valor" insira um valor de teste para a variável. Exemplo: “Quem é vc?”. 5º passo: clique no botão "Test the request" para testar a requisição para a API do Toolzz AI. Um status do código da requisição será exibido. ❗Informações importantes - Quando o teste for bem-sucedido, o "statusCode" retornará 200, acompanhado da mensagem de resposta gerada pela IA e do "ConversationId" criado pela IA. - Se ocorrer algum erro na requisição, será exibida a mensagem "Error" no código. Exemplo: 6º passo: clique na seta para baixo referente a opção "Save in variables” e depois clique no botão "Add an entry". - No campo "Data" selecione a opção “data.message.conversationId”. Esse é o id da conversa gerada com a IA. Toda conversa iniciada gera um id da conversa. - No campo "Set variable" salve esse id em uma variável. Exemplo: {{conversationID}} Clique em “Add an entry” novamente e configure: - No campo "Data" selecione a opção “data.message.content”. Essa é a resposta gerada pela IA. - No camop "Set variable" salve essa resposta gerada em uma variável. Exemplo: {{resposta1-IA}} 7º passo: adicione um bloco de texto da categoria "Bubble" ao grupo. Clique no ícone com o desenho de uma pessoa e selecione a variável de resposta da IA que você configurou no passo anterior. No nosso exemplo é variável {{resposta1-IA}}. Com isso, a resposta da IA será exibida para o usuário diretamente pelo bot. 💡Dica! Após configurar a primeira pergunta enviada para a IA, é possível adicionar botões ao bot para direcionar o usuário por diferentes caminhos. No exemplo abaixo, utilizamos o botão “Falar com nossa IA” para continuar a interação com a IA e o botão “Falar com atendente” para encaminhar o usuário a um atendente humano no Toolzz Chat. Acesse o artigo COMO USAR O AGENT BOT PARA INTEGRAR O TOOLZZ BOTS E TOOLZZ CHAT para saber mais sobre a integração. Ao incluir a opção de permitir o usuário continuar conversando com a AI, é preciso construir mais um fluxo de pergunta. Para isso, siga os mesmos passos que ensinamos anteriormente, mas com algumas exceções de configurações diferentes: - É preciso criar uma nova variável para o segundo fluxo de pergunta e resposta. Ela deve ser incluída e configurada igual no primeiro fluxo de pergunta e resposta; - Inclua o conversationId que foi gerado na primeira pergunta do usuário. - Nesse segundo fluxo de conversa não é necessário salvar o converationId, já que ele é gerado na primeira pergunta e pode ser utilizado no body para indicar para a sua IA que a pergunta 2 esta dentro de uma mesma conversa e não é preciso gerar uma nova conversa. - Inclua no fluxo o bloco Pular, da categoria "Condicionais" e no campo "Selec a group" selecione o grupo que coleta a segunda pergunta. Com isso, a conversa entrará em um ciclo repetitivo e o usuário poderá fazer novas perguntas para a IA nessa mesma conversa. Pronto! Agora você já sabe como integrar o Toolzz Bots com o Toolzz AI.

Última atualização em Dec 13, 2024

COMO CONFIGURAR A MEMÓRIA DO BOT PARA LEMBRAR ATRIBUTOS COLETADOS?

Sobre A memória do bot é uma funcionalidade essencial para oferecer uma experiência mais personalizada e fluida aos seus usuários. Com ela, o bot consegue lembrar atributos previamente coletados, evitando que o usuário precise repeti-los em interações futuras. Neste artigo, vamos mostrar como configurar a memória do bot no Toolzz Bots, detalhando o fluxo necessário (que pode ser criado do zero ou adaptado a partir de um template) e as configurações essenciais para que tudo funcione perfeitamente. Configurando a memória do bot através de um template Para facilitar ainda mais a configuração do seu bot para que ele lembre atributos coletados de um usuário, você pode utilizar um template pronto. Esses modelos são pré-configurados com os principais fluxos e funcionalidades já integradas, permitindo que você economize tempo e comece rapidamente. 1º passo: na página inicial, clique em "Criar um bot" e depois na opção "Comece a partir de um modelo". 2º passo: utilize a barra de rolagem para encontrar a seção "Customer Success" e escolha o modelo "Análise de Satisfação do Cliente". Repare que na janela ao lado será mostrada uma pequena prévia do modelo de bot. ​ Clique no botão "Usar esse modelo". A plataforma vai te redirecionar para a tela de edição do bot. Por ser um modelo pronto, o fluxo do bot já estará construído, agora, basta você fazer os ajustes necessários, como editar as perguntas que o bot vai fazer ao usuário e outras configurações que achar necessárias de acordo com o objetivo do seu fluxo. Criando um fluxo para configurar a memória do bot Se preferir mais controle e personalização, você pode construir do zero o fluxo que vai configurar a memória do bot para lembrar atributos. Essa opção permite adaptar cada etapa às suas necessidades específicas, criando uma solução única e totalmente alinhada aos seus objetivos. 1º passo: na página inicial, clique em "Criar um bot" e depois escolha a opção "Comece do zero". ​2º passo: adicione um bloco de condição da categoria "Condicionais" para conferir se a variável já foi coletada. Para isso, clique em "Configure" e depois no botão "Adicionar comparação". 3º passo: no campo "Pesquise um variável" escolha uma variável e em "Selecione um operador" clique na opção "Is set". Com esta configuração, este bloco de condição vai conferir se a variável "Nome" está definida, ou seja, se esta informação foi coletada do usuário e armazenada nesta variável. 4º passo: agora, você precisa continuar construindo o fluxo criando dois caminhos diferentes. Se o bot já tiver coletado a variável Se a informação já foi coletada e armazenada na variável, o usuário poderá passar para a próxima parte do fluxo. No caso do nosso exemplo: se o nome do usuário já foi coletado e armazenado na variável "nome" ele passa para a próxima pergunta, que é para coletar seu sobrenome. Insira outro bloco de condição e configure do mesmo jeito mostrado no passo anterior, só que agora, escolhendo outra variável. No nosso exemplo, vamos escolher "sobrenome". Se o bot não tiver coletado a variável Se a informação não foi coletada e armazenada em uma variável, será preciso fazer isso para que, só assim, o usuário consiga seguir no fluxo. No caso do nosso exemplo: precisamos coletar o nome do usuário e armazenar na variável. Para isso vamos adicionar o bloco de texto da categoria "Bubbles" e escrever a pergunta "Qual o seu nome?". Depois, adicionar ao mesmo grupo um bloco de Texto da categoria "Inputs" e definir em qual variável a informação será salva. No exemplo: "nome". Para finalizar esta parte do fluxo, após dar a primeira informação, o usuário precisa ser direcionado para a próxima pergunta de coleta. No nosso exemplo, é a coleta do sobrenome. Para isto, adicione o bloco de Pular da categoria "Condicionais" e selecione o nome do grupo que está a continuação do fluxo. No nosso fluxo de exemplo, será o grupo que confere se o sobrenome já foi coletado e armazenado em uma variável. Agora, é só continuar construindo seu fluxo de acordo com o objetivo do seu bot e sempre que precisar que o bot armazene e lembre de uma informação coletada, seguir os passo acima. Configurações obrigatórias para a memória do bot Essas configurações precisam ser realizadas se você está criando um bot do zero. Caso esteja usando um template, elas já estarão configuradas dessa forma. 1º passo: na página do bot, no menu superior, acesse a aba "Configurações". 2º passo: configure as opções da parte "Geral". - Clique na chave de ativação da opção "Preencher inputs". Repare que ela fica colorida quando ativada. Dessa forma, as entradas serão pré-preenchidas, automaticamente, sempre que sua variável associada tiver um valor; - Clique na chave de ativação da opção "Lembrar usuário". Repare que ela fica colorida quando ativada. Essa configuração permite salvar o estado da sessão de bate-papo no armazenamento do navegador do usuário. Isso significa que se ele responder a uma pergunta e fechar o chat, na próxima vez que ele abrir, o chat estará no mesmo estado de antes; - No campo "Armazenamento", existem duas opções de armazenamento: - Armazenamento da sessão: o estado do bate-papo será salvo no navegador do usuário. Ele estará disponível apenas no mesmo dispositivo e navegador, mas será excluído quando o usuário fechar a guia atual ou o navegador. - Armazenamento local: o estado do bate-papo será salvo no navegador do usuário e será lembrado permanentemente. Ele estará disponível apenas no mesmo dispositivo e navegador da web. Recomendamos escolher a opção "Local". Pronto! Agora você já sabe como configurar a memória do bot para lembrar os atributos coletados.

Última atualização em Dec 13, 2024