Por favor, observe!

SEUS PROJETOS NUNCA SÃO EXCLUÍDOS e permanecem na plataforma indefinidamente.

Após o vencimento da assinatura, os seguintes dados serão removidos:

Conexões de mensageiros: desativadas após 3 semanas.

Mensagens longas: aquelas com mais de 800 caracteres são excluídas após 3 meses.

Conversas: todos os chats são armazenados por 2 a 6 meses.

Clientes: removidos após 1 ano.

Informações adicionais:

Mensagens não entregues são mantidas por 2 semanas.

Acesso ao mensageiro: revogado 3 semanas após o vencimento se nenhum pagamento for feito.

Limites do sistema:

Mensagens agendadas: Máximo de 32 por cliente.

Bots de teste: Limitados a 1.000 mensagens/dia (incluindo mensagens de contas de teste).

Como criar o primeiro bloco em um funil

Todo chatbot construído no MaviBot é composto por blocos.

Um bloco é um conjunto de comandos e configurações do chatbot, configurado por você ou por nossos desenvolvedores para o seu projeto.

Cada bloco fornece ao bot instruções sobre como responder ou agir, e determina para onde o cliente deve ir a seguir no funil.

Criar um bloco é simples: clique duas vezes em qualquer espaço vazio na área de trabalho para começar.

Você pode mover um bloco (ou vários blocos) para qualquer lugar dentro da tela do construtor para otimizar o layout e dar ao seu funil uma aparência mais limpa e organizada.

Para facilitar o entendimento, vamos percorrer um diagrama de funil de exemplo e explicar como o editor funciona usando esse exemplo.

Você está vendo um fluxo de chatbot. O fluxo consiste em blocos e conexões.

Bloco inicial (Verde): É onde toda conversa começa.

Blocos de gatilho (Cinza escuro): Esses blocos ativam fluxos específicos com base nas ações do usuário.

Quando um usuário envia uma mensagem ou clica em um botão, ele pode passar de um bloco para outro — mas somente se a condição de transição for atendida. As condições podem ser definidas tanto nos blocos quanto nos Conectores.

Para fazer o bot ser iniciado quando um usuário clicar no botão "Iniciar" no Telegram (ou em qualquer outro mensageiro), você precisa especificar uma palavra de gatilho no bloco verde.

Os blocos de gatilho vêm em duas cores: verde e cinza.

Existem quatro tipos de blocos de condição:

  1. Iniciar
  2. Gatilho

O bloco "Iniciar" tem a maior prioridade entre todos os blocos de condição — o que significa que ele será acionado primeiro se sua condição corresponder a qualquer uma das ações do cliente.

Passo 1: Crie um bloco "Chat"

Para fazer isso, clique em qualquer lugar na tela vazia do construtor de fluxo.

É bom saber!
O que é a construção #{none}?
A construção #{none}, que aparece por padrão no campo de resposta, é um espaço reservado especial usado para lidar com entradas não especificadas ou gerais.

Isso significa, por exemplo, que um bloco de condição com #{none} será acionado quando um cliente enviar qualquer mensagem (se nenhuma palavra-chave ou gatilho específico for definido).
Se você deixar #{none} no campo de mensagem, isso permite direcionar clientes para um bloco de funil específico, independentemente do conteúdo da mensagem.

Para criar um bloco que não envia mensagem, insira #{none} no campo de resposta (isso é definido por padrão).

Em seguida, clique no bloco e selecione seu tipo — "Iniciar".

  1. Selecione o tipo de bloco "Iniciar" . Isso abrirá o painel de configurações de condição.
  2. Para este primeiro teste no modo interno do MaviBot, defina uma palavra de gatilho simples como "Olá" .

Agora, configure a resposta do bot para quando o gatilho for ativado. Por exemplo, insira a mensagem: "Olá! Como posso ajudá-lo?"

Em seguida, certifique-se de clicar em "Salvar" para que todas as configurações sejam aplicadas ao bloco:

Passo 2: Crie o próximo bloco

Para criar um novo bloco e conectá-lo ao anterior, abra o menu de configurações adicionais do bloco.

