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ção | Pergunta que responde | Exemplo |
|---|---|---|
| Gatilho | Quando executar: texto, comando, mídia, botão, evento ou horário | A pessoa escreveu /price. |
| Em conversas | Onde a reação funciona: conversa privada, menção em grupo ou conversas específicas | Apenas na conversa privada. |
| Condições | O que mais conferir: etiquetas, parâmetros, tempo ou quantidade de mensagens | A pessoa tem a etiqueta «Pagou». |
| Ações | O que fazer: enviar mensagem, mudar etiquetas, guardar dados ou usar IA | Enviar 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 éupdatedou 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
- Gatilhos: os eventos que iniciam uma reação.
- Condições e conversas: filtros e locais onde a reação pode funcionar.
- Ações: todas as ações disponíveis.
- Mensagens e botões: crie respostas para o bot.