Pular para o conteúdo
PTEN

Execuções e erros

Cada vez que um workflow é disparado, fica registrada uma execução com o detalhe do que ele fez, etapa por etapa.

Onde vê-las

  • Na lista de workflows, cada cartão mostra as execuções dos últimos 30 dias e, se houver, quantas terminaram com erro (“N com erro”).
  • Dentro do editor, a aba Execuções mostra as 50 mais recentes, da mais nova para a mais antiga. Clique em Atualizar para trazer as últimas.

Cada linha indica o status, o evento que a iniciou e quando aconteceu. Toque nela para ver o detalhe e clique em Ver na tela para ver o caminho sobre o fluxo: com a versão com que foi executada, mesmo que o rascunho já seja outro, cada etapa com seu resultado (feita, com erro ou aguardando), o ramo que cada decisão tomou e esmaecido o que não foi executado. Voltar a editar volta ao rascunho.

Aba Execuções: uma na fila, uma com falha porque o Slack não está conectado (com o detalhe passo a passo e o botão Tentar novamente), uma em espera que continua em 9 de out., 09:15 e várias concluídas.

Status de uma execução

Status O que significa
Na fila Foi criada e está prestes a ser executada, ou uma etapa falhou e ela espera a próxima tentativa. O detalhe mostra “Continua em” com a hora dessa tentativa.
Em execução Está sendo executada neste momento.
Em espera Chegou a uma etapa de espera. O detalhe mostra “Continua em” com a data.
Concluída Terminou todas as etapas que lhe cabiam.
Com falha Uma etapa falhou sem mais tentativas. As etapas seguintes não foram executadas.
Requer atenção Um envio ao cliente ou a outro sistema foi interrompido sem resposta e repeti-lo poderia duplicá-lo. A execução para até que alguém verifique o destino: Chegou: continuar segue sem repeti-lo; Não chegou: tentar de novo o envia novamente.
Cancelada Alguém a cancelou, ou o workflow ficou fora do plano ou o evento dele deixou de existir antes de terminar. Pausar o workflow não cancela nada: o que estava em andamento espera até você retomá-lo.

Resultado de cada etapa

Dentro do detalhe, cada etapa avaliada aparece com o resultado:

Resultado Significa
Concluído A ação foi concluída.
Erro A ação falhou. O motivo aparece abaixo.
Sem confirmação O envio foi interrompido sem resposta: não se sabe se chegou. Veja Nenhum efeito acontece duas vezes.
Em andamento A ação está sendo executada neste momento.
Atendida A condição foi verdadeira e o fluxo seguiu por “Se for atendida”.
Não atendida A condição foi falsa e o fluxo seguiu por “Se não for atendida”.
Aguardando A execução chegou a uma espera.
Prazo vencido Uma etapa Aguardar até que… chegou ao prazo sem que a condição fosse atendida e seguiu por “Se o prazo acabar”.

Abaixo de cada etapa você vê o que ela enviou ou o que encontrou, tal como ficou registrado: o assunto e a mensagem de um e-mail, os valores que uma condição comparou, o que uma consulta trouxe. Se uma ação precisou de mais de uma tentativa, você também vê em qual ela está, por exemplo “Tentativa 2 de 6”. A primeira linha do detalhe diz com qual versão do workflow ela foi executada.

As etapas do ramo que não foi seguido não aparecem, porque não foram executadas.

Novas tentativas automáticas

Quando uma ação falha, o Cord distingue o que aconteceu:

  • Não foi feita e pode dar certo depois. O destino respondeu com um erro temporário (o Slack ou o HubSpot fora do ar, um limite por hora esgotado). O Cord tenta de novo seguindo o calendário abaixo.
  • Não vai mudar sozinha. Falta uma conexão, o cliente não tem e-mail, a URL não é válida. A execução fica Com falha na primeira tentativa: corrija a causa e clique em Tentar novamente.
  • Não se sabe se chegou. O envio foi interrompido sem resposta. O que pode ser repetido sem duplicar é tentado de novo; o resto para. Veja Nenhum efeito acontece duas vezes.

