Ações

As ações são o que o bot executa quando uma reação é acionada. Uma reação pode ter várias ações, que são executadas em ordem, de cima para baixo. São adicionadas pelo botão Adicionar ação na seção Ações do editor. As ações trocam dados por meio do contexto de execução (ctx) e dos parâmetros do usuário — veja Substituições e fórmulas.

Mensagens e respostas

  • Enviar mensagem — a ação principal: monta a resposta a partir de blocos (texto, foto, arquivo, pausa, IA, chamada de reação), adiciona botões inline, menus e etapas de diálogo. Detalhes em Mensagens e botões.
  • Salvar mensagem — grava o texto da mensagem recebida em um parâmetro do usuário.
  • Encaminhar — encaminha a mensagem recebida para chats indicados (com ID de tópico opcional).
  • Notificação — envia uma notificação para chats de serviço com dados sobre o usuário, o chat e o texto.

Usuário: etiquetas e parâmetros

  • Alterar etiquetas — adiciona e/ou remove etiquetas do assinante.
  • Alterar parâmetros — define, remove ou incrementa os valores dos parâmetros do usuário.

Moderação

  • Excluir recebido — exclui a mensagem recebida (opcionalmente, todas as mensagens do usuário, com atraso).
  • Excluir enviadas — exclui mensagens do bot (desta reação ou todas no chat, com atraso).
  • Alterar permissões — silenciar / remover silêncio / banir / desbanir / restringir permissões do participante, por tempo determinado ou permanentemente; para restrição, permissões específicas são selecionadas.
  • Reação importante (cor) — marca o diálogo com uma cor para o operador.

Dados e coleções

  • Criar registro — adiciona uma linha à coleção; com uma "chave de deduplicação", funciona como upsert (sem duplicatas).
  • Atualizar registros — altera linhas que correspondem a um filtro.
  • Buscar registros — lê linhas no contexto como um array (para iteração).
  • Excluir registros — exclui linhas por filtro.
  • Loop por lista — itera sobre um array do ctx e executa ações aninhadas para cada elemento (por exemplo, uma transmissão por lista).

Saiba mais sobre coleções em Coleções e dados.

Requisições externas

  • Requisição web — requisição HTTP (GET/POST/PUT/DELETE) com cabeçalhos, corpo, códigos de sucesso, timeout e retentativas; a resposta é salva em um parâmetro ou ctx via JSONPath; pode ser executada de forma assíncrona e acionar reações em caso de sucesso/erro.
  • Carregar URL — faz o download de uma página e salva o texto legível em ctx (para processamento posterior ou IA).
  • Consulta à fonte — lê dados de um conector conectado (REST / OzmaDB) para ctx.
  • Gravação na fonte — grava dados no conector (POST/PUT/DELETE).

Sobre fontes e chaves — Fontes e chaves.

IA e cálculos

  • IA — chama um modelo de linguagem: prompt, salvamento da resposta em parâmetro/ctx, esquema JSON opcional para extração de estrutura, envio da resposta ao usuário. Veja Respostas de IA.
  • Cálculo — calcula com base em fórmula ou em uma tabela de decisão (regras "quando → então", a primeira verdadeira vence) e salva o resultado em ctx/parâmetro.

Lógica e cenários

  • Reação em cadeia — dispara outra reação pelo seu nome.
  • Próxima reação — passa o controle para a próxima reação adequada na lista.
  • Iniciar cenário — inicia um assistente passo a passo (flow). Veja Cenários.
  • Solicitar aprovação — envia um cartão ao aprovador; os botões "aprovar"/"recusar" acionam as reações definidas.
  • Transferir para operador — transfere o diálogo para a caixa de entrada do operador. Veja Chats e operadores.

Integrações

As ações GetCourse, Google Sheets e Google Drive são conectadas pelas integrações de mesmo nome (veja Integrações). No construtor de reações, essas ações estão marcadas como "em breve" — por enquanto, use-as via configuração de integração, requisições web ou IA. O envio universal para um serviço externo está disponível pela integração Webhook e pela ação Requisição web.

O que vem a seguir