HighLevel + WhatsApp, sincronização nativa

Resumo

O Wazzap se instala como um conversation provider personalizado no HighLevel, no nível da agência. A partir daí você mapeia cada sub-conta do Wazzap para uma sub-conta do GHL (um para um). Depois de ligado, a sincronização é bidirecional e instantânea:

• Um cliente manda um WhatsApp, a mensagem aparece na aba Conversations do GHL.
• Um vendedor responde dentro do GHL, e a resposta sai do seu número real do WhatsApp.
• Os dados do contato (nome, telefone, tags) se propagam nos dois sentidos.

O que sincroniza (e o que não)

Para alinhar expectativas:

• Sincroniza nos dois sentidos: texto, imagens, áudios, vídeos, documentos, figurinhas, localizações, cartões de contato, respostas, edição de mensagem e reações (quando o GHL suportar).
• Sincroniza em um sentido (Wazzap → GHL): indicador de digitação, confirmação de leitura, presença.
• Não sincroniza: enquetes do WhatsApp (o GHL não tem equivalente), atualizações de localização ao vivo depois do primeiro ping, mídia de visualização única.

Configuração em 3 passos

1. Pegue sua API Key da agência no HighLevel

1. No HighLevel, mude para a visão de Agência.
2. Abra Settings → Business Profile → API Key.
3. Copie a Agency API Key. Trate como uma senha.

Cole a chave no Wazzap em Configurações → Integrações → HighLevel. Clique em "Conectar". A conexão é verificada em segundos.

2. Mapear as sub-contas

Para cada sub-conta do Wazzap (um número de WhatsApp conectado), escolha para qual sub-conta do GHL ela deve sincronizar. Uma sub-conta do Wazzap = uma sub-conta do GHL. Se você tem 10 clientes na agência, vai parear 10 sub-contas do Wazzap com as 10 sub-contas correspondentes do GHL.

Wazzap sub-conta #4  →  GHL sub-conta "Acme Co"
Wazzap sub-conta #5  →  GHL sub-conta "Vertex AI"
…

3. Teste com a primeira conversa

Pelo seu celular, mande um WhatsApp para o número conectado. Abra a aba Conversations do GHL na sub-conta correspondente, a mensagem precisa estar lá em 1 ou 2 segundos. Responda pelo GHL. O seu celular vibra. Pronto.

Configuração white-label

Se você revende o Wazzap com a sua própria marca (white-label de agência), a aba de conversas do GHL pode mostrar a sua marca no lugar de "Wazzap":

1. No Wazzap, vá em Configurações de Marca → Nome do provider no GHL.
2. Coloque o nome da sua agência e suba o seu logo (PNG, quadrado, 512px ou mais).
3. Clique em "Enviar para o HighLevel". O GHL re-renderiza o conversation provider com a sua marca.

Seus clientes dentro do GHL veem a sua agência, nunca "Wazzap". Veja o guia de white-label para domínio e e-mails também.

Solução de problemas

"Conexão verificada" mas as mensagens não aparecem no GHL

Causa mais comum: uma sub-conta está mapeada para a location errada do GHL. Abra o painel de mapeamento e confirme que a sub-conta de destino é mesmo a que tem as conversas ativas.

Mensagens saindo do GHL aparecem como "Falhou"

O seu número de WhatsApp provavelmente está desconectado (celular offline há 14 dias ou mais, ou banido). Escaneie o QR no Wazzap de novo. A fila de mensagens tenta reenviar automaticamente.