Cada etapa tem as próprias tentativas, e cada tentativa continua a partir da etapa que falhou: as etapas que já foram feitas não se repetem. Se a tarefa foi criada e falhou o Slack que vinha depois, a nova tentativa só envia o Slack.

Tentativa Quando é executada Status enquanto espera
1 Quando o evento acontece Em execução
2 Uns 2 segundos depois, na mesma execução Em execução
3 Uns 15 segundos depois, na mesma execução Em execução
4 Cerca de uma hora depois Na fila
5 Cerca de 4 horas depois Na fila
6 Cerca de 12 horas depois Na fila
Sem mais tentativas A execução fica Com falha com a última mensagem de erro Com falha

As esperas variam um pouco de propósito, para que muitas execuções não tentem de novo no mesmo segundo, e o Cord verifica a fila a cada 5 minutos e a cada movimento da sua conta, então uma tentativa na fila é executada na primeira verificação depois do indicado.

Nenhum efeito acontece duas vezes

Antes de fazer uma ação, o Cord anota no histórico que vai tentá-la. Se algo for interrompido no meio do caminho, ele sabe que essa etapa pode ter acontecido e não a repete às cegas:

Ação Se o envio for interrompido sem resposta
Criar uma tarefa É repetida: a tarefa leva a marca da etapa, e repeti-la não cria outra.
Enviar os dados para uma URL É repetida com o mesmo cabeçalho Idempotency-Key, assim seu destino reconhece a nova tentativa e não a processa duas vezes.
Marcar o orçamento como expirado, Aprovar a solicitação interna, Cancelar a fatura É repetida: se a tentativa anterior já a fez, o documento já está nesse status e nada mais acontece.
Avisar a equipe por e-mail, Slack e Teams É repetida: sua equipe pode receber o aviso duas vezes, mas ele não se perde.
Enviar um e-mail ao cliente É repetida com a chave da etapa, que viaja com o e-mail: o serviço pelo qual o Cord envia se lembra dela por 24 horas e, enquanto isso, uma segunda tentativa não chega ao cliente. Se sua conta envia pelo seu Gmail, o Gmail não conhece essa chave e a etapa fica Sem confirmação, como o WhatsApp.
Enviar um WhatsApp ao cliente e Adicionar uma nota no HubSpot Não é repetida: o que seu cliente vê ou outro sistema guarda nunca é enviado duas vezes às cegas. A etapa fica Sem confirmação e a execução Requer atenção até você dizer se chegou.

Uma etapa que já foi confirmada nunca é feita de novo, mesmo que a execução seja tentada de novo.

Tentar de novo manualmente

Em uma execução Com falha, clique em Tentar novamente. Ela volta para Na fila com as tentativas da etapa zeradas, continua a partir da etapa que falhou e é executada na hora. Use isso depois de corrigir a causa, por exemplo ao reconectar o HubSpot.

Tentar novamente usa a versão publicada: se a causa estava no próprio workflow (um texto vazio, uma URL errada, as variáveis do WhatsApp), corrija-o, publique e tente de novo; a execução continua a partir da mesma etapa, mesmo que você a tenha movido. Se a execução foi executada com outra versão, você também pode clicar em Com a versão original (vN) para tentá-la de novo tal como começou. Se a etapa em que ela falhou não existe mais na versão publicada, você verá “A etapa em que esta execução falhou não existe mais na versão publicada. Tente novamente com a versão original.”

Em uma execução que Requer atenção, verifique primeiro no destino. Se chegou, clique em Chegou: continuar: a etapa fica concluída e a execução segue sem repeti-la. Se não chegou, clique em Não chegou: tentar de novo: o Cord a faz de novo. Se não quiser mais que continue, clique em Cancelar.

Só é possível tentar de novo execuções com falha ou que requerem atenção. Se você tentar com outra, verá “Só é possível tentar novamente execuções com falha ou que requerem atenção.”

Executar de novo

