Conectar o WhatsApp ao Zoho CRM em um número com Coexistência

Como uma mensagem do WhatsApp se torna um registro no Zoho CRM?

A Meta envia cada mensagem do número ao destino de webhook que você definiu, aqui um nó Webhook do n8n. O workflow pega o número do remetente no payload e chama o endpoint de busca do Zoho com phone igual a ele, primeiro em Leads e depois em Contatos. O Zoho verifica todos os campos de telefone do módulo, então uma correspondência em Mobile ou em Phone vale igual, e você não precisa adivinhar qual campo o vendedor usou.

Quando nada volta, o nó do Zoho CRM no n8n cria um Lead com o nome do perfil do WhatsApp e o número. De qualquer forma, o workflow passa a ter um id de registro e grava a mensagem como nota nesse registro por meio de POST /Notes. Uma nota exige apenas Note_Content e um Parent_Id que indique o módulo e o registro.

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

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

Leitura e criação nos módulos em que você busca e escreve, além de criação em Notes. O Zoho chama o escopo da nota de ZohoCRM.modules.notes.CREATE e exige junto o escopo de criação do módulo pai, então uma credencial que cria Leads mas nunca recebeu o escopo de notas falha no último passo com um erro de autorização.

O nó do Zoho CRM no n8n cobre Leads, Contatos, Contas, Negócios e vários documentos de vendas, com criar, upsert, obter, obter todos, atualizar e excluir. Notas não estão entre os recursos dele, e por isso a nota passa por um nó HTTP Request. O n8n permite que esse nó reutilize a credencial do Zoho que você já conectou, então há uma única autorização OAuth para gerenciar, e não duas.

Defina o domínio da API conforme o data center do seu Zoho. Uma credencial criada na região da UE chama zohoapis.eu, e não zohoapis.com.

Quantas mensagens o Zoho CRM aguenta?

O Zoho mede sua API em créditos por 24 horas corridas, e o orçamento depende da edição e do número de usuários. A edição Free recebe 5.000. A Standard recebe 50.000 mais 250 por usuário, a Professional 50.000 mais 500 por usuário e a Enterprise 50.000 mais 1.000 por usuário, cada uma com um teto por edição.

Cada mensagem recebida custa uma busca e a gravação de uma nota, mais a criação de um lead para quem escreve pela primeira vez. Isso cabe com folga no 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 simultâneas e a Standard 10, então uma rajada de respostas a um envio em massa pode formar fila. Configure o workflow do n8n para processar uma execução por vez se o Zoho começar a devolver erros de limite.

As respostas enviadas pelo celular chegam ao Zoho CRM?

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

Dê ao workflow um ramo para os ecos e grave-os como notas com título de mensagem enviada. Assim, o vendedor que abre o lead no Zoho lê os dois lados da conversa, e ninguém precisa colar capturas de tela no CRM.

As mensagens que o próprio workflow envia pela Cloud API, como um template aprovado depois que um negócio muda de etapa, é melhor registrá-las no momento do envio, porque o workflow já tem o texto e o id do registro.

Erros comuns

• Dar à credencial os escopos de leads mas não ZohoCRM.modules.notes.CREATE. A busca e o lead funcionam, e depois toda nota falha.
• Chamar zohoapis.com a partir de uma conta de outro data center do Zoho. Use o domínio da API da região em que a conta está.
• Buscar só em Leads. Clientes convertidos são Contatos, e cada um que escreve vira um lead duplicado novo.

Perguntas frequentes

Continue lendo