Automação
Como conectar o n8n ao GoHighLevel
O n8n é a alternativa de código aberto ao Zapier, e cobra por execução do servidor em vez de por tarefa — o que muda a conta quando o volume cresce. Ele traz um nó nativo do HighLevel, mas ele cobre um conjunto limitado de operações; o resto sai pelo nó de requisição HTTP.
- Gatilho no n8n
- Nó HighLevel
- API LeadConnector
- Ação no GoHighLevel
Onde funciona dentro do GoHighLevel
- Contato: criar ou atualizar, buscar, listar, excluir
- Oportunidade: criar, atualizar, buscar, listar, excluir
- Tarefa: criar, atualizar, buscar, listar, excluir
- Agenda: marcar compromisso e consultar horários livres
- Qualquer outro endpoint, pelo nó HTTP Request
O que você precisa antes de começar
- Instância do n8n, na nuvem ou auto-hospedada
- Credencial do GoHighLevel: chave de API ou aplicativo OAuth 2.0
- Para OAuth: acesso às configurações avançadas do app no GoHighLevel
Passo a passo
Adicione o nó HighLevel ao fluxo
No editor do n8n, procure por HighLevel. O nó conversa com a API do LeadConnector, que é a infraestrutura por trás do CRM, SMS e automações do GoHighLevel.
Escolha o método de autenticação
Chave de API é mais rápido de configurar. OAuth 2.0 é mais seguro e não expõe a chave, mas exige criar um aplicativo no GoHighLevel.
Se usar OAuth, configure a URL de redirecionamento
Nas configurações avançadas do seu app no GoHighLevel, cole a URL de redirecionamento fornecida pelo n8n no campo de redirect URI.
O GoHighLevel já traz uma URL de localhost preenchida. Não apague: ela pode conviver com a do n8n. Substituir quebra outros fluxos que dependiam dela.
Selecione recurso e operação
Escolha o recurso (contato, oportunidade, tarefa ou agenda) e a operação desejada. Preencha os parâmetros conforme o campo esperado.
Use HTTP Request para o que o nó não cobre
O nó nativo não expõe todos os endpoints da API. Para o resto, use o nó HTTP Request apontando direto para a API do LeadConnector, reaproveitando a mesma credencial.
Campos personalizados costumam ter nomes internos diferentes do rótulo exibido na tela. Divergência de nome de campo é a causa mais comum de dado que não grava.
Limitações que valem saber antes
- O nó nativo cobre contato, oportunidade, tarefa e agenda. Outros recursos exigem chamadas HTTP manuais.
- Auto-hospedar o n8n significa cuidar de servidor, atualização e disponibilidade — o custo some da fatura e aparece no tempo da equipe.
- Campos personalizados precisam ser referenciados pelo identificador interno, não pelo rótulo visível no GoHighLevel.
- Não há suporte oficial da HighLevel para problemas no n8n: o nó é mantido pela comunidade do n8n.
Perguntas frequentes
- n8n ou Zapier para o GoHighLevel?
- O Zapier é mais simples e tem mais apps prontos. O n8n custa por execução do servidor em vez de por tarefa, o que compensa em volume alto, e permite auto-hospedar quando o dado não pode sair da sua infraestrutura. Em compensação, exige mais conhecimento técnico.
- A operação que preciso não está no nó. E agora?
- Use o nó HTTP Request apontando para a API do LeadConnector com a mesma credencial. Todo endpoint documentado fica acessível por ali.
- Chave de API ou OAuth?
- OAuth quando possível: a chave de API dá acesso total à conta e, se vazar, não há como limitar o estrago sem revogá-la por inteiro.
Onde isto foi verificado
- n8n Docs — HighLevel node documentation Recursos e operações que o nó nativo cobre
- n8n — HighLevel integrations Disponibilidade do nó e apps que se conectam a ele
Quer isso configurado sem tentativa e erro?
A Galaxy IT implanta o GoHighLevel em português, com as integrações que a sua operação usa de verdade — incluindo as que dependem de ajuste fora da plataforma.