Gatilhos

O gatilho é o evento que aciona a automação. Toda automação tem exatamente um e ele é obrigatório: sem gatilho, o editor não deixa adicionar ações nem condições. Esta página descreve os oito gatilhos e as opções de cada um. Os gatilhos disponíveis dependem de onde você cria a automação. Pela área Automações, você tem todos. Pela etapa do funil, só os que envolvem aquela etapa. Veja Onde criar automações.

​

Visão geral

A tabela resume o evento que aciona cada gatilho e de onde o disparo costuma vir.

​

Projeto movido de etapa

Aciona quando um projeto entra em uma etapa específica. Sem Vindo da etapa, o gatilho aciona não importa de onde o projeto veio — inclusive de lugar nenhum, no caso de um projeto que acabou de ser vinculado ao funil. Isso vale também para o projeto criado já dentro da etapa, pela interface, pela API, por integração ou por automação. O gatilho não dispara quando o projeto:

• já estava na etapa;
• veio de uma etapa diferente da configurada em Vindo da etapa;
• entrou em uma etapa de mesmo nome em outro funil. Etapa é sempre um registro específico de um funil específico.

​

Projeto ocioso em etapa

Aciona quando um projeto fica parado em uma etapa por mais tempo do que você tolera. É o gatilho de cobrança automática: “esse projeto está há cinco dias sem sair daqui”. A contagem começa quando o projeto entra na etapa. Editar o projeto, responder formulários ou trocar mensagens não zera a contagem: ela só recomeça quando o projeto sai e volta para a etapa. Com Repetir recorrentemente desligado, o gatilho aciona uma única vez por projeto naquela etapa. Ligado, aciona a cada intervalo enquanto o projeto continuar parado ali — a cada 5 dias, indefinidamente, até o projeto sair. A verificação roda a cada minuto, então o disparo acontece perto do tempo configurado, não no segundo exato. O gatilho também vale para os projetos que já estão parados na etapa quando você salva a automação:

​

Campo do projeto alterado

Aciona quando um campo específico do projeto muda de valor. É um campo por gatilho, escolhido entre os campos abaixo. Quando o campo monitorado é a data de previsão do funil, aparece a opção Funil relacionado, que restringe o disparo à previsão daquele funil. Sem funil selecionado, o gatilho aciona para qualquer funil.

​

Etiqueta vinculada a um projeto

Aciona quando uma etiqueta específica é vinculada ao projeto. Você escolhe a etiqueta observada e pode usar qualquer etiqueta de qualquer funil. O gatilho não dispara quando a etiqueta é removida — ele só observa o vínculo — nem quando a etiqueta já estava no projeto.

​

Formulário editado

Aciona quando um formulário dinâmico é respondido no projeto, seja no corpo do projeto, na etapa, no funil ou em um formulário avulso. Sem restrição de campos, o gatilho aciona sempre que o formulário for respondido. Com restrição:

• Apenas um campo respondido é suficiente, ligado: o gatilho aciona quando um dos campos escolhidos muda.
• Desligado: todos os campos escolhidos precisam mudar na mesma submissão.

Com restrição de campos, um campo só conta se o valor mudou em relação à última resposta. Reenviar o mesmo formulário com os mesmos valores não aciona o gatilho.

​

Data de projeto atingida

Aciona quando uma data chega — com a opção de antecipar ou atrasar o disparo em relação a ela. Em Usar tempo relativo você escolhe entre os intervalos prontos ou usa Tempo relativo customizado para expressões mais precisas, como “na segunda-feira seguinte” ou “no último dia do mês”. Veja Tempo relativo customizado para a lista completa de expressões.

​

Como o agendamento funciona

Com um campo de formulário avulso, o agendamento é um só por projeto e por campo. Quando o mesmo formulário avulso aparece mais de uma vez no projeto, vale a última data alterada em qualquer uma das cópias. O disparo não informa de qual cópia veio a data.

​

Execução de projeto

Aciona quando uma execução de tempo — o play/pause que registra quanto tempo alguém trabalhou no projeto — inicia ou termina. Uma pessoa só tem uma execução aberta por vez. Quando ela inicia uma execução, a plataforma encerra sozinha as outras execuções abertas dela, em qualquer projeto ou etapa. Você não precisa de automação para isso.

​

Conteúdo enviado no projeto

Aciona quando alguém publica um registro no conteúdo do projeto — uma resposta que chega por uma integração ou um recado da equipe.

​

Onde o conteúdo chegou

Esta opção define em que parte do conteúdo do projeto a publicação precisa aparecer. Com Linha externa selecionada, aparece o campo Integração. Deixá-lo em branco aciona com qualquer integração conectada; preenchê-lo restringe o gatilho àquela linha. Trocar o escopo para qualquer outro valor limpa a integração escolhida — ela só faz sentido restringindo uma linha externa.

​

Quem enviou

Esta opção filtra pela autoria da publicação. A combinação mais útil é Linha externa + Quem está do outro lado: aciona só quando o cliente responde, ignorando tudo o que a própria equipe publica. É a base de regras como “cliente respondeu, tire o projeto de Aguardando retorno” ou “cliente respondeu fora do horário, avise o plantão”.

​

Mensagens seguidas

Mensagens seguidas viram um acionamento só, em vez de uma execução por mensagem. Cada mensagem nova na mesma conversa reinicia a espera. O gatilho dispara depois do tempo de espera sem mensagem nova e entrega a sequência inteira, até 20 mensagens, para a automação. Assim, um cliente que manda cinco linhas seguidas não recebe cinco vezes a mesma resposta automática. O tempo de espera é de 20 segundos por padrão. Para mudar, abra Ajustes da empresa e, no cartão Tempo de espera do gatilho de conteúdo adicionado, informe um número inteiro entre 3 e 120 em Tempo de espera (segundos). O valor vale para todas as automações da empresa com este gatilho. O mesmo número tem dois efeitos:

• Quanto a automação espera antes de rodar. Valores altos deixam o contato mais tempo sem resposta.
• O intervalo máximo entre mensagens para contarem como a mesma fala. Com 20 segundos, duas mensagens com 15 segundos de intervalo geram uma execução. Com 5 segundos, as mesmas mensagens geram duas execuções.

Por isso, reduzir o tempo só para responder mais rápido pode fazer a automação rodar mais vezes.

​

Áudio em transcrição

Quando Transcrever áudios automaticamente está ligada, o gatilho espera o áudio sair de processando. A sequência em que o áudio entrou, e as mensagens seguintes da mesma conversa, só disparam depois que ele sai de processando. A plataforma encerra como falha um áudio que permanece processando por 10 minutos, e o gatilho segue. Veja Limites da plataforma e Transcrição de áudio. O texto em trigger.contents_text depende do áudio. Enquanto transcription_status é processing, o gatilho ainda não disparou. Cada item de trigger.contents traz id, type, text, transcription_status, author e created_at. No áudio, text desse item é o mesmo texto da tabela. O campo text do conteúdo continua vazio, e a frase dos casos sem transcrição não fica gravada no áudio. Se a transcrição termina antes da janela de mensagens seguidas, o gatilho ainda espera o restante do tempo de espera, contado da publicação do conteúdo. Com a opção desligada, o áudio aciona como qualquer outro conteúdo e o texto dele chega vazio. Se você desliga a opção enquanto um áudio ainda está processando, a tentativa em andamento termina e é cobrada; só os áudios novos deixam de ser transcritos. Conteúdo publicado pela própria automação segue outra regra:

​

Por onde continuar