Skip to main content
Esta página reúne as ações que falam com pessoas, com outros sistemas e com a inteligência artificial da plataforma.

​
Envia conteúdo do projeto

Publica texto e arquivos no conteúdo do projeto. É a ação mais usada para comunicar o que a automação fez.
O destino é a aba Conteúdo do projeto, não o Caderno — são recursos diferentes, e o Caderno não recebe escrita por automação.
Sem mensagem e sem arquivo, a ação não salva. Com arquivo e mensagem em branco, só os arquivos vão para o destino — a ação não cria um registro de texto vazio.

​
Arquivos anexados

Em Arquivos anexados (opcional), escolha arquivos já ligados a uma etapa ou a um funil, ou campos de anexo de um formulário. A lista agrupa Anexos de etapa, anexos por funil e campos por formulário. Só entram arquivos: links de etapa ou de funil não podem ser selecionados. Quando você inclui um campo de anexo, preencha Onde está o formulário?. A ação envia só os arquivos respondidos nesse lugar. O mesmo campo respondido em outro lugar do projeto não entra. Se o projeto tiver o mesmo formulário avulso mais de uma vez, os arquivos enviados são os do primeiro, por ordem de criação. Sem o lugar completo, a ação não salva. Na execução, um arquivo que não puder ser enviado é omitido e os demais seguem; o registro marca some_attachments_could_not_be_sent. Os anexos de funil e de etapa continuam sendo material de apoio do processo. Ao enviá-los por esta ação, a plataforma grava uma cópia no conteúdo do projeto — veja Anexos do funil e da etapa e Arquivos do projeto.

​
Os três destinos

A mensagem é publicada solta no conteúdo do projeto, como qualquer registro que uma pessoa escreveria. É o padrão.

​
Mencionar pessoas

Menções dentro de uma automação precisam do formato de menção, que você pode montar com variáveis. Veja Mencionar usuários com automação.

​
Enviar um e-mail

Envia um e-mail. Assunto e mensagem aceitam variáveis. O campo de destinatários também aceita uma expressão que devolve os endereços. Nesse caso, o resultado é separado por vírgula e cada endereço é validado: os inválidos são descartados e os repetidos, unificados. Se nenhum endereço válido sobrar, a ação registra invalid_emails e nenhum e-mail é enviado. O envio é enfileirado, não instantâneo. O registro de execução marca a ação como bem-sucedida quando o e-mail entra na fila, não quando chega na caixa de entrada.
Envio de e-mail é irreversível. Ao montar automações com gatilhos de alto volume — formulário editado ou projeto ocioso com repetição — pense no número de mensagens antes de ativar.

​
Disparar webhook

Notifica um sistema externo sobre o que aconteceu.

​
O que é enviado

A requisição é sempre POST, com o corpo em JSON:
Não é possível escolher o método nem enviar cabeçalhos. A chamada sai sempre como POST, sem cabeçalhos customizados — não há campo de Authorization, de chave de API ou de assinatura.Na prática, isso significa que a ação não serve para chamar uma API que exija autenticação por cabeçalho — inclusive a API da própria Olie. O destino precisa aceitar uma chamada sem credencial no cabeçalho.
Quando o destino exige credencial, aponte o webhook para um endereço intermediário seu: uma função, um endpoint próprio ou uma ferramenta de automação externa. Esse intermediário recebe a chamada aberta, confere o que precisar pelo corpo e só então chama a API autenticada.

​
Como a chamada é feita

A chamada é síncrona: a automação espera a resposta antes de seguir para a próxima ação. O tempo máximo de espera é de 10 segundos. Redirecionamentos não são seguidos — um 301 ou 302 conta como erro, e não como a resposta do endereço de destino. O erro fica registrado naquele componente e o fluxo continua nas ações seguintes. O endpoint precisa ser público. Endereços que apontam para a rede interna, como localhost, faixas privadas e endereços reservados, são recusados antes do envio. Para chamar um sistema que roda dentro da sua rede, exponha um endereço acessível pela internet.
O editor tem um botão Testar webhook. Use antes de salvar para confirmar que o endpoint responde. O teste envia um corpo com event igual a test e dados de exemplo — não os dados de um projeto real.

​
A resposta não volta para o fluxo

O corpo da resposta não volta para a automação. O que o endpoint devolve não vira variável e não pode ser usado em uma condição nos passos seguintes. Do retorno, o fluxo aproveita uma única informação: se a chamada respondeu 200 ou não. Por isso, a automação não consulta um sistema externo no meio do fluxo para continuar com o dado consultado. Para reagir a uma informação de fora, inverta a direção: quem escreve na Olie é o serviço externo.

A automação dispara o webhook

Com o corpo customizado levando o que o serviço externo precisa saber — o identificador do projeto, por exemplo.

O serviço externo processa

No tempo dele, sem prender a automação.

O serviço escreve de volta na Olie

Pela API: preencher um campo de formulário, aplicar uma etiqueta, mover o projeto de etapa.

Essa escrita dispara outra automação

O gatilho correspondente — formulário editado, etiqueta vinculada, projeto movido — retoma o processo já com o dado em mãos.
Uma automação acionada por outra conta no limite de encadeamento. A escrita feita por um serviço externo, não: para a plataforma, é uma escrita como qualquer outra.

​
Executar assistente de etapa

Aciona um assistente de etapa, a peça de IA que analisa o projeto e produz um resultado dentro dele. A lista mostra apenas assistentes configurados como execução manual ou com a execução manual habilitada. Assistentes que rodam automaticamente na etapa não aparecem aqui, porque já têm gatilho próprio.
Assistentes consomem créditos de IA da conta. Combinar esta ação com um gatilho de alto volume consome créditos na mesma proporção. Veja Créditos de IA.

Assistentes de etapa

Como criar um assistente e configurar a execução manual.

​
Atualizar progresso de meta manual

Soma, subtrai ou define o progresso de uma meta do tipo manual. A meta precisa ser do tipo manual e estar ativa. Metas de outros tipos calculam o próprio progresso e não aceitam esta ação: nesse caso, o componente registra erro sem alterar nada. O progresso nunca fica abaixo de zero: uma subtração maior que o valor atual resulta em zero.

Metas e automação

Como as metas se conectam ao restante da operação.

​
Controlar execução de projeto

Inicia ou pausa a contagem de tempo de um projeto para usuários específicos.

​
De onde vêm os usuários

A opção Usuários alvo aceita três origens.
A origem Usuário que disparou o gatilho exige que o disparo tenha vindo de uma pessoa. Em automações acionadas por agendamento — projeto ocioso ou data atingida — não existe usuário causador e a ação registra invalid_causer_type.

​
Iniciar

Ao iniciar, a execução é vinculada à etapa escolhida. Sem etapa selecionada, a ação usa a etapa que acionou a automação — o que exige um gatilho ligado a uma etapa. Com um gatilho que não é de etapa e sem etapa escolhida, a ação registra trigger_not_step_scoped.

​
Pausar

Ao pausar, todas as execuções em andamento daqueles usuários naquele projeto, em qualquer etapa, são encerradas e registradas como parada programada. Você não precisa desta ação para impedir duas execuções abertas ao mesmo tempo. Quando uma pessoa inicia uma execução, a plataforma já encerra as outras execuções abertas dela, em qualquer projeto ou etapa.

​
Por onde continuar

Variáveis

Como montar mensagens, destinatários e corpos de webhook com dados do projeto.

Logs e depuração

Conferir se a mensagem saiu e por que um componente falhou.

Receitas prontas

Montagens completas para cenários comuns.

Projeto e etapas

As ações que movimentam o projeto pela operação.