Gestion de l'installation et de l'exécution du widget de tâche Bitrix24 - Workflow n8n

Développeurs d'applications Bitrix24 nécessitant un backend fiable pour la gestion des installations et des jetons.
Utilisateurs recherchant des modèles n8n robustes pour des interactions webhook complexes.
Spécialistes de l'automatisation déployant des widgets personnalisés dans des environnements CRM.
Ingénieurs cherchant une solution auto-hébergée pour la gestion de l'API Bitrix24.

Le développement d'applications personnalisées pour des plateformes telles que Bitrix24 exige une gestion complexe des jetons OAuth, des rappels d'installation et de la diffusion de contenu dynamique. Ce puissant flux de travail n8n résout ces défis en agissant comme gestionnaire central pour tous les événements Bitrix24 liés à votre application de widget personnalisée. La valeur principale de ce modèle n8n réside dans sa capacité à gérer de manière transparente l'accord d'installation — en sauvegardant les jetons d'accès critiques sur le disque — puis à utiliser ces identifiants stockés lors de l'exécution pour récupérer et afficher des informations contextuelles (comme les détails d'une tâche) dans un onglet de vue de tâche Bitrix
24.

Chaque fois que Bitrix24 envoie une requête (que ce soit pour l'installation ou l'affichage du widget), cette configuration spécifique de nœuds n8n assure une authentification sécurisée et des réponses immédiates et adaptées, démontrant l'efficacité d'un flux de travail n8n bien conçu.

L'ensemble du processus commence par le déclencheur n8n désigné, le nœud Webhook, qui écoute les requêtes POST provenant de Bitrix
24.

1. Déclenchement et Initialisation : Le déclencheur n8n Gestionnaire Bitrix24 reçoit l'événement. Le nœud n8n Extraction des identifiants analyse immédiatement la charge utile JSON entrante pour récupérer le domaine, les jetons d'accès et les jetons de rafraîchissement.


2. Détermination de l'événement : Le nœud Code n8n Vérifier le type d'événement analyse la requête pour distinguer un événement d'installation d'application (ONAPPINSTALL) d'une demande de placement de widget (par exemple, lors de la consultation d'une tâche).


3. Volet Installation : S'il s'agit d'une installation, le flux se divise. Si l'installation n'est pas terminée, le système utilise le nœud n8n Définir les données de configuration pour formater les jetons, les convertit en fichier JSON (Créer le fichier de configuration) et enregistre la configuration à l'aide du nœud n8n Enregistrer les paramètres d'installation (Lecture/Écriture de fichier). Il enregistre ensuite le placement du widget (Enregistrer le placement via le nœud Requête HTTP) et termine le processus avec la réponse webhook Réponse d'installation.


4. Volet Exécution (Affichage du widget) : Si l'événement est une requête d'exécution, le système récupère les données d'authentification précédemment enregistrées à l'aide des nœuds n8n Lire les paramètres d'installation et Extraire les paramètres d'installation. Le nœud Fusionner les données de requête avec les paramètres d'installation prépare le contexte de données nécessaire.


5. Traitement et Récupération des données : Le nœud Fonction Traiter les paramètres extrait les informations spécifiques au contexte, telles que le taskId. Le nœud Si Paramètres valides ? valide les identifiants. Si c'est valide, le nœud Requête HTTP n8n Obtenir les données de la tâche utilise le jeton d'accès Bitrix24 enregistré pour interroger l'API Bitrix24 afin d'obtenir les détails de la tâche.


6. Génération de la réponse : Le nœud Fonction Formater les données de la tâche convertit les données brutes de la tâche en HTML structuré. Enfin, le nœud n8n Réponse de vue de tâche renvoie ce HTML à Bitrix24, qui l'affiche dans le widget de tâche personnalisé. Si les paramètres n'étaient pas valides, une Réponse d'erreur est renvoyée à la place. Cette logique complexe démontre une utilisation puissante d'un flux de travail n8n.

Pour déployer ce flux de travail n8n complet, suivez ces étapes :

1. Importer le flux de travail n8n : Copiez les données JSON fournies. Dans votre instance n8n, accédez à 'Flux de travail' et cliquez sur 'Nouveau'. Sélectionnez 'Importer depuis JSON' et collez le code.


