Gatilhos

O gatilho é o evento ao qual uma reação responde. Na seção Gatilho do editor, você pode ativar vários tipos ao mesmo tempo: eles são combinados por "OU" — a reação será acionada se qualquer um dos gatilhos ativos for satisfeito. Restrições adicionais (etiquetas, parâmetros, chats) são configuradas separadamente em Condições.

Mensagem de texto

Acionado por texto ou legenda de mídia. No campo "O que procurar", selecione o modo:

  • Palavras-chave — lista de palavras/frases. Parâmetro "Correspondência": contém, correspondência exata, começa com, expressão regular; mais a opção "Diferenciar maiúsculas".
  • Link — a mensagem contém uma URL.
  • E-mail — contém um endereço de e-mail.
  • Menção (@username) — contém uma menção.
  • Qualquer texto — qualquer mensagem de texto.

Comando

Acionado por comandos com barra. No campo "Comandos (sem «/»)", liste os nomes, por exemplo help, menu. O bot responderá a /help e /menu.

Comando /start

Gatilho dedicado ao /start. O campo Payload captura o parâmetro de deep link (/start <payload>); deixar em branco corresponde a qualquer /start. É a base para links de referral e campanhas.

Clique em botão inline (callback)

Acionado pelo clique em um botão inline. O campo "Dados do botão (callback_data)" e "Correspondência" (exata, começa com, contém, expressão regular) definem quais botões capturar.

Mídia

Acionado por anexos dos tipos selecionados: Foto, Vídeo, Mensagem de vídeo, Documento, Áudio, Mensagem de voz, GIF, Sticker, Dado, Jogo, Enquete, Contato, Geolocalização, Local, Álbum.

Evento do sistema

Acionado por eventos do chat: Entrou por link, Adicionado ao chat, Saiu do chat, Removido do chat, Mudou status, Solicitação de entrada, Reação a mensagem, Contagem de reações. Útil para boas-vindas, moderação e aprovação de solicitações.

Resposta e encaminhado

  • Resposta (reply) a uma mensagem — acionado quando a mensagem é uma resposta a outra.
  • Mensagem encaminhada — acionado por forwards.

A cada N-ésima mensagem

Acionado a cada N-ésima mensagem do usuário (campo "A cada mensagem nº"). Adequado para dicas periódicas ou anti-flood.

Por agendamento (datas)

Acionado nos momentos de tempo especificados (lista de datas). A reação agendada é transmitida aos assinantes ativos quando o prazo chega — veja Transmissões.

Requisição web de entrada (webhook)

Acionado por uma requisição HTTP externa. Configure o Caminho (a URL completa é formada a partir do endereço do bot e do caminho), o Token secreto (para proteção) e o Método (POST / GET / PUT / ANY). Os dados da requisição entram no contexto de execução e ficam disponíveis nas ações via {{ctx.campo}}. Saiba mais em Requisições web e webhooks.

O que vem a seguir