Pular para o conteúdo
PTEN

Gatilhos

O evento que inicia o workflow. Cada workflow tem um, e esse evento define quais dados você pode usar no resto das etapas.

Como funcionam

  • Um por workflow. Se você quiser reagir a dois eventos diferentes, crie dois workflows. Você pode usar Duplicar para não começar do zero.
  • Uma execução por evento. Cada vez que o evento acontece, é criada uma execução independente. Dez orçamentos enviados são dez execuções.
  • Só daqui para a frente. Um workflow reage aos eventos que acontecem depois de publicado, não aos anteriores.
  • Não importa quem o provoca. O evento conta se foi feito por alguém da equipe, pelo cliente no link dele, pela API, por um agente de IA via MCP ou por outro workflow. Se a origem importar para você, use o dado Quem originou em uma condição.

No editor, clique em Adicionar um gatilho e use Busque um gatilho ou as categorias para encontrá-lo: Você executa, Agendado, Orçamentos, Aprovações, Pagamentos, Faturas, Clientes, Produtos, Tarefas e promessas e Automações. Antes de digitar, aparecem primeiro os Sugeridos (os dois de Você executa e o agendado, que não dependem de algo acontecer na sua conta) e depois o resto, agrupado por categoria.

Busca de gatilhos de um workflow novo, filtrada por Faturas: os 11 eventos de faturas, de “Um orçamento é faturado” a “Uma fatura é marcada como incobrável”.

Dados que trazem

Quase todos os gatilhos de um mesmo tipo de objeto compartilham dados. Para não repeti-los em cada tabela, estes são os grupos:

Grupo Dados
Dados de orçamento Número, Cliente, Total, Moeda, Status no evento, Status atual do orçamento, Quem originou
Dados de fatura Número, Cliente, Total, Saldo pendente, Moeda, Data de vencimento, País, Status no evento, Status atual da fatura, Quem originou
Dados de cliente Empresa, E-mail, País, Condições de pagamento, Quem originou
Dados de produto Nome, Preço de tabela, Ativo, Quem originou

Além disso, todos os gatilhos trazem os dados do seu negócio: nome, e-mail de contato, telefone, moeda e a data de hoje no seu fuso horário.

O nome exato de cada dado para usá-lo em textos (por exemplo {{saldo_pendiente}}) está em Dados do evento.

Só quando: filtrar o gatilho

No painel do gatilho, Adicionar um filtro define as condições que o evento precisa atender para que o workflow seja executado, por exemplo “Total é maior que R$ 200.000,00” ou “Número contém MAY”.

  • Um evento que não atende não cria execução: não aparece em Execuções. Essa é a diferença em relação a colocar uma condição como primeira etapa, que deixa uma execução para cada evento.
  • O filtro lê os dados que o evento traz. O que o Cord lê ao vivo do documento, como Status atual do orçamento, não pode ser usado aqui: use isso em uma condição ou em uma espera.
  • Você pode exigir que todas as condições sejam atendidas ou que baste uma, como em uma condição.
  • Na tela, o gatilho mostra “Só quando” com a primeira condição.
  • Testar usa o último evento que atende ao filtro, entre os 20 mais recentes desse gatilho.
  • O gatilho agendado não tem filtro: ele não traz um evento para filtrar.

Quantas vezes entra

Para não repetir o mesmo, o painel do gatilho tem Quantas vezes entra:

Opção O que faz
Toda vez que acontece Cada evento cria sua execução. É o normal.
Uma vez por documento Um orçamento ou uma fatura que já entrou não cria outra execução, mesmo que o evento se repita.
Uma vez por cliente Conta por cliente: se ele já entrou com um orçamento, outro do mesmo cliente não o coloca de novo. Só aparece em gatilhos que trazem cliente.

Com Pode entrar de novo depois de (dias), o documento ou o cliente entra de novo quando passam esses dias desde a última vez; vazio, nunca volta. Por exemplo, “Uma vez por cliente” com 30 dias envia um lembrete de cobrança no máximo uma vez por mês a cada cliente.

  • Conta a entrada, não o resultado: uma execução que falha também conta.
  • Se o evento não traz esse cliente, a execução é criada como qualquer outra em vez de se perder.
  • Funciona junto com o filtro: um evento que não passa no filtro não conta como entrada.

Você executa

