Como conectar um formulário do GoHighLevel a um workflow de automação

Conectar um formulário a um workflow de automação é uma das operações mais fundamentais dentro do GoHighLevel. Quando configurado corretamente, o envio de um formulário dispara automaticamente sequências de e-mails, SMS, tarefas internas ou qualquer outra ação que você tenha mapeado. Este guia mostra o processo passo a passo, aponta os pontos de atenção e lista os erros mais comuns.

O que você vai precisar antes de começar

Antes de partir para a configuração, verifique se os itens abaixo já estão prontos:

• Um sub-account (conta de cliente) ativo dentro da sua agência ou conta direta no GoHighLevel.
• Pelo menos um formulário criado na plataforma. Se ainda não tiver, acesse Sites → Forms → Builder e crie um formulário básico com os campos desejados.
• Acesso à seção de Automations (ou Workflows, dependendo da versão da interface que seu plano exibe — a nomenclatura pode variar).

Observação: usuários em planos mais básicos podem ter acesso limitado a certas ações dentro dos workflows. Se uma funcionalidade não aparecer na sua tela, consulte a documentação oficial da HighLevel ou o suporte da sua agência revendedora.

Passo a passo: criando o workflow com gatilho de formulário

1. No menu lateral esquerdo, clique em Automation.
2. Clique no botão + New Workflow.
3. Selecione a opção Start from Scratch para ter controle total sobre o fluxo, ou escolha um template caso prefira um ponto de partida.
4. Na tela do editor de workflow, clique em Add New Trigger (o bloco de disparo no topo do fluxo).
5. No painel de gatilhos que se abre à direita, localize e selecione Form Submitted.
6. Após selecionar o gatilho, aparecerão filtros opcionais. Use o filtro Form para especificar qual formulário deve acionar este workflow. Se deixar em branco, qualquer envio de formulário do sub-account disparará o fluxo — o que raramente é o comportamento desejado.
7. Clique em Save Trigger para confirmar.

Adicionando ações ao workflow

Com o gatilho salvo, você pode empilhar ações abaixo dele:

1. Clique no botão + logo abaixo do bloco de gatilho.
2. Escolha o tipo de ação: Send Email, Send SMS, Add Tag, Create Task, entre outros.
3. Configure cada ação com o conteúdo desejado. Nos campos de texto, use as Custom Values (variáveis dinâmicas como {{contact.first_name}}) para personalizar as mensagens com os dados preenchidos no formulário.
4. Para adicionar um tempo de espera entre ações, insira um bloco Wait.
5. Ao terminar de montar o fluxo, clique em Save no canto superior direito e, em seguida, ative o workflow pelo toggle Publish.

Dica: mantenha o workflow em modo Draft enquanto estiver testando. Um workflow publicado processa contatos reais imediatamente.

Como vincular o formulário a um funil ou página

Se o formulário estiver embutido em um funil (Funnel) ou página (Website) do próprio GoHighLevel, o gatilho funciona de forma nativa, sem configuração adicional. Caso o formulário seja incorporado em um site externo via código de embed:

1. Acesse Sites → Forms, localize o formulário e clique em Integrate.
2. Copie o código de incorporação (embed code) e cole no HTML da sua página externa.
3. Os envios realizados por esse embed são registrados no GoHighLevel e disparam o workflow normalmente, desde que o formulário esteja corretamente identificado no gatilho.

Para formulários hospedados em ferramentas de terceiros (Typeform, Jotform, Google Forms etc.), o GoHighLevel não captura os envios de forma nativa. Nesses casos, é necessário usar integrações via Zapier, Make (antigo Integromat) ou webhooks customizados — o que adiciona camadas de complexidade e possíveis pontos de falha. Se o seu fluxo depende muito de ferramentas externas, avalie se o GoHighLevel é de fato a opção mais prática para o seu cenário.

Testando a integração antes de colocar em produção

Testar é obrigatório antes de publicar o workflow para contatos reais. Siga este processo:

1. Com o workflow ainda em modo Draft, acesse o formulário pelo link de prévia (Preview).
2. Preencha o formulário com um e-mail de teste seu.
3. Volte para Automation → Workflows, abra o workflow e clique na aba History (ou Execution Log, conforme a versão).
4. Verifique se o contato de teste aparece na lista de execuções e se todas as ações foram processadas sem erros.
5. Confirme também se o contato foi criado ou atualizado corretamente em Contacts.

Só publique o workflow após validar que todas as etapas funcionam como esperado.

Erros comuns e como resolver

O formulário foi enviado, mas o workflow não disparou

• Verifique se o workflow está publicado (e não em Draft).
• Confirme se o filtro de formulário no gatilho aponta para o formulário correto. Um filtro em branco pode parecer correto, mas às vezes conflita com outros workflows ativos.
• Cheque se o contato já existia no sistema. Em alguns casos, regras de duplicidade ou contatos marcados como DND (Do Not Disturb) bloqueiam ações de comunicação, embora o workflow ainda possa ser executado parcialmente.

As variáveis dinâmicas aparecem como texto literal (ex: {{contact.first_name}})

• Isso indica que o campo correspondente está vazio no registro do contato ou que a sintaxe da variável está incorreta. Revise o nome exato da Custom Value disponível no painel de variáveis do editor.

O contato entra no workflow mais de uma vez

• O GoHighLevel permite configurar se um contato pode re-entrar em um workflow. Acesse as Settings do workflow e revise a opção Allow Re-entry. Para formulários de cadastro único, o ideal é manter essa opção desativada.

Ações de e-mail não são entregues

• Verifique se o domínio de envio está autenticado (registros DKIM e SPF configurados). Esse passo é feito em Settings → Email Services e é independente da configuração do workflow.

O workflow executa, mas nenhuma ação de SMS dispara

• Confirme se o número de telefone do LC Phone (ou Twilio integrado) está ativo e se o contato possui um número de celular válido cadastrado. Planos diferentes têm configurações distintas para envio de SMS.

Boas práticas para manter seus workflows organizados

• Nomeie os workflows de forma descritiva, incluindo o nome do formulário e a finalidade (ex: Form - Contato Comercial → Sequência Boas-Vindas).
• Use tags para segmentar contatos que passaram por determinado fluxo, facilitando filtros futuros.
• Documente internamente quais workflows estão ativos e o que cada um faz. Em contas com muitas automações, a falta de documentação gera conflitos difíceis de rastrear.
• Revise periodicamente os logs de execução para identificar falhas silenciosas — erros que não interrompem o workflow, mas deixam ações incompletas.