Para construir um fluxo de conversa contínuo, seus blocos precisam estar conectados. Veja como fazer isso rapidamente:

  1. Localize e abra o menu de configurações adicionais do bloco a partir do qual você deseja conectar (por exemplo, seu bloco "Iniciar").
  2. Encontre e clique no botão rotulado "Criar um bloco abaixo."

Agora seu funil contém dois blocos que estão conectados.

Por favor, observe!

O que isso significa na prática?

Se o seu bot tiver dois fluxos de conversa separados, um usuário não pode passar por ambos simultaneamente. Eles seguirão um fluxo ou o outro, mas nunca ambos ao mesmo tempo.

Precisa enviar uma mensagem sem interromper o fluxo atual deles?

Use blocos cinza — "Fallback" ou "Gatilho" — para enviar mensagens separadas sem interromper a conversa ativa do usuário.

Conectores entre blocos guiam o cliente através do fluxo do funil.

Você também pode definir condições diretamente nos conectores. Isso permite controlar o fluxo, por exemplo, tornando um clique em botão ou um pagamento bem-sucedido um requisito para avançar.

Vamos criar um botão no bloco "Chat" para que o cliente possa ir para o próximo bloco.

Passo 3. Crie um botão

Clique no bloco "Iniciar" . Você verá uma guia "Botões" :

Clique na guia — isso abrirá o menu de configurações do botão.

Clique em "+ Adicionar Botão" , e um menu de configurações do botão aparecerá.

No campo de texto do botão, insira qualquer rótulo que você goste — por exemplo, "IR" .

Clique em "Adicionar" , e o botão aparecerá nas configurações do bloco.

Os botões podem ser exibidos de duas maneiras: no teclado da mensagem ou diretamente no texto da mensagem.

Observe que alguns tipos de botão podem não ser suportados em certos mensageiros (como WhatsApp).

Para compatibilidade ideal, use a opção "Automático" . Isso exibirá automaticamente o botão no formato mais bem suportado por cada mensageiro específico.

E não se esqueça de salvar as configurações do bloco.

Tudo pronto! Você criou seu primeiro bloco de gatilho com um botão! 🎉

Passo 4. Configure a conexão

Vamos configurar o conector para que, quando um cliente clicar no botão, ele vá para o próximo bloco.

Veja como:

  1. Localize a seta (conector) que sai do seu bloco de botão.
  2. Passe o cursor sobre a seta.
  3. Clique no ícone de engrenagem que aparece para abrir suas configurações.

As configurações da conexão serão abertas, onde você precisa escolher o botão que criou.

Em seguida, você precisa escolher "Correspondência exata" no "Tipo de correspondência" :

E clique em "Salvar" .

Depois de salvar as configurações da conexão, a condição será exibida diretamente no conector. Isso fornece uma referência visual clara do que aciona a transição entre os blocos.

A conexão pode ser curvada:

Isso permite que você veja claramente conexões que se sobrepõem. Para fazer isso, pegue a seta com o mouse no ponto em que deseja curvá-la e arraste-a para o local desejado.
Não há limite para o número de curvas que você pode fazer.

Para excluir curvas desnecessárias de um conector, basta clicar duas vezes no nó desejado com o botão esquerdo do mouse.

Passo 5. Bloco "Chat"

Por padrão, quando você clicou na tela anteriormente, um bloco "Chat" branco foi criado — este é o bloco mais comumente usado ao construir fluxos de chatbot.

Você pode configurar quase tudo dentro de um bloco "Chat" (exceto condições). Na verdade, a maior parte do seu chatbot provavelmente consistirá em blocos "Chat" .

Ao contrário dos blocos de condição, um bloco "Chat" só pode ser acessado se:

  • Ele estiver conectado por uma conexão de um bloco anterior, ou
  • Você enviou um mailing que direciona os usuários para ele.

Se você quiser que o cliente entre no bloco com base em um gatilho, o gatilho deve ser definido:

  • Na conexão (como mostrado no Passo 4), ou
  • Usando um temporizador.

No bloco "Chat" : insira a mensagem que o bot enviará ao cliente (quando eles clicarem no botão no bloco "Iniciar" ).

Certifique-se de clicar em "Salvar" nas configurações do bloco "Chat" .

Você criou seu primeiro chatbot!

Tutorial em vídeo

https://www.youtube.com/watch?v=RMYNdF8gq_w

