La section Ressources pour les développeurs regroupe les outils qui permettent d’étendre les fonctionnalités de Bitrix24. Vous pouvez :
- configurer l’accès à la création d’intégrations ;
- créer un webhook ;
- créer une application ;
- consulter tous les webhooks et applications créés ;
- consulter les statistiques des requêtes par les webhooks et applications.
Plans tarifaires
Configurer l’accès à la création d’intégrations
Par défaut, seul l’administrateur Bitrix24 peut créer des applications accessibles à tous les utilisateurs. Tous les utilisateurs peuvent créer des webhooks entrants et leurs propres applications.
L’administrateur Bitrix24 peut modifier ces paramètres.
Par défaut, Alaio Vibecode est la source des droits. Tous les utilisateurs peuvent donc créer des webhooks et des applications.
Pour appliquer les restrictions définies dans Bitrix24, désactivez l’option Source des droits : serveur Vibecode dans la section Connecteur Vibecode.
Configurer le connecteur Vibecode
- Cliquez sur l’icône des paramètres à droite du nom ou du logo de votre Bitrix24.
- Accédez à Paramètres (⚙️).
- Dans l’onglet Sécurité, développez la section Intégrations Bitrix24.
- Cliquez sur + Ajouter dans chaque champ pour sélectionner les employés autorisés à créer :
- des webhooks entrants ;
- des applications pour tous les utilisateurs ;
- leurs propres applications.
- Enregistrez les modifications.
Créer un webhook
L’onglet Cas d’utilisation courants propose des exemples de scripts pour créer rapidement des webhooks. Vous pouvez, par exemple, créer un chatbot pour informer les employés ou ajouter un script commercial à un formulaire d’appel.
Si aucun scénario ne correspond à votre besoin, créez votre propre webhook.
Sélectionnez un scénario, puis ouvrez les paramètres.
Webhook pour appeler l'API REST. Le code secret du webhook est généré automatiquement. Seul le créateur du webhook peut le consulter.
Si un administrateur Bitrix24 modifie le webhook d’un autre utilisateur, le code secret est renouvelé et l’administrateur devient propriétaire du webhook.
Générateur de requêtes REST. Utilisez ce générateur pour sélectionner les méthodes et les paramètres nécessaires. Vous pouvez consulter leur description et télécharger un exemple de requête en PHP.
URL. L’URL est générée automatiquement à partir des méthodes et paramètres sélectionnés. Vous pouvez l’utiliser dans des systèmes externes pour envoyer des requêtes.
L’URL contient plusieurs éléments :
********24.bitrix24.fr: adresse de votre Bitrix24./rest: indique que la requête utilise l’API REST avec un webhook./4: identifiant de l’utilisateur qui a créé le webhook./2x************: code secret permettant d’afficher, de modifier et de supprimer des données dans Bitrix24./crm.lead.update: méthode de l’API REST appelée..json: format utilisé par défaut pour les nouveaux webhooks.?ID=42: paramètres nécessaires pour une méthode spécifique. Les paramètres suivent le point d’interrogation et sont séparés par le symbole&.
Exemple d'exécution de la méthode de mise à jour
Prenons l’exemple des méthodes de mise à jour crm.***.update.
Pour les méthodes CRM, y compris celles des processus intelligents, le principe est le même : indiquez l’identifiant de l’élément dans la méthode, puis transmettez les valeurs à modifier dans le tableau fields.
Exemple lors de l'exécution de la méthode de mise à jour dans la barre d'adresse du navigateur : crm.***.update.json?id=1&fields[TITLE]=Test%20entité&fields[ASSIGNED_BY_ID]=1&fields[UF_CRM_1234567890]=TEST.
Exemple d’exécution dans la barre d’adresse du navigateur : crm.***.update.json?id=1&fields[TITLE]=Test%20entité&fields[ASSIGNED_BY_ID]=1&fields[UF_CRM_1234567890]=TEST
La structure générale d’une requête API REST est la suivante : [méthode].json?[paramètres].
Si vous transmettez un tableau, utilisez le format : fields[[champ]].
Les paramètres peuvent varier selon la méthode utilisée. Consultez la documentation de chaque méthode avant de créer une requête.
Pour tester la requête, cliquez sur Exécuter et consultez le résultat.
Configuration des droits d'accès. Vous pouvez limiter l’exécution des requêtes à certains outils Bitrix24. Par exemple, le script Importer des clients pourra fonctionner uniquement avec le CRM.
Créer une application locale
Les applications locales sont des applications créées pour votre Bitrix24.
Accédez à l'onglet Cas d'utilisation courants > Autre > Application locale.
Consulter les webhooks et les applications créés
Accédez à l'onglet Intégrations. Vous y trouverez :
- le nom des webhooks et des applications ;
- les événements associés ;
- les outils auxquels ils ont accès ;
- l’utilisateur qui les a créés.
Pour personnaliser l’affichage de la liste des webhooks, cliquez sur Paramètres (⚙️) et sélectionnez les champs nécessaires.
Pour modifier ou supprimer un webhook ou une application, cliquez sur Menu (≡).
Consulter les statistiques des applications et des webhooks
Ouvrez l'onglet Statistics pour voir le nombre de requêtes envoyées par chaque webhook et application. Cet outil vous aide à évaluer la charge des requêtes REST dans Bitrix24.
Pour les développeurs : comment vérifier la charge REST dans Bitrix24
Pour afficher les statistiques d’un webhook ou d’une application spécifique, utilisez le champ Filtre. Vous pouvez consulter les données sur une période maximale de 14 jours.
Pour personnaliser l’affichage des statistiques, cliquez sur Paramètres (⚙️) et sélectionnez les champs nécessaires.
Résumé
- La section Ressources pour les développeurs regroupe les outils qui permettent d’étendre les fonctionnalités de Bitrix24 avec des webhooks et l’API REST.
- Utilisez les scénarios prêts à l’emploi pour créer rapidement des webhooks. Si aucun scénario ne correspond à votre besoin, créez votre propre webhook.
- Par défaut, seul l’administrateur Bitrix24 peut créer des applications accessibles à tous les utilisateurs. Tous les utilisateurs peuvent créer des webhooks entrants et leurs propres applications.
- Le connecteur Vibecode gère également les droits de création des applications et des webhooks. Lorsque l’option Source des droits : serveur Vibecode est activée, les droits définis dans Alaio Vibecode s’appliquent.
- Retrouvez tous les webhooks et applications créés dans l’onglet Intégrations.
- Consultez les statistiques des requêtes envoyées par les webhooks et les applications dans l’onglet Statistiques.
