Conectar o WhatsApp aos contatos do GoHighLevel em um número com Coexistência

Como uma mensagem do WhatsApp chega a um contato do HighLevel?

A Meta envia cada mensagem recebida no número para o destino de webhook que você definiu, aqui um nó Webhook do n8n. O workflow passa o número do remetente e o nome de perfil do WhatsApp para o nó HighLevel do n8n, cujo recurso de contato tem uma operação de criar ou atualizar. Assim, um remetente novo vira contato e um já conhecido é encontrado, sem duplicar.

Com o id do contato em mãos, um nó HTTP Request envia o texto da mensagem para /contacts/{contactId}/notes. A nota aparece no registro do contato, onde qualquer pessoa que o abra vê o que o cliente escreveu. Quando a mensagem pede um acompanhamento, o nó HighLevel também pode criar uma tarefa no contato ou uma oportunidade em um pipeline, e ambos são compatíveis diretamente.

A equipe continua respondendo pelo app do WhatsApp Business o tempo todo.

Qual token o workflow deve usar?

Um token de Private Integration. A API v2 do HighLevel é acessada por OAuth ou por um desses tokens, e as antigas chaves da API v1 chegaram ao fim da vida útil. O token de Private Integration é criado nas configurações da subconta, limitado às permissões que você marcar, e enviado no cabeçalho Authorization como qualquer token de acesso.

Ele não se renova sozinho, o que combina com uma automação: continua funcionando até alguém fazer a rotação. Quando você faz a rotação, o HighLevel mantém o token antigo e o novo válidos juntos por sete dias, e essa é a janela para colar o novo no n8n antes de o antigo parar.

Marque apenas os escopos de que o workflow precisa: contatos, notas e, se você os usar, oportunidades e tarefas. Se não encontrar Private Integrations nas configurações, o HighLevel orienta ativar o recurso em Labs.

Como um workflow atende várias subcontas de clientes?

Roteando pelo número que recebeu a mensagem. Todo webhook enviado pela Meta inclui o phone_number_id do número comercial que recebeu a mensagem. Aponte o número de cada cliente para o mesmo webhook do n8n, mantenha uma tabela pequena que associa cada phone_number_id à subconta desse cliente e ao respectivo token, e busque o token no início de cada execução.

Isso deixa um só workflow para manter em todos os clientes, o que importa mais para uma agência do que para qualquer outra pessoa. Uma correção na lógica de correspondência ou no formato da nota vale para todos de uma vez.

Os limites de taxa são contados por app por subconta, então os clientes não consomem a cota uns dos outros: cada um tem suas 100 requisições a cada dez segundos e 200.000 por dia.

As respostas digitadas no celular chegam ao HighLevel?

Podem chegar. Em um número com Coexistência, o app do WhatsApp Business continua em uso, e quando alguém responde por ele a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Adicione uma ramificação para esses ecos e grave-os como notas marcadas como enviadas. O registro do contato passa a conter, em ordem, as falas do cliente e as respostas da empresa, que é o que um cliente espera ver ao abrir o CRM.

Quando o próprio workflow envia uma mensagem pela Cloud API, por exemplo um template aprovado depois de um agendamento, grave a nota no momento do envio. O workflow já tem o texto e o id do contato.

Erros comuns

• Usar uma chave da API v1. A API v1 do HighLevel chegou ao fim da vida útil; a API v2 exige um token de Private Integration ou OAuth.
• Fazer a rotação do token de Private Integration sem atualizar o n8n dentro da sobreposição de sete dias. Toda chamada falha quando o token antigo expira.
• Gravar as mensagens de todos os clientes com o token de uma única subconta. Associe antes o phone_number_id à subconta correta, ou os registros caem no cliente errado.

Perguntas frequentes

Continue lendo