Teste do chatbot

Após criar — ou mesmo durante a construção — de qualquer chatbot, é importante testar o bot para garantir que seus fluxos funcionem corretamente e as configurações estejam adequadas.

Você pode conectar o bot a um projeto e testá-lo lá. No entanto, se você criar um bot para WhatsApp, lembre-se de que você não pode enviar mensagens para si mesmo.

É por isso que existe outra maneira: você pode abrir um chat online com o bot e interagir diretamente com ele.

Para fazer isso, clique no botão no canto inferior esquerdo do construtor:

Quando você clica no botão "Testar chatbot" , uma janela de teste será aberta.

A área esquerda da janela de teste exibe os blocos que você criou para o chatbot.

No lado direito, você verá os dados do cliente de teste — ou seja, seu próprio perfil de usuário simulado.

No centro da tela, você verá o chat online onde pode testar o bot. Para fazer isso, digite a frase de gatilho do bloco "Iniciar" .

Veja como o bot funciona:

Parabéns! 🎉 Você construiu com sucesso um chatbot funcional que inclui:

  • Configuração de gatilho tanto em blocos quanto em conectores
  • Um botão totalmente operacional
  • Teste em tempo real que permitiu ver exatamente como seu chatbot funciona

Sobre a guia "Teste"

Após criar o fluxo do chatbot no modo de teste, você verá todos os painéis com informações sobre os blocos à esquerda.

Cada painel no lado esquerdo da tela exibe o número do bloco, seu tipo e seu conteúdo.

Você pode filtrar e exibir blocos por seu tipo usando o botão "Filtrar" correspondente.

Para testar a execução de um único bloco do fluxo, você pode selecionar o bloco correspondente clicando nele e depois clicar em "Enviar bloco."

O bloco selecionado será enviado em nome do chatbot na seção do meio da tela — a janela de teste.

Nesta mesma área, você pode testar todo o fluxo de blocos começando pelo primeiro bloco no diagrama.

Você não precisa começar a testar o fluxo do chatbot desde o início: por exemplo, se você adicionou novos blocos ao seu fluxo, pode usar o recurso "Enviar bloco" e começar a testar o fluxo a partir do bloco selecionado.

No lado direito da tela, você encontrará a visualização do cliente de teste.

Nesta mesma janela do cliente, os seguintes recursos estão disponíveis:

– Atribuir ou adicionar tags/listas ao cliente;

– Adicionar variáveis;

– Visualizar as variáveis atribuídas ao cliente através da execução do fluxo do chatbot.

Dessa forma, você pode testar completamente o fluxo do chatbot (ou qualquer parte dele) e visualizar imediatamente o cartão do cliente e seus dados.

Opções de resposta no bot

Agora vamos adicionar uma pergunta com múltiplas opções de resposta ao nosso fluxo inicial. As opções de resposta são representadas por conectores saindo do bloco. Um conector terá a condição "Sim" e o outro — "Não."

Para fazer isso, clique no segundo bloco chamado "Chat" e crie dois blocos abaixo dele usando o menu de configurações adicionais.

Agora que adicionamos dois blocos ao nosso fluxo, o próximo passo é configurar o gatilho em sua conexão.

Veja como:

  1. Passe o mouse sobre o conector (seta) que leva ao segundo bloco.
  2. No campo de gatilho que aparece, insira a resposta do usuário que deve ativar este caminho, por exemplo, "Sim" .

Em seguida, certifique-se de salvá-lo. Depois disso, especifique a outra opção de resposta nas configurações da segunda seta também.

No bloco anterior, de onde se originam as duas setas com opções de resposta, insira qualquer pergunta.

Agora, nos blocos "Chat" para os quais a conexão com opções de resposta leva, insira a mensagem de resposta do bot.

Agora o fluxo final se parece com o seguinte:

Veja como este fluxo funciona:

  1. O usuário digita "Olá" e entra no bloco verde.
  2. Em seguida, o usuário clica em um botão e vai para o segundo bloco;
  3. O usuário digita "Sim" ou "Não" e prossegue para um dos estados dependendo da resposta.

Mas e se o usuário digitar outra coisa — nem "Sim" nem "Não" ? A conversa não irá para nenhum dos estados seguintes e ficará presa no estado atual. O diálogo irá parar.

