Gatilhos e ações

Um gatilho é o evento que inicia uma automação, por exemplo um novo membro ou um curso concluído. Uma ação é o que a automação faz em seguida, por exemplo adicionar uma tag ou enviar um e-mail. Este artigo lista todos eles com os respectivos campos.

Abrir automações

Onde encontrá-los

No editor, a Biblioteca tem duas abas: Gatilhos e Ações. Os blocos nativos ficam em MemberArea, agrupados em Membros, Pagamentos, Cursos, Comunidade, Eventos, Afiliados e Utilities. As integrações vêm em seguida, com o próprio nome. Buscar etapas… pesquisa em nomes e descrições. Clique em um bloco ou arraste-o para a tela e depois clique nele para preencher os campos.

Criar uma automação

Gatilhos de membros

• Novo Membro: uma conta de membro é criada.
• Novo contato: um contato é criado, por exemplo por meio de um formulário de inscrição. Um contato ainda não é membro, então as ações de membro não fazem nada até você usar Converter contato em membro.
• Campo de membro alterado: um campo de membro muda. Escolha o campo em Campo de Membro para reagir só a esse campo; se ficar vazio, qualquer campo conta. O novo valor fica disponível para as etapas como {{value}}. Depois que um campo foi limpo, ele fica vazio.
• Membro entrou: um membro faz login, uma vez por sessão.
• Tag aplicada e Tag removida: uma tag é adicionada a um membro ou removida dele. Escolha a tag em Tag para reagir só a essa tag; se ficar vazio, qualquer tag conta.
• Membro da equipe convidado: um administrador convida um novo membro da equipe.
• Membro inativo: é executado uma vez quando um membro não faz login há um certo número de dias. Informe o número em Dias de inatividade, veja "Restringir um gatilho" abaixo. Membros que já estão inativos quando você ativa a automação são pulados; ela reage aos membros que ficam inativos a partir de então.

Gatilhos de pagamento

• Novo cliente: um pedido pago cria uma nova conta de membro.
• Novo pedido: um novo pedido é pago.
• Checkout concluído: um comprador conclui um checkout online, seja qual for o provedor de pagamento que o processou.
• Pagamento em processamento: um pagamento diferido, como débito SEPA, Klarna ou Sofort, foi autorizado e o dinheiro ainda está a caminho. O comprador já tem acesso.
• Falha no pagamento: o pagamento de um pedido é recusado, ou um valor que já tinha sido registrado como pago é estornado dias depois.
• Assinatura renovada: uma assinatura recorrente é renovada com sucesso.
• Pagamento reembolsado: um pedido é reembolsado, total ou parcialmente.
• Assinatura cancelada: um membro cancela uma assinatura.
• Renovação em breve: é executado um número definido de dias antes da renovação de uma assinatura. Informe o número em Dias antes da renovação.

Gatilhos de cursos

• Aula concluída: um membro conclui uma aula.
• Curso concluído: todas as aulas obrigatórias de um curso são concluídas.
• Progresso no curso atingido: é executado uma vez quando o progresso de um membro em um curso ultrapassa uma porcentagem. Informe-a em Limite percentual, por exemplo 50. Sem ela, o gatilho é executado a cada passo de progresso.
• Prova aprovada e Prova reprovada: um membro é aprovado ou reprovado em uma prova.

Os cinco podem ser restringidos a um curso com Curso. Uma aula ou uma prova pode estar em um módulo compartilhado por vários cursos. A automação continua sendo iniciada uma vez por aula concluída ou resultado de prova, e Curso corresponde quando qualquer um desses cursos é o que você escolheu.

Gatilhos da comunidade

• Comunidade: publicação criada: um membro cria uma publicação, uma discussão ou uma enquete. Fórum restringe o gatilho a um fórum.
• Comunidade: membro subiu de nível: um membro alcança um nível mais alto.
• Comunidade: denúncia aberta: um conteúdo é denunciado por um membro ou pelo sistema.
• Distintivo obtido: um membro recebe um distintivo da comunidade. Distintivo restringe o gatilho a um distintivo.

