WhatsApp + GoHighLevel Integração: Sincronize Dados Bidirecionalmente com Whapi.Cloud

Como Funciona a Integração WhatsApp + GoHighLevel

O Que Você Pode Sincronizar Entre WhatsApp e GoHighLevel

• Contatos: número de telefone do WhatsApp → GHL encontra ou cria um contato; nome, sobrenome e campos personalizados sincronizam unidirecionalmente (WhatsApp → GHL) ou bidirecionalmente se GHL tiver um webhook de saída.
• Mensagens: mensagem WhatsApp de entrada → conversa GHL criada ou atualizada; fluxo de trabalho GHL alcança uma ação "enviar mensagem WhatsApp" → chamada da API Whapi envia a mensagem de volta para o cliente.
• Eventos de grupo: membro entra no grupo WhatsApp, membro sai, promoção de membro → webhook Whapi dispara → gatilho webhook GHL de entrada aciona um fluxo de trabalho (etiquetá-los, atribuir proprietário, enviar boas-vindas, criar tarefa).
• Etiquetas e campos personalizados: GHL pode etiqueta contatos com base no comportamento WhatsApp (por exemplo, etiqueta "whatsapp-group-member"); essas etiquetas podem acionar fluxos de trabalho downstream (sequências de nutrição, regras de atribuição, filtros de relatório).
• Gatilhos de fluxo de trabalho: qualquer fluxo de trabalho GHL pode ouvir o tipo de evento de webhook de entrada e executar ações com base no payload (lógica condicional, chamadas de API, sequências de várias etapas).

A Arquitetura de Sincronização Bidirecional

ENTRADA (WhatsApp → Whapi → GHL):

1. Cliente age no WhatsApp
   (envia mensagem, entra no grupo, atualiza status, etc.)

2. Whapi.Cloud recebe o evento
   e dispara um webhook para sua URL de webhook de entrada GHL
   Payload: { event, phone, name, group_id, timestamp, ... }

3. Gatilho de Webhook de Entrada do GHL
   recebe o payload JSON
   Valida (verificação de assinatura opcional)
   Extrai dados: telefone, nome, tipo de evento

4. Fluxo de trabalho GHL é executado
   Encontrar ou Criar Contato (por telefone)
   Adicionar Etiquetas (por exemplo, "whatsapp-group-member")
   Atualizar Campos Personalizados
   Acionar fluxos de trabalho aninhados (enviar email, SMS, WhatsApp, atribuir proprietário)

SAÍDA (GHL → Whapi → WhatsApp):

5. Ação de Fluxo de Trabalho GHL dispara
   (por exemplo, "Enviar Mensagem WhatsApp" webhook personalizado)

6. Webhook Personalizado Chama API Whapi
   POST https://gate.whapi.cloud/messages/text
   Body: { to: phone, body: message_text }
   Headers: Authorization: Bearer YOUR_WHAPI_TOKEN

7. Whapi envia a mensagem via WhatsApp
   para o número do cliente

8. Cliente recebe a mensagem no WhatsApp
   (sem notificação de app, apenas aparece no chat)

9. (Opcional) Webhook Whapi dispara de volta para GHL
   marcando a mensagem como entregue/lida
   Conversa GHL atualiza com status de entrega
  

Etapa 1: Conectar Eventos WhatsApp ao GoHighLevel

1. Vá para Workflows → crie um novo fluxo de trabalho (ou abra um existente).
2. Adicione um Gatilho: procure por "Inbound Webhook".
3. GHL gera uma URL de webhook única -- parece: https://api.gohighlevel.com/webhooks/[WORKSPACE_ID]/[TRIGGER_ID]
4. Copie esta URL. Você a colará nas configurações Whapi.

1. Vá para Configurações → Webhooks.
2. Adicione uma nova URL de webhook. Cole a URL de webhook de entrada GHL que você copiou acima.
3. Selecione os tipos de evento que deseja receber:
   • message.created (mensagens de entrada)
   • group.member.joined (eventos de associação em grupo)
   • contact.status_changed (online/offline, digitando, etc.)
4. Salve. Whapi testará o webhook enviando um evento de teste para GHL.
5. Se GHL receber, você verá uma marca de seleção verde. Se não, verifique se o gatilho de fluxo de trabalho GHL está ativo.

Etapa 2: Criar e Atualizar Contatos GHL do WhatsApp

1. Adicione uma ação: Encontrar ou Criar Contato.
2. Defina o campo de correspondência como Telefone.
3. Mapeie o número de telefone do payload de webhook de entrada para o campo de telefone do contato.
   • Caminho do Payload: ${trigger.body.data.phone} (ajuste com base na forma de payload de webhook Whapi)
4. Se um contato com esse telefone existir, GHL encontra. Se não, GHL cria um novo contato com:
   • Telefone: ${trigger.body.data.phone}
   • Nome: ${trigger.body.data.name} (opcional; defina um padrão como "WhatsApp Contact" se não for fornecido)

Etapa 3: Sincronizar Mensagens WhatsApp com Conversas GHL

1. Webhook Personalizado (ou "Enviar Solicitação HTTP").
2. Defina o método como POST.
3. URL: https://gate.whapi.cloud/messages/text
4. Cabeçalhos:
   • Authorization: Bearer YOUR_WHAPI_TOKEN
   • Content-Type: application/json
