Pular para o conteúdo principal
Triggers fundamentais cobrem os pontos de entrada de workflow mais comuns: invocação manual, execuções agendadas, solicitações HTTP recebidas e upload de arquivos.

Manual Input

Inicia um workflow quando um usuário ou sistema externo o invoca explicitamente. Você pode configurá-lo com campos de entrada personalizados que devem ser preenchidos antes que o workflow seja executado — tornando-o ideal para tarefas sob demanda que requerem contexto fornecido pelo usuário, como enviar uma solicitação, iniciar um relatório ou começar um processo a partir da interface de chat do Odin. Quando usar
  • Você deseja executar um workflow sob demanda a partir da interface do Odin ou via API.
  • O workflow precisa de entradas fornecidas pelo usuário antes de poder executar.
  • Você está testando ou depurando um workflow com valores específicos.
Configuração
CampoTipoDescrição
Input fieldsAnyParâmetros definidos pelo usuário configurados nas configurações do trigger. Cada campo possui um nome, tipo e descrição opcional exibida ao usuário em tempo de execução.
Variáveis de saída
VariávelDescrição
trigger.user_inputO texto bruto enviado pelo usuário.
trigger.inputs.<field>O valor de cada campo de entrada nomeado. Substitua <field> pelo nome do campo configurado (por exemplo, trigger.inputs.customer_name).
trigger.chat_idO ID da sessão de chat que iniciou a execução.
trigger.message_idO ID da mensagem que acionou o workflow.
Exemplo: referenciando um campo de entrada
Olá {{ trigger.inputs.customer_name }}, sua solicitação foi recebida.
  • Os campos de entrada são apresentados ao usuário como um formulário antes que o workflow seja iniciado. Mantenha os nomes dos campos curtos e descritivos.
  • trigger.user_input está disponível mesmo que nenhum campo de entrada personalizado esteja configurado.
  • Para invocar este trigger programaticamente, chame a API do Odin com o ID do workflow e os valores de entrada necessários.

Webhook

Expõe um endpoint HTTP exclusivo para seu workflow. Sistemas externos — como aplicativos de terceiros, plataformas de automação ou scripts personalizados — podem enviar uma solicitação HTTP para essa URL para iniciar o workflow. O corpo da solicitação, cabeçalhos, parâmetros de consulta e método HTTP são todos passados para os nós downstream. Quando usar
  • Um sistema externo precisa notificar o Odin quando um evento ocorrer (por exemplo, envio de formulário, evento de pagamento ou atualização de outra plataforma).
  • Você está integrando o Odin com a Automation Anywhere ou outro sistema que pode chamar um endpoint HTTP.
  • Você deseja expor um workflow como um endpoint API que outros desenvolvedores ou ferramentas possam chamar.
Configuração
ConfiguraçãoTipoDescrição
http_methodStringO método HTTP que o endpoint aceitará: GET, POST, PUT, PATCH ou DELETE.
auth_typeStringComo as solicitações recebidas são autenticadas: none, basic ou header.
response_modeStringonReceived retorna um HTTP 200 imediato assim que a solicitação chega. lastNode aguarda a conclusão do workflow e retorna a saída final como a resposta HTTP.
Variáveis de saída
VariávelDescrição
trigger.bodyO corpo JSON da solicitação recebida.
trigger.headersOs cabeçalhos HTTP enviados com a solicitação.
trigger.queryParâmetros de consulta da URL da solicitação.
trigger.methodO método HTTP usado pelo chamador.
trigger.webhook_urlA URL completa do endpoint do webhook. Compartilhe isto com o sistema externo que chamará o workflow.
Modos de resposta
ModoComportamento
onReceivedRetorna HTTP 200 OK imediatamente quando a solicitação chega, antes que o workflow termine. Use para cenários de disparar-e-esquecer.
lastNodeMantém a conexão HTTP aberta até que o workflow termine, e então retorna a saída do nó final como o corpo da resposta. Use quando o chamador espera um payload síncrono.
  • Ao usar autenticação header, configure o nome e valor esperados do cabeçalho nas configurações do trigger.
  • trigger.webhook_url é útil para incluir a URL do endpoint na documentação de configuração enviada a parceiros de integração.
  • Se você está chamando este webhook a partir da Automation Anywhere, use a ação HTTP Task no seu bot para fazer POST na URL do webhook.