Dois gatilhos não são provocados por um evento, mas por uma pessoa: Você o executa a partir de um orçamento e Você o executa a partir de uma fatura. Servem para o que não tem um momento fixo, como pedir um adiantamento, enviar uma sequência de cobrança ou avisar a equipe de uma venda especial.

Gatilho Quando acontece Dados
Você o executa a partir de um orçamento Alguém o executa em um ou vários orçamentos. Os de qualquer orçamento
Você o executa a partir de uma fatura Alguém o executa em uma ou várias faturas. Os de qualquer fatura
  • A partir do documento: no detalhe de um orçamento ou de uma fatura, a seção Workflows mostra os workflows ativos desse tipo; clique em um para executá-lo nesse documento.
  • Em lote: no editor do workflow, Executar agora abre a lista de documentos recentes; escolha até 50 e cada um inicia a própria execução.
  • Com qual versão: sempre a publicada. Se o workflow estiver em rascunho ou pausado, não é oferecido.
  • Quem pode executá-lo: quem tem a permissão Orçamentos para um orçamento e Cobrança para uma fatura. As ações são feitas com as permissões de quem publicou o workflow, como sempre.
  • O filtro Só quando… e Quantas vezes entra valem do mesmo jeito: um documento que não os cumpre não roda, e o Cord avisa.
  • Quem originou é Alguém da equipe; a partir do seu sistema, com POST /v1/workflows/{id}/invoke da API ou a ferramenta MCP correr_workflow, é A API ou Um agente de IA (MCP).

Agendado

Um workflow nem sempre reage a algo: ele também pode ser executado em um horário fixo. É o único gatilho que você mesmo configura.

Campo Detalhe
Frequência Todos os dias, toda semana ou todo mês.
Dia Da semana (segunda a domingo) ou do mês (1 a 28).
Hora Em hora cheia, no fuso horário da sua conta (Configurações › Geral). É executado na primeira verificação do Cord a partir desse horário; o Cord verifica a cada 5 minutos.

Traz os dados do próprio disparo: Data, Dia da semana, Dia do mês e Hora, que você pode usar nos seus textos como {{fecha}}.

O dia do mês é limitado a 28 de propósito: um “31” pularia fevereiro em silêncio, e um fechamento mensal que não sai é pior do que um que sai três dias antes.

Um gatilho agendado não traz orçamento nem fatura, então as ações que atuam sobre um documento (marcar como expirado, cancelar, enviar um e-mail ao cliente) não podem ser usadas nele, e o editor avisa ao publicar. O que combina: consultas mais um aviso para a equipe, no Slack ou no Teams.

Quando você pausa um workflow agendado, o próximo disparo dele é apagado; ao retomá-lo, ele é recalculado a partir desse momento, então não dispara os horários que ficaram para trás enquanto estava pausado.

Orçamentos

Gatilho Quando acontece Dados
Um orçamento é criado Um orçamento novo é salvo, pelo app, pela API ou por um agente. Dados de orçamento
Um orçamento é enviado O orçamento é enviado ao cliente e o link dele fica ativo. Dados de orçamento
O cliente abre o orçamento O cliente abre o link público. Não conta quando alguém da sua equipe abre o link para revisá-lo. Dados de orçamento
Um orçamento é aprovado O orçamento fica aprovado. Dados de orçamento
Um orçamento é recusado O orçamento fica recusado. Dados de orçamento
Um orçamento é editado e reenviado Um orçamento que já estava enviado, visualizado ou expirado é reenviado ao cliente, normalmente depois de editado. Dados de orçamento mais Total anterior
Um orçamento expira A data de validade passa sem que ele seja fechado. O Cord verifica as validades uma vez por dia. Dados de orçamento
Um orçamento está prestes a expirar Todos os dias, enquanto faltarem entre 1 e 30 dias para a data de validade e o orçamento continuar enviado ou visualizado. Traz Dias até expirar e Data de validade: com uma condição, você escolhe o dia exato em que quer agir. Dados de orçamento mais os dois campos de data
Um rascunho é excluído Um orçamento em rascunho é excluído. Dados de orçamento, sem o status atual (o orçamento não existe mais)
Uma mensagem é recebida em um orçamento Alguém escreve no chat do orçamento. Dados de orçamento, Quem escreveu (O cliente ou A equipe) e Mensagem

Aprovações