Não há um botão para repetir uma execução que já terminou (Concluída ou Cancelada): repeti-la poderia enviar duas vezes o mesmo e-mail ao cliente ou criar a mesma tarefa duas vezes. Conforme o que você precisar:

  • Ver o que ela faria com um evento real, sem enviar nada: use Testar no editor. Veja Publicar, pausar e excluir.
  • Que ela seja executada de novo de verdade: provoque o evento outra vez, por exemplo reenviando o orçamento. Cada evento novo cria a própria execução.
  • Recuperar uma execução com falha: Tentar novamente, como explicado acima.

Cancelar

Em uma execução Na fila ou Em espera, clique em Cancelar. Ela fica Cancelada e nenhuma outra etapa é executada. O que ela já fez não é desfeito.

Pausa automática

Se as últimas 5 execuções terminadas de um workflow falharam ou ficaram em Requer atenção, o Cord o pausa para que ele não continue falhando a cada evento:

  • O que estava em andamento não se perde: espera na sua etapa, como em qualquer pausa.
  • Quem o publicou e o dono da conta recebem um e-mail, e o editor e a lista de workflows dizem por que ele está pausado.
  • Uma execução que dá certo no meio recomeça a contagem.

Revise as execuções, corrija o que está falhando e clique em Retomar. Para saber de cada falha na hora, e não só da pausa, crie outro workflow com o gatilho Uma execução de workflow falha ou requer atenção que avise o Slack, o Teams ou a equipe.

Mensagens de erro e o que fazer

As mensagens aparecem no idioma da sua conta.

Tarefas

Mensagem Causa O que fazer
O título da tarefa ficou vazio. O título só tinha dados do evento e eles chegaram vazios. Adicione um texto fixo ao título.
Não foi possível criar a tarefa. O Cord recusou a tarefa; por exemplo, o orçamento a que ela seria vinculada não existe mais. Se o orçamento foi excluído, tentar de novo não adianta. Caso contrário, clique em Tentar novamente e, se persistir, escreva para nós.
Os workflows atingiram o limite de tarefas por hora. Seus workflows criaram 120 tarefas em uma hora. Verifique se algum workflow está sendo disparado mais do que o esperado; tente de novo mais tarde.

E-mail para a equipe

Mensagem Causa O que fazer
Não há para quem enviar o e-mail. A conta não tem proprietário com e-mail ou não há membros ativos. Verifique Configurações › Equipe e funções ou mude Para.
O e-mail não está disponível no momento. Não foi possível entregar a ninguém. O Cord tenta de novo sozinho. Se persistir, escreva para contacto@cordhq.app.
Os workflows atingiram o limite de e-mails por hora. 30 e-mails em uma hora. Considere o Slack ou o Teams para avisos frequentes.

E-mail para o cliente

Mensagem Causa O que fazer
Este evento não traz um orçamento sobre o qual agir. O gatilho não traz um orçamento, ou o orçamento não existe mais. Use um gatilho de orçamento ou de fatura.
Este evento não traz uma fatura sobre a qual agir. A fatura do evento não existe mais. Não há nada a tentar de novo para esse documento.
O cliente não tem um e-mail cadastrado. O cliente do documento não tem e-mail. Adicione o e-mail no cliente e clique em Tentar novamente.
A mensagem ficou vazia. A mensagem só tinha dados vazios. Adicione um texto fixo.
Você atingiu o limite de envios do seu plano este mês. A cota mensal de envios acabou (5 no plano Grátis). Aguarde o mês seguinte ou mude de plano.
Não foi possível enviar o e-mail ao cliente. O serviço de e-mail o recusou, normalmente porque o endereço do cliente não é válido, ou continuou sobrecarregado depois de todas as novas tentativas. Uma recusa não é repetida: repeti-la não muda nada. Revise o e-mail do cliente e clique em Tentar novamente.
Os workflows atingiram o limite de e-mails ao cliente por hora. 60 e-mails ao cliente em uma hora. Tente de novo mais tarde.

WhatsApp