Schedule

Aciona um workflow automaticamente em uma agenda recorrente definida por uma expressão cron. Use-o para automatizar tarefas baseadas em tempo, como relatórios diários, sincronizações periódicas de dados ou notificações recorrentes — sem nenhuma intervenção manual. Quando usar
  • Você precisa que um workflow seja executado em um horário fixo todos os dias, semanas ou meses.
  • Você está automatizando um processo de negócio recorrente (por exemplo, buscar dados todas as manhãs, enviar um resumo semanal).
  • Você deseja verificar um sistema externo em intervalos regulares.
Configuração
ConfiguraçãoTipoDescrição
scheduleStringUma expressão cron definindo quando o workflow é executado.
timezoneStringO fuso horário no qual a expressão cron é avaliada. Aceita nomes de fuso horário padrão como UTC ou America/New_York.
Sempre defina o campo timezone explicitamente. Se deixado não definido, a agenda é executada em UTC, o que pode causar temporização inesperada para workflows específicos de região.
Referência de expressão cron Uma expressão cron possui cinco campos: minuto · hora · dia do mês · mês · dia da semana.
┌───── minuto (0–59)
│ ┌───── hora (0–23)
│ │ ┌───── dia do mês (1–31)
│ │ │ ┌───── mês (1–12)
│ │ │ │ ┌───── dia da semana (0–6, domingo = 0)
│ │ │ │ │
* * * * *
ExpressãoAgenda
0 9 * * *Todos os dias às 9:00
0 9 * * 1Toda segunda-feira às 9:00
0 */6 * * *A cada 6 horas
0 8 1 * *Primeiro dia de cada mês às 8:00
*/15 * * * *A cada 15 minutos
Variáveis de saída
VariávelDescrição
trigger.trigger_timeO carimbo de data/hora ISO 8601 de quando a agenda foi acionada.
trigger.schedule_expressionA expressão cron usada nesta execução.
trigger.trigger_typeSempre "schedule".
  • O trigger Schedule não passa entradas do usuário. Se seu workflow precisa de dados dinâmicos, busque-os dentro do workflow usando um nó API ou ferramenta de toolkit.
  • Use trigger.trigger_time em nós downstream para carimbar registros ou registrar quando a execução agendada ocorreu.

File Upload

Inicia um workflow quando um ou mais arquivos são carregados. Ele fornece o conteúdo, nome, tamanho e tipo MIME de cada arquivo para os nós downstream — tornando-o ideal para workflows de processamento de documentos, como analisar um relatório carregado, extrair dados de uma planilha ou rotear um arquivo para um modelo de IA para análise. Quando usar
  • Você deseja que os usuários enviem arquivos para que o workflow processe (por exemplo, faturas, contratos, exportações CSV).
  • Você precisa extrair conteúdo de documentos carregados e passá-lo para um LLM ou nó de processamento de dados.
  • Você está construindo um pipeline de ingestão multi-arquivo.
Configuração Este trigger não possui campos de configuração obrigatórios. Ele é ativado automaticamente quando um arquivo é carregado no chat ou interface associado ao workflow. Variáveis de saída
VariávelDescrição
trigger.file.contentO conteúdo de texto completo extraído do arquivo carregado.
trigger.file.nameO nome original do arquivo.
trigger.file.sizeO tamanho do arquivo em bytes.
trigger.file.typeO tipo MIME (por exemplo, application/pdf, text/csv).
trigger.file_countNúmero total de arquivos carregados. Retorna 1 para um único arquivo.
O conteúdo do arquivo é extraído como texto simples. Formatos binários como PDFs e documentos Word são analisados automaticamente — o texto extraído é o que aparece em trigger.file.content.
  • trigger.file sempre se refere ao primeiro (ou único) arquivo carregado. Para workflows multi-arquivo, use trigger.files com um nó Loop.
  • Use trigger.file.type em um nó Condicional para rotear diferentes tipos de arquivo para diferentes ramificações de processamento.