Connecter WhatsApp au CRM Bitrix24 sur un numéro Coexistence

Comment n8n communique-t-il avec Bitrix24 ?

Par un webhook entrant, qui dans Bitrix24 n'est pas un récepteur mais un identifiant d'accès. Vous le créez dans les ressources pour les développeurs de Bitrix24, vous choisissez les scopes qu'il peut utiliser, et vous obtenez une URL contenant l'adresse de votre portail, l'id de l'utilisateur qui l'a créé et un code secret. Ajouter un nom de méthode à cette URL appelle l'API REST en tant que cet utilisateur, avec ses permissions.

Dans n8n, chaque étape Bitrix24 est donc un nœud HTTP Request qui envoie une requête POST à cette URL suivie d'une méthode comme crm.lead.add.json. Il n'y a aucun flux OAuth à terminer et aucune application à publier. Accordez au webhook uniquement le scope CRM, et créez-le depuis un utilisateur dont les permissions couvrent les leads et les contacts que le workflow doit voir, car Bitrix24 vérifie l'accès au nom de cet utilisateur.

Quelles méthodes Bitrix24 le workflow appelle-t-il ?

Trois, dans l'ordre, une fois que le nœud Webhook de n8n a reçu le message de Meta.

crm.duplicate.findbycomm avec le type PHONE et le numéro de l'expéditeur renvoie les ids des leads, contacts et entreprises qui le détiennent. C'est la bonne recherche, car elle interroge les trois à la fois et qu'elle est conçue pour faire correspondre des moyens de communication plutôt qu'un champ de texte.

Quand elle ne renvoie rien, crm.lead.add crée un lead avec le nom de profil WhatsApp comme titre et le numéro dans son champ téléphone. Ensuite, crm.timeline.comment.add écrit le texte du message en commentaire sur la fiche, avec ENTITY_TYPE, ENTITY_ID et COMMENT. Le commentaire apparaît dans la timeline de la fiche, à côté des appels et des e-mails, là où un commercial regarde déjà.

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

Comment la limite de débit influence-t-elle le workflow ?

Bitrix24 mesure les appels REST avec un seau percé (leaky bucket). Chaque requête s'ajoute à un compteur, le compteur se vide à un rythme fixe chaque seconde, et dès qu'il dépasse un seuil, la requête suivante reçoit une réponse 503 avec QUERY_LIMIT_EXCEEDED. Sur les forfaits Enterprise, le compteur se vide de 5 par seconde avec un seuil de 250 ; sur tous les autres forfaits, il se vide de 2 avec un seuil de 50.

Chaque message entrant coûte deux ou trois appels, donc un flux régulier n'approche jamais la limite. Une rafale, si : cinquante clients qui répondent au même template en une minute représentent jusqu'à 150 appels. Configurez les nœuds HTTP Request pour réessayer en cas d'échec après une courte attente, et exécutez les exécutions du workflow l'une après l'autre, afin que la rafale s'écoule vers Bitrix24 au lieu de rebondir dessus.

Les réponses saisies sur le téléphone arrivent-elles dans Bitrix24 ?

Oui, c'est possible. Sur un numéro Coexistence, l'application WhatsApp Business continue de fonctionner, et lorsque quelqu'un répond depuis celle-ci, Meta envoie un écho du message sortant à la même destination de webhook, sous le champ smb_message_echoes.

Une seconde branche du workflow traite ces échos comme les messages entrants, avec le commentaire marqué comme sortant. La fiche affiche alors la conversation complète, avec les lignes du client et les réponses de l'entreprise dans l'ordre.

Les réponses que le workflow envoie lui-même par la Cloud API sont déjà entre ses mains au moment de l'envoi : enregistrez-les à cet instant plutôt que d'attendre le retour d'un webhook.

Erreurs courantes

• Coller l'URL du webhook entrant dans du code côté client ou dans un document partagé. Le secret qu'elle contient donne accès à tous les scopes accordés au webhook.
• Créer le webhook depuis un utilisateur qui ne voit pas tous les leads. Les recherches ratent alors des fiches et le workflow crée des doublons.
• Envoyer une rafale d'appels sans nouvelles tentatives. Bitrix24 répond 503 QUERY_LIMIT_EXCEEDED et ces messages n'arrivent jamais dans la timeline.

Questions fréquemment posées

Poursuivre la lecture