Mensagem Causa O que fazer
Conecte o WhatsApp em Configurações › Integrações para usar esta ação. O WhatsApp não está conectado. Conecte o WhatsApp e clique em Tentar novamente.
O cliente não tem um telefone com código do país cadastrado. O cliente não tem telefone, ou ele não começa com + e o código do país. Edite o cliente, salve o número com + e tente de novo.
O WhatsApp não aceitou seu modelo. Verifique-o em Configurações › Integrações: ele precisa estar aprovado e ter o mesmo número de variáveis. O modelo não está aprovado, o nome não corresponde ou o número de variáveis é diferente. Se o problema for o modelo, corrija-o na Meta ou em Configurações › Integrações e tente de novo. Se forem as variáveis da etapa, corrija-as e publique: vale para os eventos novos.
O WhatsApp não aceitou a mensagem. Uma nova tentativa é feita automaticamente. Uma recusa temporária. Nada; o Cord tenta de novo.
Os workflows atingiram o limite de mensagens do WhatsApp por hora. 60 mensagens em uma hora. Tente de novo mais tarde.

Slack

Mensagem Causa O que fazer
Conecte o Slack em Configurações › Integrações para usar esta ação. Não há URL do Slack salva. Conecte o Slack e clique em Tentar novamente.
O Slack não aceitou a mensagem. Verifique a conexão em Configurações › Integrações. O webhook foi excluído ou o app foi removido do canal. Crie um webhook novo no Slack, cole a URL e tente de novo.
A mensagem ficou vazia. A mensagem só tinha dados vazios. Adicione um texto fixo.
Os workflows atingiram o limite de mensagens do Slack por hora. 120 mensagens em uma hora. Tente de novo mais tarde.

Teams

Mensagem Causa O que fazer
Conecte o Microsoft Teams em Configurações › Integrações para usar esta ação. O Teams não está conectado. Conecte o Teams e clique em Tentar novamente.
A Microsoft não aceita mais a conexão do Teams. Reconecte-a em Configurações › Integrações. Com Conectar com a Microsoft, o acesso expirou ou foi revogado. Clique em Reconectar no cartão e tente de novo.
O Teams não aceitou a mensagem. Verifique se o canal ou o fluxo continuam ativos. O canal não existe mais, você perdeu o acesso a ele, ou o fluxo do Power Automate foi desligado ou excluído. Escolha outro canal ou cole a URL de um fluxo novo, e tente de novo.
A mensagem ficou vazia. A mensagem só tinha dados vazios. Adicione um texto fixo.
Os workflows atingiram o limite de mensagens do Teams por hora. 120 mensagens em uma hora. Tente de novo mais tarde.

HubSpot

Mensagem Causa O que fazer
O HubSpot precisa ser reconectado em Configurações › Integrações. O acesso do Cord foi revogado. Clique em Reconectar e tente de novo.
O HubSpot não aceitou os dados desta etapa. Verifique a configuração em Configurações › Integrações. O HubSpot não está conectado ou pede para reconectar; o orçamento ou o cliente ainda não chegaram ao HubSpot, ou o gatilho não tem orçamento nem cliente; ou o Negócio ou a Empresa foi excluído no HubSpot. Verifique a conexão. Se o registro ainda não chegou, aguarde; se ficar Com falha, verifique se as etapas do pipeline estão completas e se o gatilho é de orçamento ou de cliente.
O HubSpot não respondeu. Uma nova tentativa é feita automaticamente. Uma falha temporária do HubSpot. Nada; o Cord tenta de novo.
A nota ficou vazia. A nota só tinha dados vazios. Adicione um texto fixo.
Os workflows atingiram o limite de notas por hora no HubSpot. 120 notas em uma hora. Tente de novo mais tarde.

Enviar os dados para uma URL

Mensagem Causa O que fazer
A URL de destino não é válida ou aponta para um servidor interno. A URL não é https ou não é de um servidor público. Corrija a URL e publique. A correção vale para os eventos novos; esta execução mantém a URL anterior.
A URL de destino não aceitou o envio. O destino respondeu com um erro ou não respondeu a tempo. Verifique o destino; o Cord tenta de novo seguindo o calendário acima.
Os workflows atingiram o limite de envios por hora para uma URL. 120 envios em uma hora. Tente de novo mais tarde.

Ações sobre o documento