Gatilhos de eventos

• Inscrição em evento: um membro se inscreve em um evento.
• Presença no evento: um membro é marcado como presente, por exemplo no check-in.
• Evento prestes a começar: é executado um tempo definido antes do início de um evento, uma vez para cada membro inscrito. Informe as horas em Horas antes do início, por exemplo 24.

Evento restringe os dois primeiros a um evento.

Gatilho de afiliados

Comissão de afiliado aprovada é executado quando uma comissão é aprovada e bloqueada para pagamento. Ele só dispara quando você tem um programa de parceiros.

Agendamento e webhook

Por agendamento

Por agendamento (cron) inicia a automação em horários fixos. Ele tem dois campos:

• Cron expression (obrigatório): cinco partes para minuto, hora, dia do mês, mês e dia da semana. 0 9 * * * significa todos os dias às 09:00, 0 9 * * 1 toda segunda-feira às 09:00.
• Fuso horário: o fuso horário a que os horários se referem, por exemplo Europe/Berlin. É UTC quando você o deixa vazio.

O agendamento é verificado a cada minuto. A primeira execução acontece no próximo horário correspondente depois que você ativa a automação. Uma execução agendada não tem membro, então use-a para etapas que não precisam de um, como uma requisição externa ou uma integração que publica para a sua equipe.

Webhook de entrada

Webhook de entrada inicia a automação quando outro sistema envia uma requisição para ela, por exemplo o seu site, uma ferramenta de formulários ou o Zapier.

1. Adicione o gatilho e salve a automação. Até lá, o painel mostra "Salve a automatização para gerar a URL e o segredo do webhook." Uma automação criada a partir de um modelo, uma duplicata ou uma cópia para outra empresa já tem endereço e segredo próprios desde o início.
2. Clique no gatilho. O painel mostra a URL do webhook com Copiar URL e o Segredo com Copiar segredo.
3. No outro sistema, envie uma requisição POST para a URL. Coloque o segredo no cabeçalho X-Automation-Secret. Envie os dados como JSON.

Cada campo de primeiro nível do corpo fica disponível para as etapas como {{field}}. Se o corpo contiver member_email com o endereço de um dos seus membros, a execução pertence a esse membro, e as ações e os marcadores de membro funcionam.

A automação precisa estar ativada e publicada. Caso contrário, a chamada é recusada, assim como acontece com um segredo errado ou ausente. Cada automação aceita até 120 chamadas por minuto. As chamadas seguintes são recusadas até o minuto terminar.

Por padrão, quem chama recebe {"ok": true, "triggers_fired": 1} na hora, e as etapas são executadas em segundo plano. Se uma etapa Responder ao webhook vier depois desse gatilho no fluxo, quem chama aguarda e recebe o status e o corpo que você definiu nessa etapa. Coloque-a antes de qualquer atraso; caso contrário, quem chama recebe a resposta padrão. Uma etapa Responder ao webhook em um caminho que esse gatilho nunca alcança não muda nada.

Condições, ramificações e atrasos

Rotacionar segredo cria um novo segredo depois que você confirma. O antigo para de funcionar imediatamente, então atualize todos os sistemas que o usam.

Restringir um gatilho

Muitos gatilhos têm campos que os restringem a um item ou definem um horário. Eles ficam nas configurações do gatilho, logo abaixo de Tipo de gatilho, antes de Condições.

• Curso, Evento, Fórum e Distintivo são listas com os nomes dos seus itens. A primeira opção, como Qualquer curso ou Qualquer evento, remove o filtro de novo, e o gatilho reage a qualquer item.
• Campos sem lista, como Produto, Lição ou Calendário, recebem o ID do item. Para ver quais IDs um gatilho envia, abra uma execução anterior em Execuções e veja a Entrada do gatilho.

Três gatilhos precisam de um número e nunca são iniciados sem ele:

