Workflow travado no GoHighLevel: diagnóstico completo para resolver de vez

Um workflow que não dispara — ou que para no meio sem aviso — é um dos problemas mais frustrantes dentro do GoHighLevel. Antes de abrir ticket de suporte ou refazer tudo do zero, vale percorrer uma checklist sistemática. A maioria dos casos tem causa simples e solução em menos de dez minutos.

1. Verifique se o workflow está realmente ativo

Parece óbvio, mas é o primeiro ponto a conferir. No menu lateral, acesse Automation → Workflows e localize o workflow em questão. Observe o botão de toggle no canto superior direito da tela de edição: ele precisa estar na posição Published (ativo). Se estiver em Draft, nenhum contato entrará no fluxo, independentemente de qualquer outra configuração.

Além disso, verifique se existe uma data de expiração configurada na aba de configurações do workflow. Caso o período tenha passado, o gatilho simplesmente para de funcionar sem qualquer notificação visível na tela principal.

2. Analise o gatilho (trigger) com atenção

O gatilho é o ponto de entrada do workflow. Qualquer incompatibilidade entre o evento real e o evento configurado impede o disparo.

Problemas frequentes no trigger

1. Filtros muito restritivos: se você adicionou condições como tag específica, pipeline ou valor de campo personalizado, o contato precisa satisfazer todos os critérios simultaneamente. Remova os filtros temporariamente para testar se o workflow dispara sem eles.
2. Gatilho errado para o canal: por exemplo, usar Form Submitted para capturar envios de um survey, ou Appointment Scheduled quando o agendamento foi feito manualmente e não pelo calendário integrado.
3. Evento não ocorrendo de fato: use o log de atividades do contato (Contacts → [contato] → Activity) para confirmar se o evento realmente aconteceu do ponto de vista da plataforma.
4. Re-entry desabilitado: se o contato já passou pelo workflow antes e a opção Allow Re-entry não está marcada, ele não entrará novamente mesmo que o gatilho ocorra outra vez.

3. Confira as configurações de re-entry e filtros de contato

Na aba Settings do workflow, existem três configurações que afetam quem pode ou não entrar no fluxo:

• Allow contacts to re-enter this workflow: desativado por padrão. Se o seu caso de uso exige que o mesmo contato dispare o workflow várias vezes (ex.: toda vez que preencher um formulário), ative esta opção.
• Stop on Response: quando ativado, o workflow pausa automaticamente ao receber qualquer resposta do contato por SMS ou e-mail. Verifique se isso está interrompendo fluxos que deveriam continuar.
• Enrollment filters: filtros aplicados no momento da entrada. Um contato fora do critério é silenciosamente ignorado — sem log de erro.

4. Rastreie o fluxo no histórico de execução

O GoHighLevel oferece um log de execução por contato. Para acessá-lo:

1. Vá até Contacts e abra o contato que deveria ter passado pelo workflow.
2. Na aba Workflow, você verá em qual etapa o contato está ou parou.
3. Se o contato não aparece ali, o problema está no trigger ou nos filtros de entrada — o fluxo nunca chegou a ser iniciado.
4. Se o contato aparece travado em uma etapa específica, clique sobre ela para ver a mensagem de erro associada.

Erros comuns visíveis nesse log incluem: e-mail não enviado por domínio não verificado, SMS bloqueado por número não provisionado e ação de atualização de campo falhando por campo inexistente.

5. Erros comuns e como resolver

Abaixo estão os cenários de travamento mais reportados por usuários, com as respectivas soluções:

E-mail não é enviado

• Causa mais comum: domínio de envio não verificado ou e-mail de remetente não configurado corretamente em Settings → Email Services.
• Solução: acesse as configurações de e-mail da subaccount e confirme que o domínio passou pela verificação DNS (registros SPF, DKIM e DMARC). Enquanto isso não estiver correto, ações de e-mail dentro do workflow falham silenciosamente ou com erro no log.

SMS não dispara

• Causa mais comum: número de telefone não provisionado, conta Twilio desconectada ou saldo insuficiente (dependendo do plano e da configuração de cobrança).
• Solução: verifique em Settings → Phone Numbers se há um número ativo associado à subaccount. Confirme também o status da integração em Settings → Integrations.

Workflow dispara, mas para em um "Wait" infinito

• Causa mais comum: a condição do Wait Step (aguardar tag, aguardar resposta, aguardar data) nunca é satisfeita.
• Solução: revise a lógica do passo de espera. Se o wait depende de uma tag ser adicionada por outro workflow, confirme que esse segundo workflow está ativo e funcionando.

Contato entra no workflow, mas não avança

• Causa mais comum: passo de Go To apontando para uma etapa que não existe mais (foi deletada), criando um loop sem saída.
• Solução: mapeie todos os passos Go To do workflow e confirme que os destinos existem.

Webhook não retorna dados

• Causa mais comum: URL de destino incorreta ou serviço externo retornando erro 4xx/5xx.
• Solução: use a funcionalidade de Test Webhook para validar a conexão antes de colocar o workflow em produção. Ferramentas como o Webhook.site ajudam a inspecionar o payload enviado.

Quando o problema pode não ter solução simples

Alguns cenários indicam limitações reais da plataforma, não erros de configuração:

• Lógica condicional muito complexa: o GoHighLevel não é uma ferramenta de automação de nível enterprise. Se o seu workflow tem mais de 30 etapas com ramificações condicionais aninhadas, considere integrar com ferramentas como Make (ex-Integromat) ou n8n para a lógica mais elaborada.
• Volume muito alto de contatos simultâneos: em picos de entrada (ex.: importação em massa seguida de workflow), pode haver atraso no processamento. Isso não é um bug, mas uma característica do ambiente compartilhado. Avalie se o seu plano atual comporta o volume esperado.
• Integrações de terceiros instáveis: se o workflow depende de uma integração via Zapier ou Make e o problema está nessa camada externa, o GoHighLevel não tem como recuperar a execução automaticamente.

Nesses casos, o mais honesto é reconhecer que a ferramenta pode não ser a mais adequada para o cenário específico — e avaliar alternativas ou arquiteturas híbridas.

Boas práticas para evitar travamentos futuros

1. Sempre teste em modo rascunho antes de publicar: use contatos de teste e acompanhe o log em tempo real.
2. Nomeie cada etapa do workflow com descrições claras — facilita muito o diagnóstico quando algo para.
3. Documente os filtros de entrada em algum lugar externo (Notion, Google Docs). Filtros esquecidos causam travamentos invisíveis meses depois.
4. Revise workflows inativos periodicamente: integrações mudam, números de telefone expiram e domínios perdem verificação — tudo isso quebra fluxos sem aviso.
5. Use o campo de notas interno do workflow para registrar a data da última alteração e o responsável pela mudança.

Seguir essa checklist cobre a grande maioria dos casos de workflow travado no GoHighLevel. Se após percorrer todos os pontos o problema persistir, o próximo passo é abrir chamado diretamente no suporte oficial da HighLevel com o log de execução e o ID do contato afetado em mãos — isso agiliza muito a triagem.