Enviar conversas do WhatsApp para o Salesforce a partir de um número Coexistence

Como é o workflow do n8n?

Quatro nós em sequência, mais o ramo de verificação de que todos os webhooks da Meta precisam.

Um nó Webhook recebe o POST que a Meta envia por cada mensagem. Um nó Salesforce executa uma consulta SOQL a um Lead ou Contact cujo telefone corresponda ao do remetente. Um nó IF separa os casos consoante tenha ou não vindo algum resultado: se veio, o workflow segue com o id do registo; se não veio, um nó Salesforce cria um Lead com o nome de perfil que consta do payload. Um último nó Salesforce cria uma tarefa nesse registo, com o texto da mensagem na descrição e o assunto a indicar que foi uma mensagem de WhatsApp.

O ramo de verificação responde ao GET da Meta com o valor de hub.challenge como corpo simples. Sem ele, a Meta nunca começa a entregar mensagens e o resto do workflow fica parado.

Tarefa ou nota: qual deve guardar a mensagem?

Uma tarefa, na maioria das equipas, porque fica na cronologia de atividades que os comerciais já consultam e pode ser usada em relatórios. Defina o estado como concluída, para não surgir como tarefa em aberto, e dê-lhe um assunto que indique o canal, de modo que filtrar a atividade de WhatsApp seja uma única condição.

A operação Add note do nó do n8n serve outro caso: um resumo em vez de todas as mensagens. Algumas equipas fazem o workflow reunir as mensagens do dia por contacto e escrever uma só nota ao fim da tarde, o que mantém a cronologia legível quando um cliente envia vinte linhas curtas.

Qualquer que seja a escolha, grave o id da mensagem do WhatsApp no registo. A Meta repete as entregas, e um workflow que verifica se o id já existe antes de escrever nunca regista a mesma mensagem duas vezes.

A equipa continua a poder responder pelo telemóvel e o Salesforce vê essas respostas?

Sim, a ambos. A Coexistence mantém a app do WhatsApp Business a funcionar no mesmo número, pelo que as pessoas que respondiam aos clientes ontem continuam a fazê-lo. Quando respondem a partir da app, a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Acrescente ao workflow um segundo caminho para esses ecos e registe-os como tarefas de saída. Um comercial que abra o lead vê então a pergunta e a resposta dada pela loja, por ordem, sem que ninguém copie uma conversa à mão.

As respostas que o próprio workflow envia, através de um nó HTTP Request contra a Cloud API, devem ser registadas no momento do envio. O workflow já tem à mão o texto e o id do registo.

Como evitar leads duplicados?

Faça a correspondência por um número de telefone normalizado, não pelo campo tal como foi escrito. A Meta envia o remetente como dígitos com o indicativo do país e sem o sinal de mais. Os campos de telefone do Salesforce guardam o que quem criou o registo introduziu, com espaços, parênteses e hífenes.

A abordagem fiável é um campo de texto personalizado com o número só em dígitos, preenchido pelo workflow ao criar um lead e por uma carga retroativa nos registos existentes. A consulta SOQL compara depois esse campo por igualdade, o que é rápido e exato.

Verifique também os contactos, não só os leads. Um cliente que já foi convertido é um Contact, e um workflow que procure apenas leads cria um lead novo por cada cliente existente que escreva.

Erros comuns

• Procurar apenas no objeto Lead. Os clientes existentes são Contacts, e cada um que escreva torna-se um lead duplicado.
• Registar as mensagens como tarefas em aberto. Os comerciais recebem uma tarefa por cada linha do cliente; defina o estado como concluída ao criá-las.
• Omitir o ramo de verificação GET no workflow. A Meta nunca confirma o destino e nenhuma mensagem chega a ser entregue.

Perguntas frequentes

Continue a ler