Skip to main content
As ações que criam registros novos e mexem em quem é responsável pelo trabalho.
Todos os campos de texto destas ações aceitam variáveis e sintaxe avançada. É assim que o registro criado herda dados do projeto que disparou a automação.

​
Criar projeto

Cria um projeto novo. O projeto criado é independente do que disparou a automação.
Selecione um projeto marcado como modelo. O novo projeto sai com uma cópia completa do modelo: cliente, funis, etiquetas, checklists, respostas de formulário, conteúdo, fórum, grupos e responsáveis.Você informa apenas o nome — os outros campos vêm do modelo.
O nome é cortado em 191 caracteres. Ao montar nomes com variáveis, considere esse limite antes de concatenar campos longos.
Quando você indica uma etapa de destino, o projeto criado é vinculado a ela ignorando restrições e bloqueios. Se por algum motivo ele já estiver naquela etapa, a ação segue sem erro.
Um gatilho de criação combinado a esta ação forma um laço: o projeto criado pode acionar a mesma automação. O limite de encadeamento interrompe a cadeia, mas cada volta gasta execuções do plano. Use condições para garantir que o projeto criado não se encaixe no gatilho.

​
Criar hierarquia de projetos

Cria ou vincula projetos filhos abaixo do projeto que disparou a automação, montando a árvore de uma vez. A estrutura é escrita em texto, com - indicando o nível:

Hierarquia automatizada

Esta ação tem um guia dedicado, com a sintaxe completa da estrutura, uso de variáveis, vinculação seletiva por etapa e exemplos de árvores reais.

​
Criar cliente

Cadastra um cliente e, opcionalmente, vincula ele a projetos. Os campos numéricos seguem esta convenção:
O formulário desta ação é simplificado: não há máscaras nem validações. O que você escrever é gravado como está. Garanta o formato correto de documento e telefone, ou a ação falha na hora de criar.

​
Evitar duplicados

Ligue Checar se o cliente já existe e escolha os campos de comparação entre e-mail, telefone e documento.
Todos os campos escolhidos precisam coincidir para o cliente ser considerado duplicado. Marcar e-mail e telefone significa “mesmo e-mail e mesmo telefone”, não “um ou outro”.
Encontrando um duplicado, a ação não cria nada e segue usando o cliente que já existia — inclusive para o vínculo com projetos. O registro de execução indica que a criação foi evitada.

​
Vincular a projetos

O campo de vínculo espera uma expressão que devolva uma lista de identificadores de projeto. O cliente resultante — novo ou encontrado como duplicado — é gravado nesses projetos.
A expressão precisa devolver uma lista válida de identificadores. Qualquer outro formato faz a ação registrar erro.
Para vincular contatos ao cliente, informe os identificadores dos contatos separados por vírgula.

​
Criar contato

Cadastra um contato. Funciona exatamente como a criação de cliente, com os campos próprios de contato. Para vincular clientes ao contato, informe os identificadores dos clientes separados por vírgula.
Criando cliente e contato na mesma automação, coloque a criação do cliente antes e use o resultado dela para preencher o vínculo do contato.

​
Alterar usuários atribuídos

Adiciona, remove ou substitui os responsáveis do projeto.

​
Os três tipos de ação

Adicionar

Os usuários selecionados entram na lista de responsáveis, mantendo quem já estava.

Remover

Os usuários selecionados saem da lista.

Substituir

Todos os responsáveis atuais saem e os selecionados entram.
Em Substituir, quem foi removido é excluído do sorteio da mesma execução. Se todos os usuários da lista já eram responsáveis, não sobra ninguém para atribuir e a ação registra empty_user_pool_after_exclusion — o projeto fica sem responsáveis.

​
Sorteio

Com Usar usuário aleatório ligado, a ação sorteia a quantidade indicada dentro da lista, em vez de aplicar a lista inteira. É o caminho para distribuir demanda entre um time.
A quantidade sorteada precisa ser menor ou igual ao tamanho da lista. Pedindo mais usuários do que a lista tem, a ação registra erro de dados inválidos.

​
Lista por expressão

Ligando Usar sintaxe avançada, a lista de usuários deixa de ser uma seleção manual e passa a ser calculada. A expressão precisa devolver uma lista de usuários ou de identificadores:
É assim que se atribui “quem respondeu o formulário”, “o responsável indicado no campo X” ou “quem disparou o gatilho”. Veja Variáveis nas automações.
Se a expressão devolver algo que não é uma lista, devolver uma lista vazia, ou devolver itens sem identificador, a ação registra erro e nenhum responsável é alterado. O registro de execução mostra o texto gerado pela expressão — é a forma mais rápida de descobrir o que saiu errado.

​
Por onde continuar

Comunicação, IA e execução

Conteúdo, e-mail, webhook, assistente de etapa, metas e execução.

Variáveis

Como montar listas e preencher campos com dados do projeto.

Hierarquia automatizada

O guia completo da criação de árvores de projetos.

Mencionar usuários

Como transformar usuários em menções dentro de mensagens.