Integração CRM GoHighLevel
O HiLucy integra-se com o GoHighLevel (GHL) para enviar automaticamente dados de pedidos WooCommerce para seu CRM. Cada reserva se torna um contato e, opcionalmente, uma oportunidade de pipeline -- dando às equipes de vendas e marketing visibilidade em tempo real da atividade do hóspede.
O Que é Sincronizado
| Dado | Direção | Gatilho |
|---|---|---|
| Informações de contato do hóspede (nome, e-mail, telefone, endereço) | HiLucy -> GHL | Novo pedido criado |
| Detalhes do pedido (itens, totais, cupons) | HiLucy -> GHL | Novo pedido criado |
| Mudanças de status do pedido | HiLucy -> GHL | Transições de status selecionadas |
| Oportunidade de pipeline | HiLucy -> GHL | Novo pedido (se pipeline configurado) |
| Tag de contato | HiLucy -> GHL | Cada pedido sincronizado |
Passos de Configuração
1. Obtenha suas Credenciais do GoHighLevel
Na sua sub-conta do GoHighLevel:
- Navegue até Settings -> Business Profile e copie seu Location ID
- Vá em Settings -> API Keys e gere uma API key no nível de localização
Use uma chave no nível de localização (não no nível de agência) para que contatos e oportunidades fiquem limitados à sub-conta correta.
2. Configure o HiLucy
No seu administrador WordPress:
- Vá em Settings -> HiLucy GoHighLevel
- Marque Enable syncing
- Cole sua API key e Location ID
- (Opcional) Insira um Pipeline ID e Stage ID para criar uma oportunidade para cada pedido
- (Opcional) Defina uma Order tag -- esta tag é aplicada a cada contato sincronizado e pode acionar workflows GHL
- Clique em Save GoHighLevel settings
3. Escolha o Método de Entrega
O HiLucy suporta dois métodos de entrega que podem funcionar independentemente ou juntos:
- API -- Cria ou atualiza contatos e oportunidades diretamente via REST API do GoHighLevel
- Webhook -- Envia o payload completo do pedido para uma URL de webhook de entrada do GHL, útil se você prefere não expor uma API key ou quer acionar um workflow GHL personalizado
Insira uma Workflow webhook URL nas configurações se quiser usar o método webhook.
4. Selecione os Gatilhos de Status
Por padrão, o HiLucy sincroniza quando um pedido é criado. Você também pode ressincronizar em transições de status específicas (ex.: "completed", "refunded") para acionar automações baseadas em estágios no GoHighLevel. Marque os status que deseja rastrear em Statuses to sync again.
Detalhes do Fluxo de Dados
Quando um pedido WooCommerce é feito ou muda de status:
- O HiLucy constrói um payload contendo informações de contato do hóspede, itens do pedido, totais, cupons e metadados
- Se a entrega por API está habilitada, o HiLucy cria ou atualiza o contato no GHL e opcionalmente abre uma oportunidade de pipeline
- Se a entrega por webhook está habilitada, o payload completo é enviado via POST para seu gatilho de workflow GHL
- Uma verificação de deduplicação previne que a mesma combinação de pedido/status sincronize duas vezes
Monitoramento
A página de configurações exibe um painel de Latest sync attempt mostrando o último pedido sincronizado, o tipo de evento e se cada método de entrega teve sucesso ou falhou. Verifique este painel se suspeitar de problemas de sincronização.
Solução de Problemas
Pedidos não aparecem no GoHighLevel?
- Verifique se Enable syncing está marcado e ao menos um método de entrega está configurado
- Confirme que sua API key é no nível de localização (não expirada ou revogada)
- Verifique o log de debug do WordPress para mensagens de erro contendo "GoHighLevel"
Contatos duplicados?
GoHighLevel associa contatos por e-mail. Se um hóspede faz múltiplos pedidos com e-mails diferentes, contatos separados serão criados. Mescle-os manualmente no GHL ou padronize a coleta de e-mail no checkout.
Webhook não dispara?
Certifique-se de que a URL do webhook começa com https://services.leadconnectorhq.com/hooks/ e que o workflow GHL correspondente está publicado e ativo.