Intégration de Bitrix24 CRM et WhatsApp via Make.com

Ce flux crée un contact dans Bitrix24 CRM lorsqu'un nouveau message WhatsApp est reçu et que le contact avec ce numéro n'existe pas dans Bitrix24. Le flux est basé sur les Webhooks TimelinesAI , l'intégration Bitrix24 CRM avec Make.com et l'API REST de Bitrix24 CRM.

Créer un nouveau contact dans Bitrix24 CRM lorsqu'un nouveau message WhatsApp est reçu

1. Créer un nouveau scénario dans Make.com
2. Ajouter un module Webhook personnalisé. Les étapes suivantes nécessitent des données Webhook présentes. Assurez-vous d'avoir exécuté le module Webhook et d'avoir des données dans la charge utile
3. Ajouter un nouveau module Rechercher des contacts Bitrix24 : Le but de cette étape est de vérifier si le contact existe déjà dans Bitrix24 CRM ou non. La recherche se fait en utilisant le champ Numéro de téléphone. Pour ajouter ce module, cliquez sur l'icône + à côté du module Webhooks existant > recherchez et sélectionnez Bitrix24 > sélectionnez Rechercher des contacts

• Filtre: sélectionnez Téléphone ; opérateur: égal . Cliquez sur le champ vide suivant. Une nouvelle boîte apparaîtra à droite avec les données disponibles du module Webhook. Trouvez expéditeur > téléphone . Vous pouvez cliquer sur la valeur trouvée OU la faire glisser dans le champ vide:

• Cliquez sur OK
• Cliquez avec le bouton droit sur le module Rechercher des contacts récemment créé et sélectionnez Exécuter ce module uniquement > entrez n'importe quel numéro de téléphone > cliquez sur OK. Cela recherche les contacts dans votre Bitrix24 CRM par numéro de téléphone et renvoie les résultats indiquant si un contact avec ce numéro existe. Les étapes suivantes nécessitent des données de sortie. Assurez-vous d'avoir exécuté le module Rechercher des contacts et d'avoir des données dans la charge utile:

6. Ajouter le premier filtre: cliquez sur l'icône de clé à molette entre le Routeur et le module vide suivant > puis cliquez sur Configurer un filtre

• Nommez votre filtre Le contact n'existe pas
• Condition: cliquez sur le champ. Une nouvelle boîte apparaîtra à droite avec les données disponibles du module Rechercher des contacts. Trouvez Nombre total de paquets >. Vous pouvez cliquer sur la valeur trouvée OU la faire glisser dans le champ vide
• Opérateurs numériques: sélectionnez inférieur à et tapez 1 dans le champ suivant:

7. Ajouter un nouveau module Créer un contact Bitrix24: Le but de cette étape est de créer un contact s'il n'a pas été trouvé par le module de recherche. Pour ajouter ce nouveau module, cliquez sur l'icône + à côté du filtre existant “Le contact n'existe pas” > recherchez et sélectionnez Bitrix24 > sélectionnez Créer un contact

• Téléphone: peut être mappé avec message: expéditeur: téléphone du webhook TimelinesAI

• Autres champs: peuvent être mappés, laissés vides ou avoir des données personnalisées selon vos besoins

Résultat final: Le webhook TimelinesAI surveille les messages WhatsApp entrants > recherche dans Bitrix24 CRM par numéro de téléphone > si le contact n'est pas trouvé > crée un nouveau contact:

Synchroniser les nouveaux messages WhatsApp entrants dans les commentaires de tâches dans Bitrix24 CRM

Ce flux crée une tâche dans Bitrix24 CRM lorsqu'un nouveau message WhatsApp est reçu, lie la tâche au contact Bitrix24 CRM correspondant et ajoute de nouveaux messages WhatsApp entrants en tant que commentaires à la tâche. Le flux est basé sur les Webhooks TimelinesAI , l'intégration Bitrix24 CRM avec Make.com et l'API REST de Bitrix24 CRM.

1. Complétez d'abord les étapes de la section "Créer un nouveau contact dans Bitrix24 CRM lorsqu'un nouveau message WhatsApp est reçu" de cet article. Vous devriez avoir les modules suivants dans votre scénario pour continuer:

