Base de conhecimento GetMyBot

Reações: primeiros passos

Ensine o bot a responder a um comando, clique em botão ou outro evento. Crie uma reação, defina a ordem das regras e conecte as etapas da conversa.

Nesta página

Uma reação é uma regra de comportamento do bot. Por exemplo: «Quando alguém escrever /price, enviar a tabela de preços». Ou: «Quando o pedido for pago, adicionar a etiqueta “Pagou” e liberar o acesso».

Na seção Reações, escolha o evento que inicia a regra, as condições adicionais e as ações. O bot verifica as regras de cima para baixo e executa a primeira que se aplica. Por isso, uma regra específica normalmente deve ficar acima de uma resposta geral a qualquer mensagem.

Partes de uma reação

No exemplo da tabela de preços, basta escolher o comando /price e adicionar a mensagem com os valores. As outras opções ajudam a limitar a regra a determinadas pessoas ou conversas. O editor tem quatro seções:

SeçãoPergunta que respondeExemplo
GatilhoQuando executar: texto, comando, mídia, botão, evento ou horárioA pessoa escreveu /price.
Em conversasOnde a reação funciona: conversa privada, menção em grupo ou conversas específicasApenas na conversa privada.
CondiçõesO que mais conferir: etiquetas, parâmetros, tempo ou quantidade de mensagensA pessoa tem a etiqueta «Pagou».
AçõesO que fazer: enviar mensagem, mudar etiquetas, guardar dados ou usar IAEnviar a tabela de preços.

Criar e editar

Clique em Criar reação ou abra uma que já existe. Na parte superior do editor, informe o nome obrigatório, veja o número #N, acrescente uma descrição se quiser e use a opção Ativa. Escolha Gatilho / Em conversas / Condições / Ações à esquerda e preencha os campos no centro. À direita, a prévia mostra como a mensagem aparecerá no Telegram, com seus blocos, botões e menu. Clique em Salvar.

Depois de salvar, o editor também mostra as estatísticas da reação: quantas vezes foi executada, um gráfico e os eventos recentes.

Histórico de alterações e restauração

Em uma reação salva, abra Histórico de alterações. Você verá as últimas 20 mudanças, com data, autor, origem e as diferenças entre «Antes» e «Depois». É possível restaurar o estado anterior a uma mudança escolhida: confira as diferenças e confirme a restauração.

Restaurar substitui alterações ainda não salvas e cria uma nova entrada no histórico. Isso recupera as configurações da reação, mas não desfaz mensagens já enviadas nem dados que já foram alterados. Se outra pessoa modificar a reação enquanto você analisa as diferenças, atualize a comparação antes de restaurar.

Veja o passo a passo do histórico.

Ordem e prioridade

Você pode arrastar as reações para mudar a ordem manual quando não houver busca, filtros ou uma pasta selecionada. A ordem define a prioridade: diante de um evento, o bot executa a primeira reação aplicável e para de procurar. Para continuar procurando e permitir outras reações, use a ação Próxima reação (goto_next).

Busca, filtros e agrupamento

Acima da lista, você pode buscar pelo nome ou número e usar filtros:

  • Estado: todas, apenas ativas ou apenas inativas.
  • Criada de / até: dias no seu fuso horário, incluindo os dois dias escolhidos.
  • Ordem: manual, mais recentes primeiro ou mais antigas primeiro.
  • Agrupamento: por dia ou mês de criação. O agrupamento funciona apenas com ordenação por data. Se você o ativar durante a ordem manual, a lista mudará para «Mais recentes primeiro». Se a lista já estiver ordenada por data, essa ordem será mantida. Voltar à ordem manual desativa o agrupamento.

Os filtros abrangem todas as reações, não apenas a página aberta. Eles podem ser combinados com a busca e as pastas; o contador mostra quantas reações foram encontradas. As opções ficam registradas no endereço da página, para que você possa atualizá-la, compartilhar o link ou voltar usando o botão do navegador. Limpar filtros apaga a busca, os filtros, a ordem e o agrupamento, mas mantém a pasta selecionada.

Filtros e ordenação mudam apenas a aparência da lista. Eles não mudam a ordem em que o bot verifica as reações.

Ativar e desativar

A opção na linha da lista, ou Ativa no editor, liga e desliga a reação sem excluí-la. O bot ignora reações desativadas.

Duplicar e excluir

Na linha da reação, Duplicar cria uma cópia e Excluir apaga a reação. A cópia é útil para criar outra regra parecida, com pequenas diferenças.

Importar e exportar

Você pode baixar uma reação em formato JSON com Exportar, no editor, e carregá-la com Importar, na lista. Isso permite transferir reações entre bots e guardar versões fora da plataforma.

Enviar uma reação a todos

O botão Envio na linha da reação, com o ícone de enviar, executa a reação para todos os assinantes ativos do bot. É útil para anúncios e avisos. Você pode limitar o público pelas etiquetas. Veja Envios.

Encadear reações e criar diálogos

Por exemplo, a primeira reação mostra um catálogo; um botão abre outra com os detalhes do produto; a próxima pede o endereço de entrega. Há várias formas de passar de uma etapa para outra:

  • Reação em cadeia (chain): inicia outra reação durante a execução da atual.
  • Próxima reação (goto_next): passa para a próxima reação aplicável da lista.
  • Etapas de diálogo: um bloco de mensagem pode esperar a resposta da pessoa e conferir o formato, pausando o fluxo. Veja Mensagens e botões.
  • Ramo alternativo: se as condições não forem atendidas, inicia outra reação indicada em Condições.
  • Escolher a próxima etapa (branch_result): trata um resultado vazio, único, múltiplo ou incompleto de uma busca.
  • Escolher etapa pelo valor (branch_value): por exemplo, confirma um pedido quando o valor é updated ou pede uma nova leitura quando é conflict.
  • Resultado de uma ação: passa a outra reação em caso de sucesso, conflito, ausência de registro ou erro, se a ação oferecer essas saídas. Veja Como escolher os caminhos.
  • Chamar bloco (call_block): usa um cálculo compartilhado e recebe seus resultados na reação atual. Veja Biblioteca de blocos e versões.

Para trabalhar com dados, você pode montar a sequência Buscar na coleção → Escolher a próxima etapa → Botões → Encontrar registros relacionados. Se a lista vier de um serviço externo, use Processar lista → Grupos e totais. Dê um nome ao resultado de cada ação para poder selecioná-lo na ação seguinte.

Os exercícios práticos mostram essas sequências com exemplos de aulas e solicitações.

Ao configurar as ações, escolha os dados das etapas anteriores em vez de decorar caminhos. Antes de salvar, teste o rascunho atual com dados de exemplo e compare os caminhos e mensagens previstos. Depois de salvar, teste novamente pelo bot e canal conectados, onde as ações reais serão executadas.

Próximos passos