Como criar comandos do usuário (restart, help...)
Um padrão comum é permitir que o usuário digite palavras como restart, help ou menu em qualquer ponto da conversa para disparar um comportamento específico. O GG.chatbot não tem um bloco dedicado a isso, mas você monta esse recurso com um evento Reply combinado com os blocos Pular e Return.
Evento Reply ou evento Comando?
Os dois são fáceis de confundir:
- Evento Reply dispara a cada resposta do usuário — texto digitado, clique em botão e assim por diante. Use quando o disparo vem de algo que a pessoa faz dentro da conversa. É o que você quer para palavras como
restartouhelp. - Evento Comando dispara apenas quando um comando é enviado programaticamente, via
Typebot.sendCommandou pela API continueChat. Use para disparar fluxos de fora da conversa: um botão na sua página, um webhook externo e afins.
Se você quer que o usuário digite uma palavra para disparar algo, use o evento Reply.
Implementar um comando restart
O objetivo: sempre que o usuário responder restart, a conversa volta para o primeiro bloco do fluxo.
Adicione um evento Reply
Na barra lateral de eventos, arraste um evento Reply para o editor.
Filtre o conteúdo da resposta
Dentro do subfluxo do evento, adicione um bloco de Condição que verifique se o conteúdo da resposta é igual a restart — sem diferenciar maiúsculas, se preferir.
Pule para o primeiro bloco
No ramo verdadeiro da condição, adicione um bloco Pular apontando para o primeiro bloco do seu fluxo principal.
Retorne no ramo falso
No ramo falso, adicione um bloco Return, para que a conversa siga normalmente quando o usuário digitar qualquer outra coisa.
O evento Reply dispara antes de a resposta ser validada contra a entrada atual. Ou seja, a palavra-chave funciona mesmo que o usuário esteja em um campo de número ou de e-mail.
Implementar um comando help
Mesmo padrão, mas em vez de pular para o início do fluxo, pule para um grupo "Ajuda" dedicado, que envia alguns balões de texto explicando o que o bot faz. Termine esse grupo com um bloco Return, para o usuário voltar de onde estava.
Lidar com vários comandos
Você pode encadear várias condições dentro do subfluxo de um único evento Reply:
restart→ pular para o iníciohelp→ pular para o grupo de ajudaagent→ pular para o grupo de transferência para atendimento humano- qualquer outra coisa → Return
Manter todo o roteamento de comandos dentro de um só evento Reply é mais fácil de dar manutenção do que duplicar a lógica em cada grupo.