2. Ajouter un nouveau module Faire un appel API: Le but de ce module est de créer une tâche dans Bitrix24 CRM et de lier la tâche au contact Bitrix24 CRM qui a été créé plus tôt dans ce flux. Pour ajouter un nouveau module : survolez le module existant Créer un contact et cliquez sur + pour ajouter un nouveau module. Recherchez et sélectionnez Bitrix24 > sélectionnez Faire un appel API

2. Configurez le nouveau module Faire un appel API:
Connexion: Cliquez sur le bouton Ajouter et entrez votre URL Bitrix24 > cliquez sur Enregistrer
URL: tasks.task.add
Méthode: POST
En-têtes: ajouter un nouvel en-tête avec clé = Content-Type et valeur= application/json
Body: ajouter

{ "fields": {
"TITLE": "TimelinesAI_WhatsApp_messages",
"UF_CRM_TASK": ["C_YOUR_ID_HERE],
"ADD_IN_REPORT": "N",
"STATUS":"5",
"RESPONSIBLE_ID": "1"
}
}

Remarque: les détails des paramètres de cette demande sont disponibles à https://training.bitrix24.com/rest_help/tasks/task/tasks/tasks_task_getFields.php

YOUR_ID_HERE doit être remplacé par les données de sortie de votre propre module Créer un contact.

3. Enregistrez vos modifications. Cliquez avec le bouton droit sur le module nouvellement créé et renommez-le en Appel API: créer une tâche. Il est important de nommer correctement les modules pour éviter toute confusion lors de l'ajout de modules Faire un appel API supplémentaires.

4. Cliquez avec le bouton droit sur le module et cliquez sur Exécuter ce module uniquement > entrez l'ID de contact de votre Bitrix24 CRM > cliquez sur OK. Pour trouver l'ID de contact dans Bitrix24 CRM, ouvrez la liste des contacts, sélectionnez n'importe quel contact (de préférence un contact de test) et notez l'URL de la page sur laquelle vous atterrissez. Par exemple, si l'URL est https://XXXX.bitrix24.com/crm/contact/details/17/, l'ID de contact est 17. Après avoir exécuté le module, vérifiez la page de contact dans Bitrix24 CRM pour confirmer que la nouvelle tâche a été créée.

5. Ajouter un nouveau module Faire un appel API: Le but de cette étape est d'ajouter les messages WhatsApp reçus en tant que commentaires à la tâche Bitrix24 CRM que vous avez créée plus tôt dans le flux. Pour ajouter le module : survolez le dernier module Appel API: créer une tâche et cliquez sur + pour ajouter un nouveau module. Recherchez et sélectionnez Bitrix24 > sélectionnez Faire un appel API

6. Configurez le nouveau module Faire un appel API:

• Connexion: Cliquez sur le bouton Ajouter et entrez votre URL Bitrix24 > cliquez sur Enregistrer
• URL: task.commentitem.add
• Méthode: POST
• En-têtes: ajouter un nouvel en-tête avec clé = Content-Type et valeur= application/json
• Body: ajouter

[YOUR_TASKID_HERE, {
"POST_MESSAGE": "YOUR_TIME_HERE message received: YOUR_MESSAGE_TEXT"
}
]

• YOUR_TASKID_HERE doit être remplacé par les données de sortie de votre propre module Appel API: créer une tâche.
• YOUR_TIME_HERE et YOUR_MESSAGE_TEXT doivent être remplacés par les données de sortie du module Webhook d'origine. Vous pouvez inclure des données supplémentaires dans le champ POST_MESSAGE à partir de votre Webhook si nécessaire.

7. Enregistrez vos modifications. Cliquez avec le bouton droit sur le module nouvellement créé et renommez-le en Appel API: ajouter le message WA en tant que commentaire à la tâche. Il est important de nommer correctement les modules pour éviter toute confusion lors de l'ajout de modules Faire un appel API supplémentaires

8. Cliquez avec le bouton droit sur le module et cliquez sur Exécuter ce module uniquement > entrez des nombres aléatoires dans le champ “Timestamp” > entrez l'ID de tâche de test de votre Bitrix24 CRM > cliquez sur OK. Pour trouver l'ID de tâche dans Bitrix24 CRM, ouvrez n'importe quelle tâche (de préférence une tâche de test). Vous pouvez trouver la tâche créée dans Bitrix24 CRM lorsque vous exécutez les modules antérieurs et l'utiliser pour les tests. Notez l'URL de la page sur laquelle vous atterrissez. Par exemple, si l'URL est https://XXX.bitrix24.com/company/personal/user/1/tasks/task/view/35/XXXX , 35 sera l'ID de tâche. Entrez le texte aléatoire. En mode production, le message WhatsApp reçu deviendra le texte. Après avoir exécuté le module, vérifiez la page de tâche dans Bitrix24 CRM pour confirmer que le commentaire a été ajouté à la tâche:

Résultat intermédiaire: Le webhook surveille les messages WhatsApp entrants > recherche dans Bitrix24 CRM par numéro de téléphone > si le contact n'est pas trouvé > crée un nouveau contact > crée une tâche spéciale et la lie au contact > ajoute les messages WhatsApp reçus en tant que commentaires à la tâche.

Jusqu'à présent, nous avons travaillé dans une branche où le contact N'EXISTAIT PAS dans Bitrix24 CRM et nous avions besoin de le créer, puis de créer une tâche et d'ajouter des messages WhatsApp en tant que commentaires à cette tâche. Dans cette section, nous allons travailler sur une nouvelle branche du flux où le contact existe déjà et nous avons juste besoin d'ajouter une tâche et des commentaires.

1. Ajouter un nouveau filtre. Cliquez sur l'icône de clé à molette entre le Routeur et le module vide suivant > puis cliquez sur Configurer un filtre (https://storage.crisp.chat/users/helpdesk/website/94268256ba492800/screen-shot-2024-01-16-at-1754_o6wobi.png)

• Nommez votre filtre Le contact existe
• Condition: cliquez sur le champ. Une nouvelle boîte apparaîtra à droite avec les données disponibles du module Rechercher des contacts. Trouvez Nombre total de paquets >. Vous pouvez cliquer sur la valeur trouvée OU la faire glisser dans le champ vide
• Opérateurs numériques: sélectionnez supérieur ou égal à et tapez 1 dans le champ suivant

2. Ajouter un nouveau module Faire un appel API: Le but de cette étape est de déterminer si le contact existant a une tâche où les messages WhatsApp sont stockés ou non. Pour ajouter un module, cliquez sur le signe + après le dernier filtre créé > recherchez et sélectionnez Bitrix24 > sélectionnez Faire un appel API

3. Configurez le nouveau module Faire un appel API:

• Connexion: Cliquez sur le bouton Ajouter et entrez votre URL Bitrix24 > cliquez sur Enregistrer
• URL: tasks.task.list.json?order[CREATED_DATE]=desc&filter[UF_CRM_TASK]=C_YOUR_CONTACT_ID_HERE&[TITLE]=TimelinesAI_WhatsApp_Messages
• Méthode: GET
• En-têtes: ajouter un nouvel en-tête avec clé = Content-Type et valeur= application/json
• Body: vide
• YOUR_CONTACT_ID_HERE doit être remplacé par les données de sortie de votre propre module Rechercher des contacts.

4. Enregistrez vos modifications. Cliquez avec le bouton droit sur le module nouvellement créé et renommez-le en Appel API: rechercher des tâches. Il est important de nommer correctement les modules pour éviter toute confusion lors de l'ajout de modules Faire un appel API supplémentaires.

5. Cliquez avec le bouton droit sur le module et cliquez sur Exécuter ce module uniquement > entrez l'ID de contact de votre Bitrix24 CRM > cliquez sur OK. Pour trouver l'ID de contact dans Bitrix24 CRM, ouvrez la liste des contacts, sélectionnez n'importe quel contact (de préférence un contact de test) et notez l'URL de la page sur laquelle vous atterrissez. Par exemple, si l'URL est https://XXXX.bitrix24.com/crm/contact/details/17/, l'ID de contact est 17.

6. Ajouter un nouveau module Routeur de contrôle de flux: Le but de cette étape est de diviser le flux en 2 branches supplémentaires: 1- si le module de recherche de tâches a trouvé la tâche, 2- si le module de recherche n'a pas trouvé la tâche. Pour ajouter le module Routeur cliquez sur l'icône + à côté du module existant Appel API: rechercher des tâches > recherchez et sélectionnez Contrôle de flux > sélectionnez Routeur.

7. Ajouter un filtre: cliquez sur l'icône de clé à molette entre le Routeur et le module vide suivant > puis cliquez sur Configurer un filtre!

• Nommez votre filtre Si la tâche existe
• Condition: cliquez sur le champ. Une nouvelle boîte apparaîtra à droite avec les données disponibles du module Appel API: rechercher des tâches. Trouvez Body > Total >. Vous pouvez cliquer sur la valeur trouvée OU la faire glisser dans le champ vide
• Opérateurs numériques: sélectionnez égal à et tapez 1 dans le champ suivant:

8. Ajouter un nouveau module Faire un appel API: Le but de cette étape est d'ajouter les messages WhatsApp reçus en tant que commentaires à la tâche Bitrix24 CRM trouvée. Pour ajouter ce module, cliquez sur l'icône + à côté du filtre existant “Si la tâche existe” > recherchez et sélectionnez Bitrix24 > sélectionnez Faire un appel API

9. Configurez le nouveau module Faire un appel API:

• Connexion: Cliquez sur le bouton Ajouter et entrez votre URL Bitrix24 > cliquez sur Enregistrer
• URL: task.commentitem.add
• Méthode: POST
• En-têtes: ajouter un nouvel en-tête avec clé = Content-Type et valeur= application/json
• Body: ajouter

[YOUR_TASKID_HERE, {
"POST_MESSAGE": "YOUR_TIME_HERE message received: YOUR_MESSAGE_TEXT"
}
]

• YOUR_TASKID_HERE doit être remplacé par les données de sortie de votre module Appel API: rechercher des tâches .
• YOUR_TIME_HERE et YOUR_MESSAGE_TEXT doivent être remplacés par les données de sortie du module Webhook d'origine. Vous pouvez inclure des données supplémentaires dans le champ POST_MESSAGE à partir de votre Webhook si nécessaire.

10. Cliquez avec le bouton droit sur le module nouvellement créé et renommez-le en “Appel API: ajouter le message WA en tant que commentaire à la tâche”

11. Enregistrez vos modifications et ajouter un 2e filtre:

• Nommez votre filtre Si la tâche n'existe pas
• Condition: cliquez sur le champ. Une nouvelle boîte apparaîtra à droite avec les données disponibles du module Appel API: rechercher des tâches. Trouvez Body > Total >. Vous pouvez cliquer sur la valeur trouvée OU la faire glisser dans le champ vide
• Opérateurs numériques: sélectionnez inférieur à et tapez 1 dans le champ suivant:

11. Ajouter un nouveau module Faire un appel API: Le but de ce module est de créer une tâche dans Bitrix24 CRM et de lier la tâche au contact Bitrix24 CRM existant. Pour ajouter ce module, cliquez sur l'icône + à côté du filtre existant “Si la tâche n'existe pas” > recherchez et sélectionnez Bitrix24 > sélectionnez Faire un appel API

12. Configurez le nouveau module Faire un appel API:

• Connexion: Cliquez sur le bouton Ajouter et entrez votre URL Bitrix24 > cliquez sur Enregistrer
• URL: tasks.task.add
• Méthode: POST
• En-têtes: ajouter un nouvel en-tête avec clé = Content-Type et valeur= application/json
• Body: ajouter

{ "fields": {
"TITLE": "TimelinesAI_WhatsApp_messages",
"UF_CRM_TASK": ["C_YOUR_ID_HERE],
"ADD_IN_REPORT": "N",
"STATUS":"5",
"RESPONSIBLE_ID": "1"