Mensagem Causa O que fazer
Este evento não traz um orçamento sobre o qual agir. Marcar o orçamento como expirado ou Aprovar a solicitação interna com um evento sem orçamento. Use um gatilho de orçamento.
O orçamento não está mais em um status que permita esta ação. Ao marcar como expirado: o orçamento já foi aprovado, recusado ou já estava expirado. Não há nada a tentar de novo.
Seu plano atual não inclui aprovações internas. Aprovar a solicitação interna sem aprovações no seu plano. As aprovações internas exigem o plano Scale ou superior.
Este orçamento não tem mais uma solicitação de aprovação pendente. Alguém já a decidiu ou ela foi retirada. Não há nada a tentar de novo.
Este evento não traz uma fatura sobre a qual agir. Cancelar a fatura com um evento sem fatura. Use um gatilho de fatura.
Esta fatura não pode ser cancelada: revise-a em Faturas. Tem pagamentos aplicados (pede uma nota de crédito) ou outra regra impede cancelá-la. Verifique-a em Faturas.
Os workflows atingiram o limite de alterações em orçamentos por hora. O limite por hora dos workflows para esta alteração. Veja se algum workflow dispara mais do que o esperado; a nova tentativa é automática.
Os workflows atingiram o limite de faturas canceladas por hora. O limite por hora dos workflows para esta alteração. Veja se algum workflow dispara mais do que o esperado; a nova tentativa é automática.

Gerais

Mensagem Causa O que fazer
O workflow foi excluído antes de esta execução terminar. Ele foi excluído enquanto a execução estava em andamento. Não há nada a tentar de novo.
O envio foi interrompido sem resposta e não sabemos se chegou. Para que ninguém o receba duas vezes, o Cord não tentou novamente: verifique no destino e nos diga se chegou. Um e-mail ou WhatsApp ao cliente, ou uma nota no HubSpot, foi interrompido sem resposta. A execução fica em Requer atenção. Verifique se chegou e clique em Chegou: continuar ou Não chegou: tentar de novo.
Quem publicou este workflow não está mais na equipe, então ele foi pausado. Publique-o de novo para que ele atue com as suas permissões. Quem o publicou saiu da equipe ou teve o acesso desativado. Nenhuma etapa é executada em nome dessa pessoa. Publique-o de novo; a partir daí, ele atua com as suas permissões.
Quem publicou este workflow não tem mais a permissão que esta etapa exige, então ele foi pausado. Alguém que tenha essa permissão precisa publicá-lo de novo. Quem o publicou perdeu a permissão dessa etapa. Peça a alguém com essa permissão que o publique. Veja Publicar, pausar e excluir.
Seu plano atual não inclui este workflow ativo. Você mudou para um plano inferior e este workflow ficou fora do limite. Pause outros workflows ou mude de plano. Veja Limites.
O evento que iniciou esta execução não existe mais. O registro do evento foi excluído. Não há nada a fazer.
O workflow excedeu o número de etapas permitido. A execução passou do máximo de etapas. Divida a regra em dois workflows.
Esta ação não está mais disponível. A execução usava uma ação que o Cord retirou. Edite o workflow e publique de novo.
Esta consulta não está mais disponível. A execução usava uma consulta que o Cord retirou. Edite o workflow e publique de novo.
Erro interno ao executar a ação. Uma falha inesperada do Cord. Uma nova tentativa é feita automaticamente. Se ficar Com falha, clique em Tentar novamente ou escreva para nós.

O painel de saúde

Acima da lista de Workflows há um resumo dos últimos 30 dias: quantas execuções houve, quantas foram concluídas, quantas falharam, quantas requerem atenção e quantas continuam em andamento ou em espera. Na lista, cada workflow com execuções que requerem atenção mostra isso abaixo do número de execuções.

Abaixo, Por que falharam: as cinco causas mais frequentes, com quantas vezes cada uma aconteceu, em que workflow foi a última e quando. Ali se vê a diferença entre “algo está falhando” e “o Slack foi desconectado na terça-feira”: se uma causa tem 40 falhas e as demais nenhuma, você já sabe o que corrigir.

O painel aparece assim que há execuções. Se nenhuma falhou no período, ele informa isso em vez de mostrar uma lista vazia.

Relacionados