2. Configurer le déclencheur Webhook : Localisez le nœud de déclenchement n8n Gestionnaire Bitrix24. Le chemin est défini sur bitrix24/widgethandler.php. Activez le flux de travail pour générer l'URL webhook complète. Cette URL doit être enregistrée dans les paramètres de votre application Bitrix24 comme URL du gestionnaire pour les événements d'installation et de placement.


3. Définir les identifiants de substitution : Le nœud n8n Extraction des identifiants contient des valeurs de substitution codées en dur (par exemple, local.67b8a796e92127.82791242). Celles-ci sont généralement remplacées par les données actives de Bitrix24 lors du webhook d'installation, mais vous devrez peut-être les ajuster si votre application utilise des Client ID/Secrets statiques différents. Assurez-vous que votre application Bitrix24 est correctement configurée pour envoyer ces jetons initiaux.


4. Accès au système de fichiers : Le flux de travail utilise le nœud n8n ReadWriteFile pour sauvegarder et lire les jetons d'authentification Bitrix24. Assurez-vous que votre environnement d'hébergement n8n dispose des autorisations nécessaires pour accéder au chemin /data/files/hotline_files/ (ou ajustez la variable settingsFilePath dans le nœud Extraction des identifiants vers un emplacement accessible par votre instance n8n).


5. Activer : Enregistrez et activez le flux de travail n8n. L'automatisation écoutera désormais les événements Bitrix24.

Gestionnaire Bitrix24 (déclencheur Webhook n8n) : Point d'entrée du flux de travail n8n. Il est configuré pour écouter les requêtes POST sur un chemin spécifique, initiant la séquence d'opérations pour les demandes d'installation et de vue de tâche.
Extraction des identifiants (Nœud Set n8n) : Essentiel pour la sécurité, ce nœud extrait les paramètres d'authentification dynamiques (comme accesstoken et refreshtoken) envoyés par Bitrix24, les préparant pour une utilisation dans les requêtes HTTP ultérieures et pour le stockage.
Vérifier le type d'événement (Nœud Code n8n) : Un nœud de script personnalisé qui analyse le corps de la requête entrante pour différencier les rappels d'installation d'application des événements de placement de widget, fournissant une logique de contrôle de flux cruciale pour le flux de travail n8n.
Est-ce une installation ? (Nœud If n8n) : Un nœud n8n de logique centrale qui dirige le flux en fonction de si la requête actuelle fait partie du processus d'installation de l'application (isInstallation: true).
Définir les données de configuration & Enregistrer les paramètres d'installation (Nœuds Set & ReadWriteFile n8n) : Ces nœuds collaborent dans le modèle n8n pour sérialiser les jetons Bitrix24 nouvellement reçus (y compris l'expiration et le domaine) et les écrire de manière sécurisée dans un fichier JSON sur le système de fichiers local, garantissant la persistance pour une utilisation ultérieure lors de l'exécution.
Enregistrer le placement (Nœud Requête HTTP n8n) : Exécute un appel API Bitrix24 pour lier l'URL du widget personnalisé au placement souhaité, spécifiquement TASKVIEWTAB, assurant que l'URL du webhook n8n est correctement intégrée dans l'interface Bitrix24.
Lire les paramètres d'installation & Traiter les paramètres (Nœuds ReadWriteFile & Function n8n) : Lors de l'accès d'exécution, ces nœuds récupèrent et traitent les jetons stockés, garantissant que le flux de travail n8n dispose des identifiants et du contexte nécessaires (comme le taskId spécifique) pour procéder aux recherches API.
Obtenir les données de la tâche (Nœud Requête HTTP n8n) : Utilise les jetons d'accès validés pour effectuer un appel authentifié à l'API Bitrix24 (tasks.task.get), récupérant les détails nécessaires à l'affichage du widget. C'est une étape critique dans la phase d'exécution de ce flux de travail n8n.

• Réponse de vue de tâche (Nœud RespondToWebhook n8n) : L'action finale pour les requêtes d'exécution. Il emballe le HTML généré par le nœud Fonction précédent et le renvoie immédiatement à Bitrix24, qui affiche le contenu du widget personnalisé.