Execuções, limites e recuperação
Entenda pausas, falhas confirmadas, resultados incertos e consumo do plano.
Estados da execução
| Estado | O que significa / ação |
|---|---|
| Na fila | Evento persistido aguardando o executor |
| Executando | Worker processando a etapa atual |
| Aguardando | Espera programada, horário, vendedor/canal indisponível, limite do canal ou resposta de envio |
| Concluído | Todas as etapas do caminho terminaram |
| Falha confirmada | Há um erro a corrigir; um administrador pode retomar a etapa dentro do prazo |
| Cancelado | Cancelamento explícito, resposta, opt-out, arquivamento, prazo vencido ou mudança incompatível de estado |
| Revisão necessária | O destino pode ter aceitado a operação, mas a Vensy não conseguiu confirmar o resultado |
Abra Ver etapas para consultar saídas, tentativas e motivos. A versão de uma execução não muda quando outra versão é publicada. O histórico de execuções concluídas é retido por 90 dias; não o use como arquivo permanente da integração.
Pausar, cancelar e retomar
Pausar impede novas admissões e estaciona execuções existentes. Reative publicando após revisar o rascunho; as execuções antigas continuam usando sua própria versão. A pausa não estende o prazo máximo da execução.
Cancelar encerra aquela execução, mas não desfaz contato, negócio, tag, aviso ou mensagem já processados. Uma requisição que já saiu para um provedor não pode ser recolhida.
Retomar falha confirmada exige confirmação do administrador. Etapas já concluídas não são repetidas. Uma mensagem comprovadamente rejeitada pode ganhar uma nova tentativa explícita; eventos antigos da fila não podem executar essa nova tentativa. Resultado incerto não oferece retry automático nem o botão de retomar: confira o provedor antes de decidir iniciar outro evento.
Falhas transitórias seguras têm backoff limitado. Uma chamada HTTP mutante não é repetida quando não há garantia de idempotência. Nunca interprete “não recebi resposta” como “o destino não executou”.
Cotas e cadência
automationsEnabled: habilitação da feature no plano/override.activeAutomations: número de fluxos ativos; rascunhos e pausados não ocupam esse cap.automationExecutionsPerMonth: eventos admitidos no mês-calendário UTC, separado do ciclo de cobrança de mensagens.
Simulação, captura de amostra, duplicata e retomada da mesma execução não gastam outra execução mensal. Cancelar não devolve a admissão consumida. O número de mensagens depende dos blocos percorridos; uma execução não equivale a uma mensagem.
O limite administrativo de automações não altera a cadência de WhatsApp. API, campanhas e automações compartilham as proteções por canal já configuradas na Vensy. Mensagens continuam sujeitas a janela oficial, saldo, supressão e disponibilidade. Habilitar a feature não autoriza aumentar esses limites.
Há proteções técnicas adicionais: até 200 definições por workspace (incluindo arquivadas), 80 blocos por definição, até 30 dias por execução e até 5 tentativas automáticas para erros transitórios seguros. Esperas por horário/presença não gastam tentativas de erro.
Falhas comuns
| Código/motivo | Como resolver |
|---|---|
AUTOMATION_WEBHOOK_UNAUTHORIZED | Confira URL, modo de autenticação, segredo/assinatura ou proteção do formulário |
AUTOMATION_IDEMPOTENCY_CONFLICT | A mesma chave veio com outro conteúdo; corrija a origem, não masque um retry com nova chave |
AUTOMATION_NOT_ACTIVE | Publique/ative o fluxo correto |
AUTOMATION_TRIGGER_MISMATCH | Use webhook somente em fluxo cujo gatilho é Webhook |
AUTOMATION_CONTACT_AMBIGUOUS | Unifique contatos duplicados no CRM |
AUTOMATION_TEAM_UNAVAILABLE | Na política online, não há ninguém com presença recente e capacidade; aguarde ou use conscientemente o rodízio com todos os ativos |
AUTOMATION_CHANNEL_UNAVAILABLE | Reconecte o canal e aguarde a retomada |
AUTOMATION_CONSENT_REQUIRED | Registre/mapeie o consentimento real antes de um envio proativo |
AUTOMATION_OFFICIAL_TEMPLATE_REQUIRED | Use template aprovado fora da janela oficial |
AUTOMATION_HTTP_HOST_UNSAFE | Escolha um domínio HTTPS público; redes privadas não são permitidas |
ENTITLEMENT_* | O app mostra a limitação de plano e a opção de liberação/upgrade |
Administradores devem fornecer apenas os dados necessários ao fluxo e escolher destinos HTTP confiáveis. Credenciais cadastradas são protegidas, mas dados pessoais de entrada e saídas comerciais continuam visíveis a administradores autorizados no histórico. A integração é responsável por capturar a permissão do lead e respeitar sua finalidade.
Referências: política do WhatsApp Business e orientação OWASP contra SSRF.