Gatilho Quando acontece Dados
Um orçamento pede aprovação interna É criado um orçamento que, pelas suas regras de aprovação, precisa do aval de alguém da sua equipe antes de ser enviado. Dados de orçamento e Motivo
Uma aprovação interna é decidida A pessoa que aprova decide. Dados de orçamento e Decisão (Aprovada ou Recusada)

Pagamentos

Gatilho Quando acontece Dados
Um orçamento é pago integralmente O orçamento fica totalmente pago. Dados de orçamento
Um pagamento parcial é recebido Entra um pagamento que não cobre o total: uma entrada, um saldo ou uma parcela. Dados de orçamento, Valor pago, Saldo pendente e Tipo de pagamento (Entrada, Saldo ou Parcela)
Uma cobrança recorrente falha Não foi possível cobrar uma cobrança recorrente de um orçamento. Dados de orçamento
Uma contestação é aberta O banco do cliente abre uma disputa sobre um pagamento online. Número do orçamento, Cliente, Valor em disputa, Moeda, Motivo e Prazo para responder
Uma contestação é encerrada A disputa é resolvida. Os mesmos da contestação e Resultado (Ganho, Perdido ou Encerrado sem disputa)
Um reembolso é concluído Um reembolso chega ao cliente. Número do orçamento, Cliente, Valor reembolsado, Moeda e Motivo
Um reembolso falha Não foi possível concluir o reembolso. Os mesmos do reembolso e Motivo da falha
Um repasse é depositado na sua conta bancária O Cord Payments deposita seus recebimentos na sua conta bancária. Valor do repasse, Moeda e Data de chegada
Um repasse falha Seu banco recusa o repasse. Os mesmos do repasse e Motivo da falha
Sua conta de recebimento é alterada Muda o que sua conta do Cord Payments pode fazer: receber pagamentos, receber repasses ou se faltam dados. Pode receber pagamentos online, Pode receber repasses, Dados pendentes de verificação e Motivo do bloqueio

Os eventos de contestações, reembolsos, repasses e conta de recebimento vêm do Cord Payments, então só acontecem se você recebe pagamentos online com o Cord. Cada um é registrado uma única vez, mesmo que o processador de pagamentos avise várias vezes. O número do orçamento e o cliente chegam quando a movimentação é de um pagamento de orçamento; o reembolso do pagamento de uma fatura os traz vazios.

Faturas

Gatilho Quando acontece Dados
Um orçamento é faturado O orçamento é marcado como faturado com um documento que não é CFDI, por exemplo uma fatura comercial fora do México ou uma pró-forma. Dados de orçamento
O CFDI de um orçamento é timbrado O orçamento é marcado como faturado com um CFDI timbrado perante o SAT. Só no México. Dados de orçamento
Uma fatura é emitida Uma fatura do Cord Invoicing é emitida e recebe o número dela. Dados de fatura
Uma fatura é enviada A fatura é enviada ao cliente. Dados de fatura
Uma fatura é paga A fatura fica paga. Dados de fatura
O pagamento de uma fatura falha Uma tentativa de pagamento da fatura não foi aprovada. Dados de fatura
Uma fatura vence A data de vencimento passa com saldo pendente. O Cord verifica isso uma vez por dia. Dados de fatura
O vencimento de uma fatura se aproxima Todos os dias, enquanto faltarem entre 1 e 30 dias para o vencimento e a fatura continuar em aberto com saldo. Traz Dias até o vencimento e Data de vencimento. Dados de fatura mais os dois campos de data
Uma fatura está vencida há dias Todos os dias, a partir do dia seguinte ao vencimento e até 90 dias depois, enquanto a fatura continuar em aberto com saldo. Traz Dias de atraso. Dados de fatura mais os dois campos de data
Uma fatura é cancelada A fatura é cancelada. Dados de fatura
Uma fatura é marcada como incobrável Alguém marca a fatura como incobrável. Dados de fatura

Clientes

Gatilho Quando acontece Dados
Um cliente é criado Um cliente novo é adicionado. Dados de cliente
Um cliente é atualizado Os dados de um cliente mudam, inclusive as mudanças que chegam do HubSpot. Dados de cliente mais o valor anterior de Empresa, E-mail e Condições de pagamento
Um cliente é excluído Um cliente é excluído. Empresa e Quem originou

Produtos

Gatilho Quando acontece Dados
Um produto é criado Um produto é adicionado ao catálogo. Dados de produto
Um produto é atualizado Os dados de um produto mudam. Dados de produto mais o valor anterior de Preço de tabela e Ativo
Um produto é excluído Um produto é excluído do catálogo. Nome e Quem originou