Informe um número inteiro igual ou maior que 1. Enquanto o campo estiver vazio ou abaixo de 1, o editor marca o gatilho com um aviso como "“Dias de inatividade” deve ser 1 ou mais." e o lista entre os problemas quando você ativa a automação.

Gatilhos sem esses campos, por exemplo Novo Membro ou os gatilhos de uma integração, mostram Filtros no lugar. Cada linha é uma chave e um valor, e o gatilho só inicia a automação quando o evento traz exatamente esse valor nessa chave. Use Adicionar para mais linhas; todas as linhas precisam corresponder.

Testes e histórico de execuções

Condições sobre o membro

Condições verifica o membro antes de a automação começar. Cada linha é o nome de um campo da conta de membro e um valor, por exemplo language e de. O gatilho só inicia a automação quando o membro tem exatamente esses valores em todas as linhas.

Para verificar mais coisas, como uma tag que o membro tem ou um campo personalizado, adicione uma etapa Condição ou Filtrar depois do gatilho.

Condições, ramificações e atrasos

Ações de membros

As ações de membros atuam sobre o membro da execução.

• Adicionar Tag e Remover tag: Tag escolhe a tag.
• Adicionar ao grupo e Remover do grupo: Grupo escolhe o grupo.
• Conceder acesso ao curso e Revogar acesso ao curso: Curso escolhe o curso. Um curso que não está publicado não é concedido; a execução registra que nada mudou.
• Definir campo de membro: Campo de Membro e Valor. O valor é salvo como você o digita.
• Limpar campo de membro: Campo de Membro é esvaziado para o membro.
• Converter contato em membro: cria uma conta de membro a partir de um contato e transfere os campos dele. Enviar e-mail de boas-vindas vem ativado por padrão.
• Desativar membro: desativa a conta do membro na sua plataforma.
• Enviar e-mail: um e-mail para o membro, sem link de cancelamento de inscrição. Para e-mails de marketing, use uma sequência de e-mails. Assunto e Corpo são obrigatórios. Destinatário fica vazio para escrever ao membro, ou recebe o endereço de e-mail de outro membro da sua plataforma.
• Enviar SMS: envia uma mensagem de texto pelo Twilio. Mensagem é obrigatório. Preencha Twilio Account SID, Twilio Auth Token e From number; sem os três, nenhum SMS é enviado. Em To number, informe um número ou [|Phone|] para o telefone do membro. Se você conectou o Twilio como integração, a ação Enviar SMS própria dele usa essa conexão.

Ações da comunidade

• Criar publicação na comunidade: publica uma publicação no Fórum escolhido em nome do membro. Fórum lista os fóruns da sua plataforma pelo nome e exige que a comunidade esteja ativada. Título da publicação é opcional, Post body é obrigatório.
• Conceder selo: dá ao membro o Distintivo escolhido.
• Conceder pontos: dá ao membro Pontos, que contam para os níveis. Motivo é opcional e aparece no histórico de pontos.

Fazer requisição externa

Fazer requisição externa envia uma requisição HTTP para um servidor de sua escolha, por exemplo para passar um novo membro para o seu próprio sistema. Clique em Adicione sua solicitação para abrir Editar solicitação:

• Tipo de requisição: GET, POST, PUT ou DELETE.
• URL da requisição: um endereço https. O campo oferece campos de membro para inserir como marcadores.
• Cabeçalhos: Adicionar cabeçalho de requisição adiciona uma Chave e um Valor.
• Corpo: o Corpo da requisição como JSON, com uma Prévia ao lado.
• Resposta: a resposta do seu último teste.

Testar requisição envia a requisição na hora com o membro que você escolheu em Membro para teste. A aba Resposta então mostra Cabeçalhos da resposta, Corpo da resposta, Cabeçalhos da requisição e Corpo da requisição. Só endereços públicos são permitidos, e a requisição não segue redirecionamentos. Salvar guarda a requisição.