5. Corpo (JSON):
   • to: número de telefone do contato (por exemplo, ${contact.phone})
   • body: texto da mensagem (por exemplo, "Bem-vindo ao nosso grupo!")

{
  "to": "+1234567890",
  "body": "Bem-vindo ao grupo, João! Estamos entusiasmados em tê-lo. Verifique as mensagens fixadas para atualizações importantes."
}
  

Exemplo Real: Entrada em Grupo WhatsApp → Fluxo de Trabalho GHL → Mensagem de Boas-Vindas

{
  "event": "group.member.joined",
  "phone": "+1987654321",
  "name": "Sarah Martinez",
  "group_id": "[email protected]",
  "group_name": "Real Estate Team - North Region",
  "timestamp": 1695283200
}
  

1. Gatilho: Webhook de Entrada recebe o evento group.member.joined.
2. Encontrar ou Criar Contato: Pesquisar por telefone +1987654321. Sarah é nova, então GHL cria um contato com o nome "Sarah Martinez".
3. Adicionar Etiquetas: Adicionar "whatsapp-group-member" e "realtor-north-region" ao contato de Sarah.
4. Atribuir Proprietário: Rota para o gerente da Região Norte (por exemplo, através de uma regra de fluxo de trabalho: se etiqueta = "realtor-north-region", atribuir ao proprietário "[email protected]").
5. Criar Tarefa: "Bem-vindo a Sarah à equipe -- enviar documentos de integração".
6. Webhook Personalizado (Enviar WhatsApp): Chamar API Whapi para enviar uma mensagem de boas-vindas personalizada para o número de Sarah.
   • Mensagem: "Bem-vindo, ${contact.firstName}! Você é agora parte da Equipe de Imóveis. Verifique seu email para documentos de integração. Dúvidas? Responda aqui."
7. Anotação de Registro: Adicione uma anotação ao contato de Sarah: "Entrou no grupo WhatsApp em [data]. Fluxo de trabalho executado."

Construindo Mais Fluxos de Trabalho GoHighLevel com Gatilhos WhatsApp

• Mensagem de novo cliente → criação de tíquete: mensagem WhatsApp de entrada aciona criação de tíquete; se nenhum tíquete aberto existir, rotear para fila de suporte e enviar resposta automática: "Recebemos sua mensagem. O suporte responde em 2 horas."
• Fluxo de trabalho de abandono de contato: contato não ativo no WhatsApp por 30 dias → GHL envia mensagem WhatsApp de reengajamento, acompanhe com email, crie tarefa de vendas.
• Atualizações de status de pedido: contato etiquetado "has-active-order" → GHL envia diariamente WhatsApp: "Seu pedido envia amanhã. Rastreamento: [URL]."
• Fluxo de qualificação de prospecto: novo contato entra no grupo → GHL faz perguntas de qualificação via WhatsApp → etiqueta "hot-lead" ou "cold-lead" com base nas respostas → rota para fluxo de trabalho de vendas apropriado.
• Mensagens baseadas em permissão: campo de contato "consent-marketing" = true → GHL envia WhatsApp promocional; se false, apenas mensagens transacionais. Conformidade integrada ao fluxo de trabalho.

Evitando Problemas de Sincronização e Eventos Duplicados

Lista de Verificação de Integração WhatsApp + GoHighLevel

• URL de webhook Whapi está ativa em GHL -- teste enviando uma mensagem WhatsApp de outro número; confirme que GHL recebe o webhook de entrada (verifique logs de webhook GHL).
• Correspondência de contato está funcionando -- crie um contato de teste em GHL com um número conhecido, envie uma mensagem WhatsApp desse número, confirme que GHL encontra o contato existente (não criando uma duplicata).
• Mensagens WhatsApp de saída enviam com sucesso -- execute a ação de webhook "Enviar WhatsApp" em GHL, confirme que a mensagem chega no WhatsApp. Observe erros 401 ou 403 (problema de token de autenticação) e erros 404 (telefone não conectado em Whapi).
• Fluxos de trabalho são idempotentes -- dispare manualmente o mesmo payload de webhook duas vezes; confirme que tarefas, etiquetas e mensagens não são duplicadas.
• Formato de número de telefone é consistente -- todos os números de telefone em GHL usam o mesmo formato (por exemplo, `+1234567890` com prefixo `+`). Verifique consultando alguns contatos e comparando com payloads de webhook Whapi.
• Tratamento de erro está em vigor -- fluxo de trabalho GHL inclui um condicional para "se webhook falhar" (por exemplo, token Whapi expirado, número WhatsApp não conectado); adicione uma ação de fallback como "enviar SMS" ou "registrar erro e alertar admin".
• Limites de taxa são respeitados -- se enviar 100+ mensagens/hora, espaçá-las (adicione atraso de 1 segundo entre envios em GHL ou use uma fila). Monitore o painel Whapi para contagens de chamadas de API e avisos de limite de taxa WhatsApp.
• Registro e monitoramento ativados -- GHL registra cada webhook de entrada e ação de mensagem de saída (verifique logs de execução GHL); painel Whapi mostra status de entrega de webhook e confirmações de entrega de mensagem.