Tarefas e promessas

Gatilho Quando acontece Dados
Uma tarefa é criada Uma tarefa é adicionada manualmente, por outro workflow, pela API ou pelo MCP. As tarefas que o Cord cria sozinho (contestação, reembolso SPEI) não o disparam. Título e Quem originou
Uma tarefa é concluída Uma tarefa é marcada como concluída. Título e Quem originou
Uma promessa de pagamento é registrada É registrado que um cliente prometeu pagar. Valor prometido, Data prometida e Quem originou
Uma promessa de pagamento é cumprida A promessa é marcada como cumprida. Valor prometido e Quem originou
Uma promessa de pagamento é descumprida A promessa é marcada como descumprida. Valor prometido e Quem originou

Automações

Avisam como terminam os seus próprios workflows: servem para você saber pelo Slack, pelo Teams ou por e-mail quando uma automação precisa de uma pessoa, sem conferir a aba Execuções.

Gatilho Quando acontece Dados
Uma execução de workflow falha ou requer atenção Uma execução de outro workflow termina Com falha ou para em Requer atenção. Workflow, Documento, Status, Motivo e Link para as execuções
Uma execução de workflow é concluída Uma execução de outro workflow termina sem erros. Workflow, Documento e Link para as execuções
  • Um workflow não é disparado pelas próprias execuções: o que avisa sobre falhas não avisa a si mesmo quando falha.
  • Para ouvir só um, adicione a condição “Workflow é igual a” com o nome dele.
  • Documento é o número ou o nome do que disparou a execução, se houver; em um workflow agendado fica vazio.

Gatilhos de tempo

Três gatilhos não são provocados por uma pessoa, e sim pelo calendário: Um orçamento está prestes a expirar, O vencimento de uma fatura se aproxima e Uma fatura está vencida há dias. O Cord os verifica uma vez por dia e os emite uma vez por documento e por dia, com a distância em dias como dado (Dias até expirar, Dias até o vencimento ou Dias de atraso).

  • Você escolhe o dia exato com uma condição, por exemplo “Dias até o vencimento é igual a 3”. Sem condição, o workflow seria executado todos os dias do período.
  • Só são gerados se um workflow ativo os escutar. Se nenhum dos seus workflows ativos usar esse gatilho, o Cord não o emite.
  • Não saem por webhooks, Zapier, Make nem n8n: quem estivesse inscrito receberia o mesmo aviso todos os dias. São exclusivos do Cord Workflows, assim como o gatilho agendado.

Os mesmos eventos fora dos workflows

41 dos 48 eventos também podem ser recebidos fora do Cord: nos seus webhooks e nos gatilhos do Zapier, do Make e do n8n. Os que só existem dentro do Cord Workflows são os três gatilhos de tempo, o agendado, os dois de execuções de workflows e os dois que você executa.

Gatilho No Cord Workflows Em webhooks, Zapier, Make e n8n
Os 41 eventos de orçamentos, aprovações, pagamentos, faturas, clientes, produtos, tarefas e promessas Sim Sim, com o nome técnico (por exemplo quote.approved)
Um orçamento está prestes a expirar Sim Não
O vencimento de uma fatura se aproxima Sim Não
Uma fatura está vencida há dias Sim Não
Em um horário fixo Sim Não
Uma execução de workflow falha ou requer atenção Sim Não
Uma execução de workflow é concluída Sim Não
Você o executa a partir de um orçamento Sim Não
Você o executa a partir de uma fatura Sim Não

Quem originou

Os gatilhos de orçamentos, aprovações, pagamentos de orçamentos, faturas, clientes, produtos, tarefas e promessas trazem Quem originou, com estes valores:

Valor Significa
O cliente Seu cliente fez isso pelo link dele: abrir, aprovar, recusar, pagar ou escrever.
Alguém da equipe Uma pessoa da sua organização, pelo app.
A API Uma integração com sua chave de API, por exemplo o Zapier ou o Make.
Um agente de IA (MCP) Um assistente de IA conectado via MCP.
Outro workflow Outro dos seus workflows.
O Cord automaticamente Um processo do Cord, como a verificação diária de vencimentos, ou uma mudança que chegou do HubSpot.

Um uso típico: em Uma tarefa é criada, adicionar a condição “Quem originou não é Outro workflow” para não reagir às tarefas que seus próprios workflows criam.

Relacionados