Odoo + GoHighLevel: Integração de CRM e automação de marketing

GoHighLevel (GHL) se tornou a plataforma dominante para agências de marketing digital e empresas de serviços que precisam de CRM completo, construção de funil, marketing por e-mail, automação de SMS e gerenciamento de reputação. Odoo 19 Enterprise lida com a espinha dorsal operacional – ERP, contabilidade, gerenciamento de projetos e prestação de serviços. Essas duas plataformas desempenham funções complementares e integrá-las elimina os silos de dados que prejudicam as operações de receita.

Este guia cobre a integração completa do Odoo-GoHighLevel: design de arquitetura, sincronização de contatos, mapeamento de oportunidades/pipeline, sincronização de dados de campanha, gatilhos baseados em webhook e construção de relatórios de receita unificados em ambas as plataformas.

Principais conclusões

• API v2 (REST) do GoHighLevel é a principal superfície de integração
• A sincronização de contatos é bidirecional: leads do GHL → Odoo CRM, clientes do Odoo → GHL para nutrição
• Estágios de oportunidade no mapa GHL para estágios de pipeline do Odoo CRM
• Os gatilhos de automação GHL podem disparar ações Odoo (criar tarefa, enviar fatura, ativar serviço)
• Faturas Odoo podem acionar automações GHL (pagamento recebido → envio de sequência de integração)
• A ponte Webhook lida com a propagação de eventos em tempo real entre plataformas
• Suporte a subcontas: agências que gerenciam vários clientes podem mapear cada subconta GHL para uma empresa Odoo
• Relatórios unificados reúnem métricas de campanha GHL e dados de receita Odoo em painéis únicos

---

Casos de uso de integração

Antes de projetar a arquitetura, esclareça quais cenários você precisa dar suporte:

Cenário da agência:

• GHL: funis de aquisição de clientes, nutrição de leads, agendamento de compromissos, gestão de reputação
• Odoo: projetos de clientes, faturamento, prestação de serviços, relatórios financeiros
• Necessidade de integração: negócios conquistados no GHL → criar projetos no Odoo, faturas Odoo acionam sequências de agradecimento do GHL

SaaS/negócios de serviços:

• GHL: formulários de captura de leads, incentivo por e-mail/SMS, funis de webinar
• Odoo: pipeline de CRM (de leads qualificados), contabilidade, suporte
• Necessidade de integração: leads qualificados da GHL → oportunidades de Odoo CRM, Odoo ganhou negócios → automações de clientes da GHL

Comércio eletrônico com automação de marketing:

• Shopify: loja online
• GHL: recuperação de carrinho abandonado, email pós-compra, campanhas de fidelização
• Odoo: back-end de ERP, estoque, contabilidade
• Necessidade de integração: segmentos de clientes Odoo → listas de contatos GHL, eventos de compra → campanhas desencadeadoras GHL

---

Configuração da API GoHighLevel

Etapa 1: gerar credenciais da API GHL

Em GoHighLevel:

1. Navegue até Configurações → Chaves de API (nível de agência) ou Subconta → Configurações → Chaves de API
2. Crie uma nova chave de API com escopo apropriado
3. Anote a Chave de API e seu ID de local (ID da subconta)

URL base da API GHL v2:

https://services.leadconnectorhq.com

A API v2 usa REST padrão com cargas JSON e autenticação de token de portador.

Etapa 2: configurar o OAuth para acesso em nível de agência

Para agências que gerenciam múltiplas subcontas (termo da GHL para contas de clientes):

1. Registre uma integração em marketplace.gohighlevel.com
2. Configure OAuth 2.0 com URI de redirecionamento para Odoo
3. Conclua o fluxo OAuth por subconta para obter tokens específicos do local

Etapa 3: Configurar webhooks no GHL

Em GHL → Configurações → Webhooks → Adicionar novo webhook:

• URL: https://your-odoo.com/ghl/webhook
• Eventos: contato criado, contato atualizado, oportunidade criada, oportunidade atualizada, agendamento marcado, pagamento recebido

---

Configuração do conector no Odoo

Navegue para CRM → GoHighLevel ou Configurações → Integrações → GoHighLevel após instalar o conector ECOSIRE.

Configuração da conta:

Subconta para mapeamento de empresas Odoo (agências):

---

Sincronização de Contatos

Os contatos são a base de ambas as plataformas. Mantê-los sincronizados evita divulgação duplicada, dados conflitantes e sequências de automação quebradas.