Como criar um loop

Para evitar que o bot fique em silêncio quando um usuário envia uma mensagem que não corresponde a nenhum dos gatilhos nos conectores, adicionaremos um loop.

Para fazer isso, faça um loop na pergunta adicionando uma seta sem nenhum gatilho que aponte de volta para o mesmo bloco.

É bom saber!
Blocos e conexões sem gatilhos têm prioridade menor do que aqueles com gatilhos.

Para criar um loop, clique no bloco onde você faz a pergunta ao cliente. No formulário de configurações que se abre, clique nos três pontos no canto superior direito e selecione "Criar um loop."

Isso criará um loop no fluxo.

Agora, se o cliente enviar uma mensagem ao bot que seja diferente de "Sim" ou "Não" , a mensagem do segundo bloco será enviada novamente.

E se o cliente não responder à mensagem do bot?

Você pode enviar mensagens de acompanhamento usando um temporizador para lembrar o cliente de que uma resposta é necessária.

Então, quando o usuário entrar no bloco com a pergunta "Você está feliz?" , e não responder com "Sim" ou "Não" , queremos enviar uma mensagem como: "Você não respondeu à pergunta :(" e depois fazer a pergunta novamente.

Para fazer isso, usaremos um temporizador.

Como criar uma mensagem com temporizador

Vamos criar um novo bloco para o qual a seta do bloco "Você está feliz?" levará, e também remover o loop.
Para fazer isso, passe o mouse sobre o loop e clique no ícone de cruz para excluí-lo.

Agora, vá para as configurações da seta que leva ao novo bloco a partir do bloco de pergunta.

Nas configurações da seta, há um painel chamado "Atraso antes da resposta" — este é um temporizador que define a quantidade de tempo após a qual o fluxo prosseguirá automaticamente para o próximo bloco.

Você também deve ativar a caixa de seleção "Cancelar se saiu do bloco" para que a mensagem não seja enviada se o cliente responder à pergunta.

Agora, vamos inserir a mensagem no novo bloco:

E a partir do novo bloco, desenhe uma conexão de volta ao bloco de pergunta.

Para fazer isso, passe o mouse sobre o bloco — você verá um ponto aparecer que permite criar uma conexão:

Passo 1. Clique no botão e arraste o conector para o bloco com a pergunta.

Passo 2. Os dois conectores se sobreporão, então você precisará arrastar um deles para cima.

Para fazer isso, passe o mouse sobre os conectores e procure pela alça alongada — use-a para ajustar a curva e separar a conexão.

Passo 3. Em seguida, clique e segure o conector e arraste-o para cima.

Agora vá para as configurações da seta recém-criada e defina um temporizador de 1 segundo, para que o cliente seja redirecionado de volta ao bloco de pergunta.

O fluxo final se parece com o seguinte:

Você criou com sucesso seu primeiro chatbot — completo com botões, conectores, opções de resposta, loops e setas de redirecionamento com temporizador!

Como adicionar estágios de funil (listas)

Usando estágios de funil (listas), você pode organizar seu bot da maneira que for mais conveniente para você. Ainda é um grande espaço de trabalho onde todos os ramos do bot estão localizados, mas visualmente é dividido em páginas separadas. O bot em si continua operando como um único fluxo.

Quando cadeias de fluxo são divididas entre listas, blocos de vinculação são criados automaticamente.

Para adicionar uma nova lista, clique no ícone de mais no canto inferior direito do espaço de trabalho e insira o nome da nova lista.

Para continuar o fluxo atual em uma nova lista, clique em um bloco ou selecione vários blocos, depois clique na seta↪️ com a dica de ferramenta "Clique para mover itens selecionados para outra lista."

Quando o aviso sobre mover blocos aparecer, escolha a lista desejada no menu suspenso na parte inferior perto do ícone de mais.

Na janela que se abre, você verá instruções sobre o que precisa ser feito para concluir a transferência.

Como conectar mensageiros

Após o teste, você pode conectar o fluxo aos mensageiros. Para fazer isso, vá para a seção Mensageiros no menu principal.

Em seguida, você precisa clicar no botão do mensageiro desejado.

Leia como conectar bots em diferentes mensageiros no artigo "Mensageiros" .