Como criar um chatbot
Novo no MaviBot? Comece com nosso guia.
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 com o Messenger: 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 Messenger: 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 criado 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 em seguida no funil.
Criar um bloco é simples: dê um duplo clique 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 área do construtor para otimizar o layout e deixar seu funil com uma aparência mais limpa e organizada.
Para facilitar a compreensão, vamos passar por 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): É aqui que 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 em ambos os blocos e Conectores.

Para fazer o bot iniciar 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:
Start
Gatilho
A aba "Iniciar" bloco tem a maior prioridade entre todos os blocos de condição — o que significa que ele será acionado primeira se sua condição corresponder a qualquer uma das ações do cliente.
Etapa 1: Crie um bloco "Chat"
Para fazer isso, clique em qualquer lugar na tela em branco do construtor de fluxo.

Bom saber!
O que é a #{none} construção?
O #{none} construção, que aparece por padrão no campo de resposta, é um espaço reservado especial usado para lidar com entradas não especificadas ou genéricas.
Isso significa, por exemplo, que um bloco de condição por #{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 da mensagem, isso permite que você encaminhe os clientes para um bloco específico do funil, independentemente do conteúdo da mensagem.
Para criar um bloco que não envia uma mensagem, digite #{none} no campo de resposta (isso vem definido por padrão).
Em seguida, clique no bloco e selecione seu tipo — "Iniciar".

Selecione o "Start" tipo de bloco. Isso abrirá o painel de configurações de condição.
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 ajudar você?"

Em seguida, não se esqueça de clicar em "Salvar" para que todas as configurações sejam aplicadas ao bloco:

Etapa 2: Crie o próximo bloco
Para criar um novo bloco e conectá-lo ao anterior, abra as menu de configurações adicionais.

Para construir um fluxo de conversa contínuo, seus blocos precisam estar conectados. Veja como fazer isso rapidamente:
Localize e abra as menu de configurações adicionais do bloco do qual você quer conectar a partir (por exemplo, seu bloco "Iniciar").
Encontre e clique no botão chamado "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 fluxosde conversa separados, um usuário não pode passar por ambos simultaneamente. Ele seguirá um fluxo ou outro, mas nunca os dois ao mesmo tempo.
Precisa enviar uma mensagem sem interromper o fluxo atual?
Use blocos cinza — seja "Fallback" ou "Trigger" — para enviar mensagens separadas sem interromper a conversa ativa do usuário.
Conectores entre blocos guiam o cliente pelo fluxo do funil.
Você também pode definir condições diretamente nos conectores. Isso permite controlar o fluxo, por exemplo, exigindo um clique em um botão ou um pagamento bem-sucedido para avançar.
Vamos criar um botão no bloco “Chat” para que o cliente possa passar para o próximo bloco.
Etapa 3. Crie um botão
Clique na bloco “Iniciar”. Você verá uma “Botões” :

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

Clique “+ Adicionar botão”, e um menu de configurações do botão aparecerá.

No campo de texto do botão, digite qualquer rótulo que desejar — por exemplo, “VAMOS”.

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

Os botões podem ser exibidos de duas formas: no teclado da mensagem ou diretamente dentro do texto da mensagem.
Observe que alguns tipos de botões podem não ser compatíveis em certos mensageiros (como o WhatsApp).
Para melhor compatibilidade, use a opção "Automático" . Isso exibirá automaticamente o botão no formato mais compatível com cada mensageiro específico.

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

Pronto! Você criou seu primeiro bloco de gatilho com um botão! 🎉
Etapa 4. Configure a conexão
Vamos configurar o conector para que, quando um cliente clicar no botão, ele passe para o próximo bloco.
Veja como:
Localize a seta (conector) que sai do seu bloco com botão.
Passe o cursor sobre a seta.
Clique no ícone de engrenagem que aparece para abrir as configurações.

As configurações da conexão serão abertas, e você precisará escolher o botão criado por você.

Depois, você precisa escolher "Correspondência exata" no campo "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 para o que dispara a transição entre blocos.

A conexão pode ser curvada:

Isso permite ver claramente conexões que se sobrepõem. Para fazer isso, segure a seta com o mouse no ponto em que você 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 remover curvas desnecessárias de um conector, basta dar um duplo clique com o botão esquerdo do mouse no nó desejado.
Etapa 5. bloco “Chat”
Por padrão, quando você clicou na tela anteriormente, foi criado um bloco branco “Chat” — 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 será composta por “Chat” blocos.

Ao contrário dos blocos de condição, um “Chat” bloco só pode ser acessado se:
Ele estiver conectado por uma conexão de um bloco anterior, ou
Você tiver enviado uma campanha que direciona os usuários até ele.
Se você quiser que o cliente entre no bloco com base em um gatilho, o gatilho deve ser definido em:
Na conexão (como mostrado na Etapa 4), ou
Usando um bloco de temporizador.
Na "Chat" : insira a mensagem que o bot enviará ao cliente (quando ele clicar no botão no "Start" bloco).

