Conceitos básicos do Bot Builder
Este guia vai te ajudar a entender os elementos principais para construir fluxos conversacionais usando o Bot Builder da WOZTELL. Com esse conhecimento, você poderá criar automações que atendam de forma eficaz às necessidades reais do negócio.
Tipos de nós
Antes de configurar o chatbot, é essencial entender os tipos de nós disponíveis e quando utilizá-los:
Nó geral
-
Descrição: Um nó básico do chatbot usado para construir a conversa e definir o fluxo do usuário.
-
Quando usar: Para exibir uma mensagem, pergunta ou ação como parte do fluxo principal.
-
Funcionalidade: Envia conteúdo ao usuário e define o próximo passo do fluxo.
-
Exemplo: Solicitar o e-mail do usuário ou exibir uma mensagem de boas-vindas.

Nó global
-
Descrição: Um nó que pode ser ativado a qualquer momento, independentemente de onde o usuário esteja na conversa.
-
Quando usar: Para lidar com ações gerais ou interrupções disponíveis em todo o chatbot.
-
Funcionalidade: Escuta por condições ou eventos específicos e ativa um fluxo predefinido.
-
Exemplo: Acionar o fluxo "Falar com um humano" quando o usuário digitar "agente" ou "ajuda".

-
Descrição: Um nó que processa ou transforma dados do usuário sem enviar nenhuma mensagem.
-
Quando usar: Para avaliar, validar ou manipular informações antes de continuar a conversa.
-
Funcionalidade: Executa operações lógicas ou de backend (por exemplo, verificar o formato de entrada, comparar com dados do CRM).
-
Exemplo: Verificar se um número é válido antes de redirecionar para um fluxo de pagamento.
-
Descrição: Um nó transformador que pode ser ativado de qualquer lugar dentro do chatbot.
-
Quando usar: Para executar operações ou validações de dados de forma global.
-
Funcionalidade: Executa lógica de processamento em segundo plano em todos os fluxos.
-
Exemplo: Verificar automaticamente entradas de usuário de qualquer nó e marcar o contato como válido.

Criar um novo nó
Clique em “+” e selecione o tipo de nó que você precisa criar.
Tipos de gatilhos
Os gatilhos permitem que o chatbot responda automaticamente a eventos específicos ou comportamentos do usuário.
1. Gatilhos predefinidos
Esses gatilhos respondem a diferentes tipos de interações sem a necessidade de palavras-chave específicas.
-
Qualquer entrada do usuário: Responde a qualquer mensagem enviada pelo usuário.
-
Qualquer texto: É ativado por qualquer mensagem de texto.
-
Qualquer payload: É ativado quando o usuário interage com um botão que contém um payload.
-
Qualquer comentário: É ativado quando o usuário comenta em uma publicação (por exemplo, em redes sociais).
-
Qualquer número: É ativado quando o usuário envia uma mensagem com números.
-
Qualquer e-mail: É ativado se a mensagem incluir um endereço de e-mail.
-
Qualquer mídia/arquivo: É ativado quando o usuário envia imagens, áudios, vídeos ou outros arquivos.

2. Palavra-chave / Payload
-
Nota: Diferencia maiúsculas e minúsculas.
-
Limitação: Funciona apenas com botões, não com texto digitado manualmente.
Exemplo:
Acionar "Saudação" com palavras-chave como:
Opções avançadas:
-
Diferenciar maiúsculas: Distingue entre "oi" e "Oi".
-
Limite de palavra: Só aciona se a palavra estiver sozinha ("sol" não aciona dentro de "solução").
-
Igual: Só aciona se a mensagem for exatamente igual à palavra-chave. Desativa as outras duas opções.
3. Parâmetros de referência
Usados para identificar de onde o usuário veio ao acessar o bot por um link do Messenger.
Exemplo:
Isso ajuda a rastrear a origem das campanhas.
4. Comentário no Facebook | Comentário no Instagram
Permite que o chatbot responda automaticamente quando um usuário comentar em uma publicação específica.
Requisitos:
5. Gatilho de pedido
Usado quando o seu eCommerce está configurado no WhatsApp para acionar uma ação quando um pedido é realizado.
É ativado quando os usuários iniciam o chat através de um anúncio da Meta (Facebook ou Instagram).
7. Gatilho agendado
Ativa um fluxo em datas ou horários específicos.
Exemplo: Campanhas automatizadas que funcionam apenas em dias úteis ou durante o horário comercial.

