Atualizado em Sep 17, 2026

Referência de Ações

Ações são os blocos de construção que você adiciona em:

• Workflows > Passos
• Agentes de IA > Ações para pré-ações e pós-ações
• Botões de notificação que executam lógica de acompanhamento

Cada ação faz um trabalho: chamar uma API, enviar uma mensagem, atualizar um registro, executar outro workflow ou preparar dados para passos posteriores.

Nem toda ação está disponível em todo construtor. Algumas ações só fazem sentido em workflows, algumas são projetadas para pré-ações ou pós-ações de agentes, e algumas requerem um contexto de conversa ativo.

Como usar esta referência

Use estas páginas para responder a três perguntas práticas:

1. Qual ação devo escolher?
2. Quais campos preciso preencher?
3. Qual resultado posso reutilizar em um passo posterior?

Se você precisar de ajuda para escrever expressões para campos dinâmicos, consulte o Editor de Expressões CEL.

Reutilizando resultados de passos anteriores

A maioria das ações disponibiliza dados para passos posteriores. Referencie-os com step(0), step(1) e assim por diante.

Exemplos:

• step(0).data
• step(1).status
• step(2).choices[0].message.content

Use Iniciar Debug ou depuração passo a passo para inspecionar o formato exato da saída antes de criar condições baseadas nela.

Metadados compartilhados de execução

Quando você quer saber como um passo em si foi executado, use o objeto aninhado executionContext. Isso mantém os metadados do executor separados das saídas próprias da ação.

Campos comuns:

• step(0).executionContext.status -- running, completed, skipped ou failed
• step(0).executionContext.startedAt
• step(0).executionContext.finishedAt
• step(0).executionContext.safeError.code
• step(0).executionContext.safeError.userMessage
• step(0).executionContext.safeError.retryable
• step(0).executionContext.safeResult

Exemplos:

• get(step(0), 'executionContext.status') == 'completed'
• get(step(1), 'executionContext.safeError.code') == 'unsupported_media_format'
• get(step(2), 'executionContext.safeResult.reason') == 'condition_false'

safeError e safeResult são sanitizados para ramificação e depuração. Eles não incluem stack traces brutos, segredos ou payloads do provedor.

Algumas ações já usam campos de nível superior como step(N).status para suas próprias saídas, por exemplo, um código de status HTTP. Prefira step(N).executionContext.status quando você se refere ao resultado da ação em si.

Disponibilidade e contexto

• Use ações de conversa apenas quando a execução atual já possui uma conversa para trabalhar.
• Use ações específicas de agente apenas onde ações de agente são suportadas.
• Se uma ação depende de um recurso específico, como memória de conversa ou um workflow filho, certifique-se de que esse recurso já está configurado antes de confiar na ação em produção.

Categorias

Categoria	Uso típico
IA e agentes	Gerar texto, enviar trabalho para outro agente, preparar texto escrito para ser falado, limpar memória ou pausar as respostas do agente
Código	Executar JavaScript ou Python em sandbox sobre dados e arquivos de passos anteriores
Configuração	Carregar variáveis e segredos da empresa em expressões CEL
Dados	Criar, buscar, pesquisar, contar, atualizar, excluir ou acionar workflows em seus dados da empresa
Mensagens	Enviar respostas para a conversa atual ou enviar mensagens proativamente a um contato
Integrações	Chamar APIs externas com requisições HTTP ou baixar arquivos diretamente para o storage
MCP	Conectar servidores MCP para que um agente use suas ferramentas
Monitores	Registrar uma vigia que acorda o agente mais tarde — quando um documento mudar, em um horário definido, ou quando uma das ferramentas do próprio agente reportar o estado que você pediu
Mídia	Salvar arquivos no storage, gerar documentos, ler um documento armazenado como texto, transcrever áudio, falar texto como áudio, converter áudio e vídeo entre formatos, inspecionar as dimensões e a duração de um arquivo, reutilizar suas URLs, criar links de download assinados e apagar arquivos de que você não precisa mais
Notificações	Alertar membros da equipe dentro do AutoTalk
Segurança	Gerar tokens JWT temporários
Estado da sessão	Armazenar valores para expressões CEL posteriores na mesma execução

Escolhendo a ação certa

• Use Gerar Resposta LLM quando quiser saída direta do modelo.
• Use Enviar Mensagem ao Agente quando quiser que outro agente trate a requisição.
• Use Compor Resposta da Conversa quando quiser responder na conversa atual.
• Use Enviar Mensagem ao Contato quando precisar enviar uma mensagem diretamente a um contato específico.
• Use Pesquisar Dados da Empresa quando precisar de uma lista.
• Use Contar Dados da Empresa quando precisar apenas de quantos corresponderam.
• Use Buscar Dados da Empresa quando já souber qual registro deseja.
• Use Executar Workflow quando quiser que um workflow chame outro.
• Use Ler Arquivo como Texto quando precisar do que está dentro de um documento anexado por um contato, e Transcrever Áudio quando o anexo for uma gravação.
• Use Criar Monitor quando a resposta chega depois — nunca consulte em loop por um job ou um estado externo.

Ações que não retornam campos reutilizáveis

Algumas ações são principalmente efeitos colaterais e não fornecem um resultado de passo significativo para reutilizar.

Exemplos comuns:

• Limpar Memória da Conversa
• Pausar respostas do agente
• Criar Notificação do Profissional

Use-as quando precisar do efeito em si, não de um valor para lógica posterior.