Ligar o WhatsApp ao Zoho CRM num número em Coexistência

Como se transforma uma mensagem de WhatsApp num registo do Zoho CRM?

A Meta envia cada mensagem do número para o destino de webhook definido, aqui um nó Webhook do n8n. O workflow retira o número do remetente do payload e chama o endpoint de pesquisa do Zoho com phone definido para esse número, primeiro em Leads e depois em Contacts. O Zoho verifica todos os campos de telefone do módulo, pelo que uma correspondência em Mobile ou em Phone conta nos dois casos, o que evita ter de adivinhar qual o campo que um comercial usou.

Quando nada é devolvido, o nó Zoho CRM do n8n cria um Lead com o nome de perfil do WhatsApp e o número. Em qualquer dos casos, o workflow passa a ter um id de registo e escreve a mensagem como nota nesse registo através de POST /Notes. Uma nota só precisa de Note_Content e de um Parent_Id que indique o módulo e o registo.

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

Que permissões do Zoho precisa a credencial do n8n?

Leitura e criação nos módulos que se pesquisam e onde se escreve, mais criação em Notes. O Zoho dá ao âmbito das notas o nome ZohoCRM.modules.notes.CREATE e exige a seu lado o âmbito de criação do módulo principal, pelo que uma credencial que consiga criar Leads, mas à qual nunca foi atribuído o âmbito de notas, falha no último passo com um erro de autorização.

O nó Zoho CRM do n8n abrange Leads, Contacts, Accounts, Deals e vários documentos de vendas, com create, upsert, get, get all, update e delete. As notas não fazem parte dos seus recursos, e por isso a nota passa por um nó HTTP Request. O n8n permite que esse nó reutilize a credencial do Zoho já ligada, pelo que há uma só autorização OAuth para gerir, em vez de duas.

Defina o domínio da API para o seu centro de dados do Zoho. Uma credencial criada na região da UE chama zohoapis.eu, não zohoapis.com.

Quantas mensagens consegue o Zoho CRM absorver?

O Zoho mede a sua API em créditos por cada 24 horas contínuas, e o orçamento depende da edição e do número de utilizadores. A edição Free recebe 5 000. A Standard recebe 50 000 mais 250 por utilizador, a Professional 50 000 mais 500 por utilizador e a Enterprise 50 000 mais 1 000 por utilizador, cada uma com um limite máximo por edição.

Cada mensagem recebida custa uma pesquisa e a escrita de uma nota, mais a criação de um lead no caso de remetentes novos. Isso fica confortavelmente dentro do orçamento de uma edição paga para o número de uma pequena empresa. O limite que costuma pesar primeiro é a concorrência: a Free permite 5 chamadas em simultâneo e a Standard 10, pelo que um pico de mensagens, vindo de respostas a uma difusão, pode ficar em fila. Configure o workflow do n8n para processar as execuções uma de cada vez, se o Zoho devolver erros de limite.

As respostas enviadas a partir do telemóvel chegam ao Zoho CRM?

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

Dê ao workflow um ramo para os ecos e escreva-os como notas com título de mensagem enviada. O comercial que abre o lead no Zoho lê assim os dois lados da conversa, e ninguém tem de colar capturas de ecrã no CRM.

As mensagens que o próprio workflow envia através da Cloud API, como um template aprovado após a mudança de fase de um negócio, convém registá-las no momento do envio, porque o workflow já tem o texto e o id do registo.

Erros comuns

• Atribuir à credencial os âmbitos de leads, mas não ZohoCRM.modules.notes.CREATE. A pesquisa e o lead funcionam e, depois, todas as notas falham.
• Chamar zohoapis.com a partir de uma conta alojada noutro centro de dados do Zoho. Use o domínio da API da região onde a conta se encontra.
• Pesquisar apenas em Leads. Os clientes convertidos são Contacts, e cada um que escreve transforma-se num lead duplicado novo.

Perguntas frequentes

Continue a ler