Não se esqueça de clicar em “Salvar” no campo “Chat” configurações do bloco.
Agora você criou seu primeiro chatbot!
Tutorial em vídeo
Teste de chatbot
Depois de criar — ou até mesmo enquanto estiver construindo — qualquer chatbot, é importante testar o bot para garantir que seus fluxos funcionem corretamente e que as configurações estejam definidas adequadamente.
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 forma: você pode abrir um chat online com o bot e interagir com ele diretamente.
Para fazer isso, clique no botão no canto inferior esquerdo do construtor:

Quando você clicar no botão “Testar chatbot” , uma janela de teste será aberta.

O á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.

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

Veja como o bot funciona:

Parabéns! 🎉 Você construiu com sucesso um chatbot funcional que inclui:
Configuração de gatilho em ambos os blocos e conectores
Um botão totalmente operacional
Teste em tempo real que permitem ver exatamente como o seu chatbot funciona
Sobre a aba "Teste"
Depois de 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 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 "Enviar bloco."

O bloco selecionado será enviado em nome do chatbot na seção central da tela — a janela de teste.
Nessa mesma área, você pode testar todo o fluxo de blocos começando pelo primeiro bloco do 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.

Nessa mesma janela do cliente, estão disponíveis os seguintes recursos:
– Atribuir ou adicionar tags/listas ao cliente; – Adicionar variáveis; – Visualizar as variáveis atribuídas ao cliente por meio da execução do fluxo do chatbot.
Dessa forma, você pode testar totalmente 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 várias opções de resposta ao nosso fluxo inicial. As opções de resposta são representadas por conectores que saem 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 na conexão entre eles.
Veja como:
Passe o mouse sobre o conector (seta) que leva ao segundo bloco.
No campo de gatilho que aparece, insira a resposta do usuário que deve ativar esse caminho, por exemplo, "Sim".

Em seguida, não se esqueça de salvar. Depois disso, especifique também a outra opção de resposta nas configurações da segunda seta.

No bloco anterior, do qual partem as duas setas com opções de resposta, insira qualquer pergunta.

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

Agora o fluxo final fica assim:

Veja como esse fluxo funciona:
O usuário digita “Olá” e entra no bloco verde.
Depois, o usuário clica em um botão e passa para o segundo bloco;
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 avançará para nenhum dos estados seguintes e permanecerá travada no estado atual. O diálogo vai parar.
Como criar um loop
Para evitar que o bot fique sem responder quando um usuário envia uma mensagem que não corresponde a nenhum dos gatilhos nos conectores, vamos adicionar 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 uma prioridade menor do que os com gatilhos.
Para criar um loop, clique no bloco em que você faz uma pergunta ao cliente. No formulário de configurações que abrir, clique nos três pontos no canto superior direito e, em seguida, selecione “Criar um loop.”

Isso criará um loop no fluxo.

Agora, se o cliente enviar uma mensagem para o 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 bloco de temporizador para lembrar ao cliente que é necessária uma resposta.
Então, quando o usuário entra no bloco com a pergunta “Você está feliz?”, e não responde com “Sim” ou “Não”, queremos enviar uma mensagem como:“Você não respondeu à pergunta :(” e então fazer a pergunta novamente.
Para isso, vamos usar 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 do bloco da pergunta para o novo bloco.

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

Você também deve ativar a caixa de seleção “Cancelar se sair do bloco” para que a mensagem não seja enviada caso o cliente responda à pergunta.

Agora, vamos inserir a mensagem no novo bloco:

E, a partir do novo bloco, desenhe uma conexão de volta para o bloco da pergunta.
Para fazer isso, passe o mouse sobre o bloco — você verá um ponto aparecer que permite criar uma conexão:

Etapa 1. Clique no botão e arraste o conector até o bloco com a pergunta.
Etapa 2. Os dois conectores vão se sobrepor, então você precisará arrastar um deles para cima. Para fazer isso, passe o mouse sobre os conectores e procure a alça alongada — use-a para ajustar a curva e separar a conexão.
Etapa 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 da pergunta.
O fluxo final fica assim:

Você criou com sucesso seu primeiro chatbot — completo com botões, conectores, opções de resposta, loops e setas de redirecionamento com tempo!
Como adicionar etapas do funil (listas)
Usando etapas do funil (listas), você pode organizar seu bot da forma mais conveniente para você. Ainda é um grande espaço de trabalho onde todas as ramificações do bot estão localizadas, mas visualmente ele é dividido em páginas separadas. O bot continua operando como um único fluxo.
Quando as cadeias de fluxo são quebradas entre listas, blocos de ligação são criados automaticamente.
Para adicionar uma nova lista, clique no ícone de mais no canto inferior direito da área 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 e, em seguida, clique na seta↪️ com a dica “Clique para mover os 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 abrir, você verá instruções sobre o que precisa ser feito para concluir a transferência.
Como conectar mensageiros
Após os testes, você pode conectar o fluxo aos mensageiros. Para fazer isso, vá para a Mensageiros seção no menu principal.

Em seguida, você precisa clicar no botão do mensageiro desejado.
Leia como conectar bots em diferentes mensageiros no “Mensageiros” artigo.
Atualizado