Connecter WhatsApp à Zoho CRM sur un numéro Coexistence

Comment un message WhatsApp devient-il une fiche Zoho CRM ?

Meta envoie chaque message du numéro vers la destination de webhook que vous avez définie, ici un node Webhook de n8n. Le workflow extrait le numéro de l'expéditeur du payload et appelle l'endpoint de recherche de Zoho avec phone réglé sur cette valeur, d'abord sur Leads puis sur Contacts. Zoho vérifie tous les champs de téléphone du module : une correspondance sur Mobile ou sur Phone compte dans les deux cas, ce qui vous évite de deviner quel champ un commercial a utilisé.

Si rien ne remonte, le node Zoho CRM de n8n crée un Lead avec le nom de profil WhatsApp et le numéro. Dans tous les cas, le workflow dispose alors d'un identifiant de fiche, et il écrit le message en note sur cette fiche via POST /Notes. Une note n'exige que Note_Content et un Parent_Id qui désigne le module et la fiche.

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

Quelles autorisations Zoho faut-il pour le credential n8n ?

La lecture et la création sur les modules que vous interrogez et dans lesquels vous écrivez, plus la création sur Notes. Zoho nomme le scope des notes ZohoCRM.modules.notes.CREATE et exige à côté le scope de création du module parent. Un credential qui peut créer des Leads mais qui n'a jamais reçu le scope des notes échoue donc à la dernière étape avec une erreur d'autorisation.

Le node Zoho CRM de n8n couvre Leads, Contacts, Accounts, Deals et plusieurs documents commerciaux, avec les opérations create, upsert, get, get all, update et delete. Les notes ne font pas partie de ses ressources, c'est pourquoi la note passe par un node HTTP Request. n8n permet à ce node de réutiliser le credential Zoho déjà connecté : vous n'avez qu'une seule autorisation OAuth à gérer, et non deux.

Définissez le domaine d'API sur votre centre de données Zoho. Un credential créé dans la région UE appelle zohoapis.eu, et non zohoapis.com.

Combien de messages Zoho CRM peut-il absorber ?

Zoho mesure son API en crédits sur 24 heures glissantes, et le budget dépend de l'édition et du nombre d'utilisateurs. L'édition Free reçoit 5 000 crédits. Standard obtient 50 000 plus 250 par utilisateur, Professional 50 000 plus 500 par utilisateur, et Enterprise 50 000 plus 1 000 par utilisateur, chacune avec un plafond propre à l'édition.

Chaque message entrant coûte une recherche et l'écriture d'une note, plus une création de lead pour les nouveaux expéditeurs. C'est largement dans le budget d'une édition payante pour le numéro d'une petite entreprise. La limite qui se fait sentir en premier est généralement la concurrence : Free autorise 5 appels simultanés et Standard 10, si bien qu'une rafale de réponses à une diffusion peut se mettre en file d'attente. Réglez le workflow n8n pour traiter les exécutions une par une si Zoho renvoie des erreurs de limite.

Les réponses envoyées depuis le téléphone arrivent-elles dans Zoho CRM ?

Oui, elles le peuvent. Sur un numéro Coexistence, l'app WhatsApp Business continue de fonctionner, et quand quelqu'un répond depuis celle-ci, Meta envoie un écho de ce message sortant à la même destination de webhook, sous le champ smb_message_echoes.

Donnez au workflow une branche pour les échos et écrivez-les en notes intitulées comme sortantes. Le commercial qui ouvre le lead dans Zoho lit alors les deux côtés de la conversation, et personne n'a besoin de coller des captures d'écran dans le CRM.

Les messages que le workflow envoie lui-même via la Cloud API, comme un template approuvé après un changement d'étape d'une affaire, se consignent de préférence au moment de l'envoi, car le workflow détient déjà le texte et l'identifiant de la fiche.

Erreurs courantes

• Accorder au credential les scopes des leads mais pas ZohoCRM.modules.notes.CREATE. La recherche et le lead fonctionnent, puis chaque note échoue.
• Appeler zohoapis.com depuis un compte hébergé dans un autre centre de données Zoho. Utilisez le domaine d'API de la région où se trouve le compte.
• Ne chercher que dans Leads. Les clients convertis sont des Contacts, et chacun d'eux qui écrit génère un nouveau lead en doublon.

Questions fréquemment posées

Poursuivre la lecture