8. Fluxo do WhatsApp
Permite executar ações quando um usuário completa um fluxo de chatbot no WhatsApp.
Ideal para: Enviar follow-ups ou acionar fluxos pós-interação.
9. Mover conversa para pasta específica
É acionado quando um chat é movido para uma pasta específica dentro da caixa de entrada.
Exemplo: Se uma conversa for movida para “Pronto para demonstração”, o bot pode enviar uma mensagem ou atribuir um agente.

Criar um novo gatilho
Selecione o nó ao qual você deseja adicionar um gatilho e clique em “Novo gatilho” no painel à direita.
Tipos de ações
As ações são tarefas que o chatbot executa internamente ou ao se conectar com ferramentas externas. Elas ajudam a automatizar fluxos, gerenciar conversas e integrar com plataformas como Zoho, Stripe ou Meta. Você pode configurar ações para que sejam executadas antes ou depois de uma mensagem, dependendo da lógica do fluxo.
-
Anexar ID de comentário: Associa um comentário à conversa.
-
Criar ticket no Livechat: Cria um ticket no Zoho Desk.
-
Enviar e-mail: Envia um e-mail automático.
-
ChatGPT Text Completion: Usa IA para gerar ou completar texto.
-
Mover conversa para pasta: Move uma conversa para uma pasta específica.
-
Adicionar/Remover agentes no Zoho Cliq: Gerencia agentes no Zoho Cliq.
-
Inserir/Buscar/Atualizar registro no Zoho CRM: Gestão completa de registros no CRM.
-
Gerar pagamento com Stripe: Processa pagamentos diretamente no chatbot.
-
Mencionar todos no canal (Zoho Cliq): Marca todos os usuários em um canal.
-
Alterar agente da conversa (Inbox): Reatribui a conversa a outro agente.
-
Salvar dados temporários: Armazena dados temporários como nome ou e-mail.
-
Inscrever / Cancelar inscrição: Gerencia assinaturas de usuários.
-
Ativar / Desativar chat ao vivo: Ativa ou desativa o suporte humano.
-
Definir / Remover agenda: Programa ou remove ações futuras.
-
Alterar idioma: Altera o idioma do chatbot ou da conversa atual.
-
Chamar API: Executa chamadas a APIs externas.
-
Salvar dados do contato em fonte de dados: Armazena dados do usuário no banco de dados da WOZTELL.
-
Enviar evento de conversa: Envia eventos de conversão para o Meta para rastreamento de campanhas.
-
Atribuição automática de agente (Inbox): Atribui automaticamente agentes com base na disponibilidade ou carga de trabalho.

Criar uma nova ação
Você pode criar uma ação que seja executada antes ou depois do nó. Para isso, selecione o nó correspondente e clique em “+ Nova ação” em “Ações prévias” ou “Ações posteriores”.
Tipos de respostas
A plataforma da WOZTELL, por meio da API do WhatsApp Cloud, permite que o chatbot envie uma variedade de tipos de mensagens para criar conversas ricas, interativas e amigáveis para o usuário.
-
Vídeo: Compartilhe vídeos de demonstração de produtos, tutoriais ou mensagens de boas-vindas.
-
Áudio: Envie mensagens de voz curtas, áudios ou confirmações.
-
Imagem: Envie imagens para complementar a mensagem, mostrar produtos ou reforçar o apelo visual.
-
Texto: Mensagens de texto padrão para compartilhar informações ou fazer perguntas.

Criar uma nova resposta
Para criar uma nova resposta, você precisa selecionar o nó correspondente e clicar em “+ Nova resposta” no painel à direita.
Redirecionamento
O redirecionamento permite mover os usuários para outro nó dentro do fluxo de conversa. Inclui as seguintes propriedades:
Uso comum: Quando etapas ou validações adicionais são necessárias antes de continuar.
Marcação de contatos
A marcação automática ajuda a classificar e segmentar os usuários com base em seu comportamento.
Benefício: Personaliza a experiência e facilita o rastreamento e filtragem futura.
Análises
Ativar as análises dentro do fluxo ajuda a coletar métricas de desempenho:
-
Taxas de conversão
-
Interações por nó
-
Usuários únicos
Melhor prática: Use esses dados para melhorar os fluxos e orientar decisões de otimização.

Mais informações sobre os elementos do Bot Builder:
Para informações mais detalhadas sobre cada um dos elementos do construtor de chatbots, acesse os artigos da base de conhecimento
aqui.