Configuração da direção de sincronização:

Mapeamento de campo de contato:

Lógica de desduplicação:

Quando chega um contato do GHL ao Odoo, o conector verifica:

1. Correspondência de e-mail → link para parceiro Odoo existente
2. Correspondência por telefone → link para parceiro existente
3. Correspondência de nome + empresa → sinalizar como potencial duplicado para revisão manual
4. Sem correspondência → criar novo parceiro

Tags e segmentação:

As tags GHL são mapeadas para tags de contato Odoo:

• Tag "GHL-Lead" adicionada a todos os contatos de origem GHL
• Tags de pipeline GHL são sincronizadas como tags Odoo CRM
• As categorias de clientes Odoo são sincronizadas como tags GHL para segmentação

---

Oportunidade e sincronização de pipeline

Mapeamento de estágio:

Mapeie os estágios do pipeline GHL para os estágios do Odoo CRM:

Sincronizando uma oportunidade do GHL com o Odoo:

1. Oportunidade GHL criada ou movida para fase de qualificação
2. Webhook dispara: opportunity.status_changed
3. Conector recebe webhook
4. Se existir contato no Odoo: vincule a oportunidade a esse parceiro
5. Caso contrário: crie um parceiro a partir dos dados de contato da GHL
6. Crie crm.lead no Odoo com estágio mapeado do GHL
7. Atribuir ao vendedor com base na atribuição GHL

Sincronizando negócios ganhos do Odoo para o GHL:

Quando um negócio é marcado como ganho no Odoo CRM:

1. O conector chama a API GHL: atualize o status da oportunidade para "Ganhou"
2. A automação GHL aciona a sequência de boas-vindas ao cliente
3. Odoo cria um pedido de venda a partir da oportunidade de CRM
4. O conector cria opcionalmente uma nota GHL com referência de pedido de venda Odoo

Receita esperada e pipeline ponderado:

Os valores de oportunidade da GHL são sincronizados com o Odoo:

• Valor monetário GHL → Odoo expected_revenue
• Probabilidade de vitória GHL → Odoo probability
• Previsão ponderada: Odoo calcula prorated_revenue = expected_revenue × probability

---

Sincronização de compromissos e calendário

O sistema de reserva de calendário do GoHighLevel é uma ferramenta importante de conversão de leads. Sincronize compromissos agendados com o calendário e atividades de CRM do Odoo.

Fluxo de trabalho de sincronização de compromissos:

1. Liderar marcação de livros no GHL (via funil, equivalente ao Calendly)
2. O webhook AppointmentBooked é acionado
3. O conector cria:

• Evento do calendário Odoo (no calendário do vendedor)
• Atividade Odoo CRM na oportunidade relacionada (ligação agendada)
• Opcional: crie uma tarefa no projeto Odoo (para preparação pré-reunião)

4. Se o compromisso for remarcado: evento Odoo atualizado
5. Se o compromisso for cancelado: evento Odoo cancelado, atividade removida

Automação pré-reunião:

Acione uma sequência automatizada GHL quando um compromisso Odoo for confirmado:

• 24 horas antes: SMS de lembrete da GHL
• 1 hora antes: e-mail de lembrete da GHL
• Após a reunião: sequência de acompanhamento se nenhum negócio for criado em 48 horas

---

Ponte de automação baseada em gatilho

O recurso mais poderoso da integração é a ponte webhook – eventos Odoo acionam automações GHL e vice-versa.

Eventos GHL → Ações Odoo:

Eventos Odoo → Ações GHL:

Configurando pontes de automação:

1. Navegue até GHL → Pontes de Automação → Criar
2. Selecione a fonte do gatilho (GHL ou Odoo)
3. Selecione o evento acionador
4. Selecione o sistema de destino
5. Configure mapeamentos de ações e campos
6. Defina condições (opcional: acione apenas se determinados valores de campo corresponderem)

Exemplo de ponte: Fatura paga → Sequência de integração GHL

Trigger: Odoo - Invoice Posted AND Payment Status = Paid
Condition: Sale order has tag "New Customer"
Action: GHL - Add Contact to Workflow "Customer Onboarding Sequence"
Fields: Contact identified by email from invoice partner

---

Dados de campanha de marketing no Odoo

Extraia dados de desempenho de campanha GHL para Odoo para atribuição unificada de receita.

Métricas de campanha sincronizadas com o Odoo:

Atribuição de receita no CRM:

Identifique cada lead GHL com a campanha que o gerou. Na análise do Odoo CRM:

• Receita por origem da campanha
• Custo por aquisição por canal
• ROI da campanha = valor do negócio ganho/custo da campanha
• Análise do período de retorno

---

Arquitetura multilocatário de agência

Para agências GoHighLevel que gerenciam vários clientes, a integração precisa de suporte multilocatário.

Arquitetura para agências:

GHL Agency Account
├── Sub-Account: Client A → maps to → Odoo: Client A Company
├── Sub-Account: Client B → maps to → Odoo: Client B Company
└── Sub-Account: Client C → maps to → Odoo: Client C Company

Cada subconta tem a sua própria:

• Credenciais API GHL (token de acesso específico do local)
• Contexto da empresa Odoo
• Isolamento de contatos e oportunidades
• Faturamento e faturamento em Odoo

Gerenciamento de painéis de agência:

No modo multiempresa do Odoo, um painel de agência pode mostrar:

• Liderar pipeline em todas as subcontas do cliente
• Receita por cliente
• Desempenho da campanha por cliente
• Oportunidades de upsell/renovação em todos os clientes

---

Perguntas frequentes

Como evito contatos duplicados quando a mesma pessoa existe no GHL e no Odoo?

O conector usa email como chave primária de eliminação de duplicação. Ao sincronizar do GHL, ele procura no Odoo um parceiro existente com o mesmo e-mail. Se encontrado, vincula o contato GHL ao parceiro Odoo sem criar uma duplicata. Para desduplicação baseada em telefone, habilite a correspondência de telefone nas configurações de desduplicação do conector. Revise o relatório "Potenciais duplicados" semanalmente para resolver manualmente casos extremos.

As automações GHL podem acionar ações Odoo diretamente sem código?

Sim, através de webhooks. O construtor de automação do GHL inclui uma ação “Custom Webhook”. Configure esta ação para chamar o endpoint da API da sua instância Odoo. O conector ECOSIRE expõe um endpoint de webhook seguro em /ghl/trigger que aceita cargas GHL e as mapeia para ações Odoo. Não é necessária codificação personalizada — configure mapeamentos na interface da ponte de automação do conector.

A integração suporta o rastreamento de campanhas de marketing por SMS e e-mail da GHL no Odoo?

Sim, no nível agregado. O conector importa estatísticas de campanha GHL (aberturas, cliques, conversões) e as associa aos leads do Odoo CRM da mesma campanha. O rastreamento individual de engajamento por e-mail/SMS (quem abriu o quê) é rastreado na análise de campanha nativa da GHL. Odoo recebe a atribuição de receita (que leva de qual campanha é convertida em clientes).

O que acontece com os contatos GHL existentes quando eu conecto a integração pela primeira vez?

A sincronização inicial importa contatos GHL como parceiros Odoo. Para contas GHL grandes (mais de 10.000 contatos), a importação inicial é executada como um trabalho em segundo plano com relatórios de progresso. O conector desduplica em parceiros Odoo existentes usando correspondência de email. Contatos sem endereços de e-mail são sinalizados para revisão manual. Após a sincronização inicial, as alterações contínuas são orientadas por eventos por meio de webhooks.

Posso usar a integração para criar faturas Odoo automaticamente quando um pagamento GHL é recebido?

Sim. Configure uma ponte de automação: Trigger = GHL Payment Received, Action = Odoo: Create and Post Invoice. Mapeie o valor do pagamento GHL para a linha da fatura, o contato GHL para o cliente Odoo e o método de pagamento GHL para o diário Odoo. Isso é comumente usado para agências que cobram adiantamentos por meio do checkout da GHL e precisam que a receita seja refletida automaticamente na contabilidade do Odoo.

---

Próximas etapas

A integração Odoo-GoHighLevel cria uma base de operações de receita onde a automação de marketing e as operações de negócios não ficam mais isoladas. GHL capta e nutre leads; Odoo entrega e fatura o serviço. A integração faz com que esses dois sistemas pareçam um só.

Entre em contato com a ECOSIRE sobre a integração Odoo-GoHighLevel →

Explore os serviços GoHighLevel da ECOSIRE →

Nossa equipe tem experiência prática com ambas as plataformas e oferece integrações que vão além da sincronização básica de contatos: criamos fluxos de trabalho de automação de receita que criam resultados de negócios mensuráveis.