1. Les Webhooks : La solution simple et puissante
Pour connecter CrocoClick à d’autres services, rien n’est plus simple que d’utiliser les webhooks dans la section Automatisations. Grâce aux webhooks, vous pouvez :
Connecter et automatiser pratiquement n’importe quel service externe,
Réagir à des événements en temps réel,
Simplifier l’intégration sans avoir besoin de développer des connecteurs complexes.
💡ASTUCE : Si vous souhaitez en savoir plus sur cette approche, cliquez ici pour consulte l’article détaillé sur l’utilisation des webhooks
2. Intégrations privées : Une solution personnalisée et sécurisée
Les intégrations privées vous permettent de construire des connexions personnalisées entre votre compte CrocoClick et n’importe quelle application tierce.
Cette approche est idéale si vous souhaitez aller plus loin qu’une simple automatisation via webhooks et créer des échanges de données sophistiqués.
Qu'est-ce que les intégrations privées ?
Les intégrations privées offrent une solution sur-mesure pour :
Générer des tokens d’intégration directement depuis votre interface,
Restreindre précisément les permissions accordées à des développeurs ou des applications tierces,
Bénéficier d’un accès aux API de CrocoClick (version 2.0) qui offrent des fonctionnalités avancées et la prise en charge des webhooks.
Intégrations privées vs Clés API
Intégrations privées :
Sécurisées : Vous définissez des permissions spécifiques.
Modernes : Utilisent l’API v2.0 et supportent les webhooks.
Fonctionnalités étendues : Permettent une gestion fine de l’accès.
Clés API :
Moins sécurisées : Accès complet à l’ensemble des données.
Obsolètes : Fonctionnent sur une version d’API (v1.0) qui n’est plus maintenue.
Intégrations privées vs Tokens OAuth2
Les intégrations privées se distinguent également des tokens OAuth2 de la manière suivante :
Intégrations privées :
Générées directement depuis l’interface.
Tokens statiques qui ne se renouvellent pas automatiquement.
Tokens OAuth2 :
Générés de manière programmatique via un échange de code.
Expirent quotidiennement et nécessitent un rafraîchissement régulier.
Comment utiliser les intégrations privées ?
Pour utiliser une intégration privée, il vous suffit d’ajouter le token généré dans l’en-tête d’autorisation de vos requêtes API.
Par exemple, pour récupérer un contact, vous pouvez effectuer une requête GET :
bashCopier le codecurl --request GET \ --url https://services.leadconnectorhq.com/contacts/IDENTIFIANT_DU_CONTACT \ --header 'Accept: application/json' \ --header 'Authorization: <VOTRE TOKEN D\'INTÉGRATION PRIVÉE>' \ --header 'Version: 2021-07-28'
Qui peut créer des intégrations privées ?
Par défaut, tous les administrateurs de compte ont la possibilité de créer et gérer des intégrations privées.
Toutefois, il est possible de restreindre ce droit au niveau de l’utilisateur en modifiant les permissions dans Paramètres > Mon Equipe.
Où trouver et créer vos intégrations privées ?
Pour gérer vos intégrations privées, rendez-vous dans la section Settings et recherchez la rubrique Autres paramètres.
Si la fonctionnalité n’apparaît pas, vérifiez qu’elle est bien activée dans la section Labs.
Pour créer une nouvelle intégration privée :
Cliquez sur Créer une nouvelle intégration.
Donnez-lui un nom et une description pour faciliter son identification.
Sélectionnez les scopes/permissions nécessaires.
Copiez le token généré et partagez-le uniquement avec des parties de confiance.
Bonnes pratiques pour sécuriser votre token
Pour garantir la sécurité de vos données, nous recommandons de :
Changer vos tokens tous les 90 jours.
Ne partager le token qu’avec des développeurs ou partenaires de confiance.
Veiller à ce que les permissions accordées soient strictement nécessaires.
En cas de compromission de votre token
Si vous suspectez une compromission de votre token :
Rendez-vous dans Private Integrations via les Settings.
Sélectionnez l’intégration concernée et choisissez l’option Changer et rendre obsolète ce token maintenant.
Suivez les instructions pour générer un nouveau token et mettez à jour vos applications tierces.
Modification des permissions sans changer le token
Il est possible de modifier le nom, la description et même les permissions d’une intégration privée sans pour autant régénérer le token. Pour ce faire, :
Accédez à l’option Modifier via le menu à trois points de l’intégration.
Mettez à jour les informations nécessaires puis validez les modifications.
Suppression d'une intégration privée
Lorsque l’intégration n’est plus nécessaire :
Accédez à Private Integrations dans les Settings.
Sélectionnez l’option Supprimer dans le menu à trois points pour supprimer définitivement l’intégration.
Pour plus de détails techniques sur la création et la gestion des intégrations privées, vous pouvez consulter la documentation officielle de l’API CrocoClick : Documentation API - Intégrations privées.
Conclusion
L’utilisation des webhooks via la partie automatisations de CrocoClick représente la solution la plus simple et puissante pour connecter vos outils externes.
Toutefois, pour des intégrations plus complexes ou nécessitant une personnalisation avancée, les intégrations privées offrent une alternative robuste et sécurisée.
En combinant ces deux approches, vous optimiserez la connectivité et l’automatisation de vos processus, tout en garantissant une sécurité optimale de vos données.