Skip to main content
Esta página descreve o comportamento que você observa ao usar automações — não a infraestrutura da Corvex.

​
O que acontece depois do evento

  1. O evento ocorre na loja (pagamento, PIX, carrinho, etc.).
  2. A plataforma localiza automações ativas da mesma loja com o mesmo trigger_event.
  3. Se já correu essa automação para o mesmo fato (mesmo pedido, lead ou e-mail, conforme o gatilho), não dispara de novo.
  4. Conditions escolhem o ramo. Metatags são preenchidas. Actions enviam a mensagem.
  5. Delays esperam os minutos configurados e seguem.
  6. O resultado aparece nos logs e métricas do painel.
A execução é assíncrona: salvar a automação não envia na hora; o envio ocorre quando o evento acontece.

​
Estados

​
Automação

Só active: true ou false.

​
Execução

Uma corrida da automação pode aparecer como iniciada, em andamento, concluída, falhou ou cancelada.

​
Passo

Um passo pode concluir, falhar, ser ignorado ou ficar bloqueado (por exemplo, sem créditos).

​
Duplicidade

A plataforma evita enviar a mesma automação duas vezes para o mesmo fato: O mesmo tipo de evento pode chegar mais de uma vez (várias confirmações de pagamento). A proteção de duplicidade agrupa o que for o mesmo pedido/lead.

​
Falhas e novas tentativas

  • Envio para provedor instável: a plataforma pode tentar de novo algumas vezes.
  • Depois das tentativas, a execução fica falhou.
  • Step retry no JSON tenta de novo os passos filhos, com a pausa em minutos que você configurou.
  • Metatag desconhecida ou sem valor: o texto sai vazio naquele trecho (não quebra o save, salvo validação estrita no painel).
  • webhook: POST HTTPS para data.url (contexto do evento, sem secrets).
  • create_coupon: cria cupom da loja (coupon_name, discountType, amount; coupon_code opcional).
  • Sem telefone ou e-mail do destinatário: a execução falha.
  • Sem créditos: a mensagem fica bloqueada.
  • cart.abandoned que falha no envio não é automaticamente reenviado (para não duplicar SMS). Vale conferir o log e, se preciso, tratar o caso no painel.

​
Por que a automação não enviou?

No painel, abra a automação, os logs e as métricas. Confira:
  1. Está active: true e o trigger_event é exatamente o evento que ocorreu?
  2. O evento foi desta loja?
  3. Já tinha corrido para o mesmo pedido ou lead?
  4. A condition usa um campo suportado e não está comparando valor vazio?
  5. A mensagem foi bloqueada por créditos?
  6. Em cart.abandoned, havia telefone/e-mail e checkout identificados?
  7. A metatag existe naquele gatilho? Senão o texto some, mas o envio pode ocorrer assim mesmo.
Identificadores úteis no painel: loja, automação, pedido, lead, checkout e o status da execução.

​
Isolamento e dados

  • Automações de uma loja não veem eventos de outra.
  • API Key (cvx_live_...) consulta metatags; não cria fluxos.
  • Não coloque senhas, tokens ou URLs secretas no JSON dos steps.
  • Metatags marcadas como sensíveis (e-mail, telefone, documento) carregam dados pessoais — use só no conteúdo da mensagem.
  • Uma LLM não deve gerar automação para outra loja.