Ligar o WhatsApp aos contactos do GoHighLevel num número Coexistence

Como chega uma mensagem de WhatsApp a um contacto do HighLevel?

A Meta envia cada mensagem recebida no número para o destino de webhook definido, neste caso um nó Webhook do n8n. O workflow passa o número do remetente e o nome de perfil do WhatsApp ao nó HighLevel do n8n, cujo recurso de contactos tem uma operação de criar ou atualizar. Assim, um novo remetente passa a ser um contacto e um remetente conhecido é encontrado em vez de duplicado.

Com o id do contacto disponível, um nó HTTP Request envia o corpo da mensagem para /contacts/{contactId}/notes. A nota aparece no registo do contacto, onde quem o abrir vê o que o cliente escreveu. Quando a mensagem exige seguimento, o nó HighLevel também pode criar uma tarefa no contacto ou uma oportunidade num pipeline, duas operações que suporta diretamente.

A equipa continua a responder a partir da app do WhatsApp Business durante todo o processo.

Que token deve usar o workflow?

Um token Private Integration. A API v2 do HighLevel é acedida com OAuth ou com um destes tokens, e as antigas chaves da API v1 chegaram ao fim de vida. O token Private Integration cria-se nas definições da subconta, com o âmbito das permissões que assinalar, e envia-se no cabeçalho Authorization como qualquer token de acesso.

Não se renova sozinho, o que convém a uma automação: continua a funcionar até alguém o rodar. Quando o rodar, o HighLevel mantém o token antigo e o novo válidos em simultâneo durante sete dias, que é o prazo para colar o novo no n8n antes de o antigo deixar de funcionar.

Assinale apenas os âmbitos de que o workflow precisa: contactos, notas e, se os usar, oportunidades e tarefas. Se não encontrar as Private Integrations nas definições, o HighLevel indica que deve ativá-las em Labs.

Como serve um só workflow várias subcontas de clientes?

Encaminhando pelo número que recebe a mensagem. Todos os webhooks enviados pela Meta incluem o phone_number_id do número empresarial que recebeu a mensagem. Aponte o número de cada cliente para o mesmo webhook do n8n, mantenha uma pequena tabela que associe cada phone_number_id à subconta desse cliente e ao respetivo token, e consulte o token no início de cada execução.

Deste modo, há um único workflow para manter em todos os clientes, o que importa a uma agência mais do que a qualquer outro. Uma correção na lógica de correspondência ou no formato da nota chega a todos de uma só vez.

Os limites de pedidos são contados por app e por subconta, pelo que os clientes não consomem a quota uns dos outros: cada um tem os seus 100 pedidos por cada dez segundos e 200 000 por dia.

As respostas escritas no telemóvel chegam ao HighLevel?

Podem chegar. Num número Coexistence, a app do WhatsApp Business continua em uso, e quando alguém responde a partir dela a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Acrescente um ramo para esses ecos e escreva-os como notas marcadas como enviadas. O registo do contacto fica assim com as mensagens do cliente e as respostas da empresa por ordem, que é o que um cliente espera ver ao abrir o seu CRM.

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

Erros comuns

• Usar uma chave da API v1. A API v1 do HighLevel chegou ao fim de vida; a API v2 exige um token Private Integration ou OAuth.
• Rodar o token Private Integration sem atualizar o n8n dentro dos sete dias de sobreposição. Todas as chamadas falham quando o token antigo expira.
• Escrever as mensagens de todos os clientes com o token de uma só subconta. Associe primeiro o phone_number_id à subconta certa, ou os registos vão parar ao cliente errado.

Perguntas frequentes

Continue a ler