Em uma execução, a requisição é enviada como JSON com um limite de tempo de 15 segundos. Se o seu servidor responder com um erro, não responder a tempo ou redirecionar, a etapa falha, e a execução também. O erro mostra o status e o início da resposta, por exemplo "A solicitação retornou HTTP 503: Service Unavailable". Teste a requisição antes de ativar a automação.

Marcadores

Marcadores de membro

Os campos de texto das ações, como o assunto e o corpo de um e-mail, a mensagem de SMS, a publicação, o motivo dos pontos e a requisição externa, substituem estes marcadores pelos dados do membro:

• [|First Name|] ou : nome
• [|Last Name|] ou : sobrenome
• [|Email|] ou : endereço de e-mail
• [|Phone|] ou {settings.phone}: telefone do perfil
• [|Language|] ou : idioma
• [|Member Id|] ou : ID do membro
• [|Image|] ou : imagem do perfil
• [|Registered at|] ou : data e hora do cadastro
• [|Last Login|] ou : data e hora do último login
• [|Full Member Data|]: todos os dados do membro como JSON

Um campo de membro aparece como [|cf_…|] ou {cf_…} com o ID do campo; a requisição externa o insere para você. Quando uma execução não tem membro, o nome, o sobrenome, o e-mail e o telefone vêm dos campos first_name, last_name, email e phone dos dados do gatilho, se eles existirem.

Marcadores de dados

As etapas Definir campos, Condição, Filtrar, Comparar, Repetir, Aguardar até a data e Responder ao webhook leem os dados da execução:

• {{key}} pega um valor dos dados do gatilho ou de uma etapa anterior, por exemplo {{amount}} de um pedido ou um campo que o seu webhook enviou.
• {{member.first_name}} e outros marcadores {{member.…}} leem o membro da execução. {{member.tags}} e {{member.groups}} retornam as tags e os grupos do membro.
• {{member.cf_…}} com o ID de um campo personalizado lê o valor desse campo do membro como está armazenado. O ID é o mesmo do marcador {cf_…} acima.

Os campos das ações não leem {{key}}. Para usar dados do webhook em um e-mail, vincule a execução a um membro com member_email e use os marcadores de membro.

Gatilhos e ações de integrações

Quando você conecta um serviço, os gatilhos e as ações dele aparecem na biblioteca com o nome do serviço. Enquanto ele não está conectado, eles ficam esmaecidos com Conectar; clicar em um deles abre a caixa de diálogo de conexão, e Adicionar integração na parte inferior da biblioteca conecta outros serviços. Uma automação com um serviço que não está conectado não pode ser ativada. Integração na ação escolhe a conta conectada a ser usada.

Os gatilhos vêm de Stripe, GoHighLevel, Calendly, Digistore24, Shopify, Hotmart, CopeCart e WooCommerce, por exemplo para compras, reembolsos, cancelamentos ou agendamentos.

Há ações disponíveis para:

• Ferramentas de automação: Webhooks, Zapier, Make, n8n e Pabbly.
• E-mail e CRM: ActiveCampaign, Brevo, Customer.io, Drip, Flodesk, GetResponse, GoHighLevel, HubSpot, Intercom, Kit, Klaviyo, KlickTipp, Mailchimp, ManyChat, Pipedrive e Quentn.
• Mensagens: Discord, Slack, Twilio e WhatsApp.
• Loja e contabilidade: Shopify, lexoffice e sevDesk.
• Ferramentas de trabalho: Airtable, Asana, ClickUp, Coda, Google Sheets, monday.com, Notion, Trello e Zoom.

Conectar outras ferramentas

Iniciar automações pela API

Com uma chave de API, o seu próprio software pode listar as suas automações, iniciar uma com dados próprios e ler as execuções dela.

Chaves de API e acesso para desenvolvedores

Artigos relacionados

• Visão geral das automações
• Criar uma automação
• Condições, ramificações e atrasos
• Testes e histórico de execuções