O editor é onde você define o que uma automação faz. Você coloca um gatilho em uma tela, adiciona as etapas seguintes, conecta-as com linhas e preenche cada etapa. Este artigo percorre o editor desde o primeiro gatilho até uma versão publicada.
Abrir o editor
Na lista de automações, clique em uma automação ou escolha Editar no menu dela. Para começar do zero, crie uma nova automação e escolha Automatização em branco.
Uma automação nova começa com um nó provisório chamado Selecione um gatilho para começar e com o nome Automatização sem título. Clique no nome no topo para alterá-lo. Você precisa de um nome antes de poder salvar.
O editor tem quatro áreas:
- A barra no topo com o nome, o interruptor Ativo, as ferramentas, Salvar e um menu com mais ações.
- A biblioteca à esquerda, com tudo o que você pode adicionar.
- A tela no meio, com o seu fluxo.
- O inspetor à direita, que abre quando você seleciona um nó.
Clique em Automatizações no canto superior esquerdo para voltar à lista. Com alterações não salvas, o editor pergunta se você quer sair mesmo assim.
A biblioteca
A biblioteca tem duas abas: Gatilhos e Ações.
- Gatilhos lista o que pode iniciar uma automação, por exemplo um novo membro, um pedido pago ou uma aula concluída.
- Ações lista o que a automação faz. A seção Controle vem primeiro: são os blocos que dão forma ao fluxo, como condições, atrasos, ramificações e repetições. Depois vêm as ações propriamente ditas.
As duas abas são agrupadas por origem. A primeira origem contém os blocos nativos da sua plataforma, e as integrações vêm em seguida, em ordem alfabética. O número ao lado de uma origem conta os blocos dela. Clique em uma origem para abri-la; as origens maiores são divididas em categorias como Membros, Pagamentos ou Cursos. A seta no topo leva você de volta.
A seção Recentes mostra os últimos quatro blocos que você colocou a partir da aba aberta, para que os que você mais usa estejam sempre à mão.
Para encontrar um bloco rapidamente, digite no campo de busca acima das abas. Ele pesquisa nomes e descrições em todas as origens da aba aberta.
A seta ao lado do título da biblioteca recolhe a biblioteca em uma faixa estreita para dar mais espaço à tela. Clique no ícone da faixa para abri-la de novo. No celular, a biblioteca começa recolhida.
Adicionar e conectar nós
Há duas formas de adicionar um bloco:
- Arraste-o da biblioteca para a tela e solte-o onde quiser.
- Clique ou toque nele. O editor o coloca à direita do seu fluxo.
O primeiro gatilho que você adiciona substitui o nó provisório Selecione um gatilho para começar e ocupa o lugar dele. Você também pode selecionar o nó provisório e escolher o evento em Tipo de gatilho no inspetor. Uma automação pode ter mais de um gatilho; cada um inicia os nós conectados a ele.
Cada nó tem um ponto à esquerda para a linha de entrada e um ou mais pontos à direita para as linhas de saída. Para conectar dois nós, arraste de um ponto à direita do primeiro nó até o ponto à esquerda do próximo. Algumas regras se aplicam:
- Um gatilho não tem linha de entrada, e nada pode vir depois de um nó Fim.
- Um nó não pode se conectar a si mesmo.
- Uma linha não pode voltar a um nó que vem antes no fluxo. O editor não deixa você desenhá-la. Para repetir etapas, use Repetir.
- Uma entrada aceita uma linha. Se você desenhar uma segunda linha para a mesma entrada, ela substitui a primeira. Só gatilhos podem compartilhar uma entrada.
Para mover uma linha, arraste uma das pontas dela para outro ponto. As mesmas regras se aplicam, e se você soltar em qualquer outro lugar, a linha fica onde estava.
Para remover uma linha ou um nó, clique nele e pressione a tecla Backspace. Ctrl+Z desfaz sua última alteração, e Ctrl+Shift+Z a refaz. No Mac, use Cmd em vez de Ctrl.
Condições, ramificações e atrasos
Organizar e se movimentar
Layout automático na barra superior organiza todos os nós da esquerda para a direita ao longo das conexões e ajusta o fluxo à visualização. É a forma mais rápida de organizar um fluxo depois de adicionar várias etapas.
O ponto de interrogação ao lado abre Ajuda, um guia curto para se movimentar na tela, com uma aba para mouse e outra para trackpad:
- Mover a tela: arraste a tela com o botão esquerdo do mouse ou com um dedo.
- Zoom: role a roda do mouse ou faça o gesto de pinça no trackpad.
- Selecionar vários nós: mantenha Ctrl (Cmd no Mac) pressionado e clique neles.
Em uma tela menor, Layout automático e as outras ferramentas vão para o menu ao lado de Salvar.
Integrações que ainda não estão conectadas
Blocos de uma integração que você ainda não conectou aparecem esmaecidos na biblioteca com o chip Conectar. Você não pode arrastá-los. Clique em um deles, e a caixa de diálogo para conectar esse serviço se abre. Assim que a conexão funcionar, o bloco é adicionado à tela na hora.
Adicionar integração na parte inferior da biblioteca abre a mesma caixa de diálogo sem um bloco, por exemplo para conectar um serviço antes de começar a montar.
Se um nó na tela pertence a uma integração que não está conectada, o inspetor dele mostra Não conectada com um link Conectar, e o nó conta como um problema (veja abaixo). Para ações que precisam de uma conta, escolha-a em Integração no inspetor. Se ainda não houver nenhuma, o botão Adicionar integração conecta uma.
Configurar um nó no inspetor
Clique em um nó para abrir o inspetor à direita. O cabeçalho dele mostra o tipo de nó, por exemplo Gatilho ou Ação, e o nome. Abaixo você preenche as configurações desse nó. Campos obrigatórios são marcados com um asterisco. Nós sem configurações, como Fim, mostram "Nenhum campo para configurar".
Na parte inferior do inspetor:
- Excluir remove o nó e as linhas dele.
- O ícone de cópia (Duplicar) coloca uma cópia do nó com as mesmas configurações, um pouco deslocada na tela.
- Salvar salva a automação inteira.
Pressione Esc ou o X no cabeçalho para fechar o inspetor. No celular, o inspetor termina acima da barra de navegação, para que esses botões fiquem ao alcance.
Um gatilho tem campos próprios no inspetor. Alguns o restringem a um item, por exemplo Curso ou Dias de inatividade. Eles ficam logo abaixo de Tipo de gatilho, antes de Condições.
Os campos de texto de muitas ações, por exemplo o assunto e o corpo de um
e-mail, aceitam marcadores como ou [|First Name|]. Quando a
automação é executada, eles são substituídos pelos dados do membro. Os nós de
controle trabalham com valores do gatilho, escritos como {{key}}. Quais
campos cada gatilho e cada ação têm, e a lista completa de marcadores, estão
no artigo sobre gatilhos e ações.
A aba Execução
Quando você abre uma execução em Execuções, a tela passa para uma repetição somente leitura dessa execução. O inspetor passa a ter duas abas: Configurações mostra as configurações do nó como estavam, e Execução mostra o estado, os horários e os dados que entraram e saíram.
Testes e histórico de execuções
Corrigir problemas
O editor verifica o seu fluxo enquanto você trabalha. Um nó com um problema recebe um sinal de aviso, e um triângulo amarelo com o número de problemas aparece na barra superior. Passe o mouse sobre o triângulo para ver a lista; clique nele para ir ao primeiro nó com um problema. O inspetor desse nó lista os problemas dele no topo.
Problemas típicos são:
- "O gatilho não tem nenhum tipo de evento selecionado."
- "“Dias de inatividade” deve ser 1 ou mais."
- "A ação não tem nenhum tipo selecionado."
- "A integração necessária não está conectada."
- "O atraso não tem duração."
- "Nenhum fluxo de trabalho selecionado em “Executar fluxo de trabalho”."
- "Nenhuma conexão de entrada. Este nó não pode ser alcançado."
A lista completa, com o que fazer, está em Testes e histórico de execuções.
Salvar continua funcionando com problemas pendentes, então você pode parar no meio e voltar depois. Mas a automação pode não funcionar como pretendido até eles serem corrigidos. Se o fluxo tiver um erro estrutural, por exemplo quando você excluiu todos os gatilhos, o salvamento é interrompido com "O fluxo tem um erro de estrutura e não pôde ser salvo."
Salvar e ativar
Clique em Salvar ou pressione Ctrl+S (⌘S no Mac). A dica do botão e o tour de introdução mostram o atalho do seu dispositivo. O botão mostra Salvo por um momento. Enquanto houver alterações não salvas, o botão fica destacado, e o navegador pergunta antes de você fechar a aba.
O interruptor Ativo na barra superior decide se a automação é executada. Uma automação nova começa desativada. O interruptor passa a valer quando você salva.
Quando você a ativa com problemas pendentes, o editor pede uma confirmação e mostra a lista de problemas. Ativar a ativa mesmo assim. Salvar com o interruptor ligado é interrompido com uma mensagem se um nó precisa de uma integração que não está conectada, ou se a automação está arquivada.
Versões, publicação e reversão
Cada salvamento cria uma nova versão. Só uma versão está em funcionamento por vez: a publicada. Assim você pode trabalhar em um fluxo sem mudar o que acontece para os seus membros até estar pronto.
- O primeiro salvamento de uma automação é publicado imediatamente.
- Cada salvamento posterior é um rascunho. Uma nota no topo da tela diz "Salvo como rascunho. Estas alterações ainda não estão ativas." Clique em Publicar nessa nota para colocar o rascunho em funcionamento. A nota aparece depois de salvar, depois de uma reversão e sempre que você abre uma automação cuja versão mais recente não está publicada.
- Na lista de automações, um ícone de lápis amarelo marca uma automação com Alterações não publicadas.
Uma execução de teste sempre usa a sua última versão salva, então você pode testar um rascunho antes de publicá-lo.
O painel Versões
Versões na barra superior lista até as últimas 100 versões, da mais nova para a mais antiga, com o horário e o membro da equipe que salvou. Etiquetas mostram qual versão é qual:
- Editando: a versão que você vê no editor.
- Publicado: a versão que é executada.
- Rascunho: uma versão que nunca foi publicada.
Selecione uma versão para compará-la com o que está na tela agora. A comparação lista o que mudaria ao reverter para essa versão, separado em Bloco adicionado, Bloco removido, Tipo de bloco alterado, Bloco reconfigurado, Conexão adicionada e Conexão removida. Se nada for diferente, você vê "Estas versões são idênticas."
Dois botões ficam abaixo da comparação:
- Publicar coloca a versão selecionada em funcionamento. Ele não aparece quando a versão já é a publicada. A publicação é interrompida com uma mensagem se a versão usa uma integração que não está conectada.
- Reverter para esta versão copia a versão selecionada em uma nova versão e a carrega no editor. Para a versão que você está editando, o botão mostra Versão atual e não pode ser clicado.
Uma reversão substitui a tela. Se você tiver alterações não salvas, o editor pergunta antes: "Você tem alterações não salvas. Reverter as substitui por esta versão. Reverter mesmo assim?" A nova versão é um rascunho e não entra em funcionamento sozinha. Clique em Publicar na nota no topo da tela, ou abra Versões de novo, selecione a versão marcada com Editando e clique em Publicar.
Duplicar e excluir
O menu ao lado de Salvar tem mais duas ações:
- Duplicar cria uma cópia da automação a partir da última versão salva e a abre no editor. A cópia recebe "(Cópia)" depois do nome, começa desativada e já tem essa versão publicada. Alterações não salvas não são copiadas, então salve antes.
- Excluir pergunta "Excluir esta automação? Ela vai para a lixeira. Você pode restaurá-la em Configurações, Lixeira." Depois que você confirma, ele leva você de volta à lista. Você pode restaurar a automação em Configurações > Lixeira.
As duas ficam disponíveis assim que a automação tiver sido salva.
O tour de introdução
Na primeira vez que você abre o editor, um pequeno cartão na parte inferior da tela chamado Tour pelo editor guia você por quatro etapas: arrastar um gatilho, arrastar uma ação, conectá-los e salvar. O cartão avança sozinho conforme você conclui cada etapa e fecha pouco depois da última. Pular o esconde na hora. De qualquer forma, ele fica oculto nesse navegador a partir de então.
No celular, o cartão fica à direita da faixa da biblioteca e acima da barra de navegação, para que todas as etapas continuem legíveis.