Reações: conceitos básicos

A reação é o bloco de construção principal do bot: uma regra que define quando ser acionada, em quais condições e o que fazer. O bot é uma lista ordenada de reações; para cada evento recebido, a plataforma percorre a lista de cima para baixo e aplica a primeira reação adequada. A seção fica em Reações no menu à esquerda.

Estrutura de uma reação

Uma reação tem quatro partes (abas do editor):

  • Gatilho — o evento ao qual a reação responde: texto, comando, mídia, clique em botão, evento do sistema, agendamento etc. Veja Gatilhos.
  • Em chats — onde a reação funciona: chat direto, grupos com menção ao bot, chats específicos; mais filtros por estado do usuário.
  • Condições — filtros adicionais (etiquetas, parâmetros, horário, número de mensagens etc.). Veja Condições e chats.
  • Ações — o que o bot faz ao ser acionado: envia mensagem, aplica etiquetas, grava em coleção, chama IA etc. Veja Ações.

Criar e editar

Clique em Criar reação (ou abra uma existente). No cabeçalho do editor: nome (obrigatório), número #N, descrição e o botão Ativa. À esquerda — navegação pelas seções Gatilho / Em chats / Condições / Ações, ao centro — o formulário, à direita — o preview do Telegram, que mostra como a mensagem ficará com blocos, teclado e menus. Salve com o botão Salvar.

Para uma reação salva, o editor exibe um painel de estatísticas: número de acionamentos, gráfico e eventos recentes.

Ordem e prioridade

As reações na lista podem ser reordenadas por arrastar e soltar — a ordem determina a prioridade. O evento aciona a primeira reação adequada e o processamento para. Para continuar percorrendo a lista e permitir que reações seguintes sejam acionadas, adicione a ação Próxima reação (goto_next).

Ativar e desativar

O botão na linha da lista (ou Ativa no editor) ativa e desativa a reação sem excluí-la. Reações desativadas são ignoradas durante o processamento.

Duplicar e excluir

Na linha da lista há botões Duplicar (cria uma cópia) e Excluir. Duplicar é útil quando você precisa criar uma reação semelhante com pequenas diferenças.

Importar e exportar

Uma reação pode ser exportada como JSON (botão Exportar no editor) e importada de volta (Importar na lista). Isso permite mover reações entre bots e armazenar versões fora da plataforma.

Transmissão de reação

O botão Transmissão na linha da reação (ícone "enviar") dispara essa reação para todos os assinantes ativos do bot — útil para anúncios e notificações. O público pode ser filtrado por etiquetas. Saiba mais em Transmissões.

Encadeamento e diálogos

Várias reações podem ser combinadas em cenários:

  • Reação em cadeia (chain) — ação que dispara outra reação durante a execução.
  • Próxima reação (goto_next) — passa o controle para a próxima reação adequada na lista.
  • Etapas de diálogo — um bloco de mensagem pode aguardar a resposta do usuário (com validação de formato), pausando o cenário. Veja Mensagens e botões.
  • Ramo "caso contrário" — se as condições da reação não forem satisfeitas, outra reação pode ser iniciada (campo na seção "Condições").

O que vem a seguir