Dans le contexte commercial actuel, les entreprises utilisent souvent plusieurs systèmes logiciels différents, chacun ayant des objectifs spécifiques. Il peut s'agir de logiciels de gestion des ventes, de systèmes comptables, d'outils marketing ou d'applications internes développées sur mesure. Chacun de ces systèmes contient des données précieuses et joue un rôle crucial dans les opérations commerciales.

Le principal défi n'est pas le manque de données, mais plutôt leur dispersion sur de multiples plateformes. Les employés doivent jongler entre les systèmes, saisir manuellement les mêmes informations à plusieurs reprises et n'ont pas une vision globale du client. Cela engendre non seulement une perte de temps, mais augmente également le risque d'erreurs et de pertes d'opportunités commerciales.

La plateforme d'intégration et l'API de GTG CRM sont conçues pour répondre à ce besoin fondamental. Au lieu d'obliger les entreprises à remplacer l'intégralité de leurs systèmes existants, cette solution crée un pont entre ces systèmes. Les données circulent librement entre les plateformes, les processus sont automatisés et, surtout, des agents d'IA peuvent participer au traitement pour améliorer l'efficacité opérationnelle.

Ce document fournira des instructions détaillées, étape par étape, permettant aux entreprises de mettre en œuvre avec succès l'intégration, depuis la création d'applications et la configuration des autorisations d'accès, jusqu'à l'utilisation des API pour lire et écrire des données, la mise en place de webhooks pour recevoir des événements automatisés et, enfin, la combinaison avec des agents d'IA pour créer des flux de travail de traitement intelligents entièrement automatisés.

Aperçu des principales fonctionnalités

La plateforme d'intégration et l'API offrent un ensemble complet d'outils permettant aux entreprises de connecter GTG CRM à n'importe quelle application via le protocole API REST standard. Le système de gestion des jetons API, grâce à son mécanisme d'autorisation détaillé basé sur les périmètres d'accès, garantit une sécurité élevée et permet un contrôle précis des droits d'accès pour chaque application intégrée.

L'intégration d'agents IA est un atout majeur, permettant aux entreprises d'exploiter l'intelligence artificielle pour automatiser le traitement des données et réaliser des tâches complexes sans programmation. Elles peuvent ainsi gérer plusieurs agents IA aux rôles variés, chacun étant formé pour un usage spécifique.

La synchronisation bidirectionnelle des données entre GTG CRM et les systèmes externes garantit aux entreprises une vision cohérente des informations clients. Une documentation API complète, incluant des exemples de commandes curl, facilite l'intégration et le débogage pour les développeurs. Les entreprises peuvent ainsi interroger les listes de contacts, les tâches et les transactions, et mettre à jour les informations en temps réel.

Les webhooks permettent la récupération automatique de données provenant de systèmes externes sans interrogation continue. Associés à l'automatisation et aux agents d'IA, ils permettent aux entreprises de créer des flux de traitement d'événements entièrement automatisés. L'outil de création de sites web intégré à l'écosystème permet de créer directement un site web depuis GTG CRM, avec des fonctionnalités SEO complètes et des plans de site automatisés.

Guide d'utilisation étape par étape

Étape 1 : Créer une application d’intégration

Pour commencer l'intégration, la première étape consiste à créer une nouvelle application dans GTG CRM. Accédez au menu « Intégration et API » et cliquez sur le bouton « Créer une application ». Donnez à l'application un nom explicite pour faciliter sa gestion ultérieure, par exemple « Intégration du système de vente » ou « Application mobile ». Une fois le nom saisi, cliquez sur « Créer » pour terminer.

Étape 2 : Configurer les autorisations d’accès

Les autorisations basées sur le périmètre d'accès permettent un contrôle précis des actions qu'une application peut effectuer sur les données CRM. Après avoir créé l'application, sélectionnez-la et accédez à l'onglet « Autorisations d'accès » ou « Périmètre d'accès ». Vous y trouverez la liste des autorisations pouvant être accordées.

Si l'application a uniquement besoin de lire les informations de contact, sélectionnez l'autorisation « contacts.read ». Si elle doit créer et mettre à jour des contacts, ajoutez l'autorisation « contacts.write ». Pour permettre à l'application de lire les informations relatives aux agents IA du système, accordez l'autorisation « agents.read ». Si vous souhaitez que l'application puisse demander aux agents IA d'effectuer des tâches, accordez l'autorisation « agents.execute ». Après avoir sélectionné les autorisations nécessaires, cliquez sur Enregistrer pour mettre à jour la configuration.

Étape 3 : Créer un jeton d’API

Un jeton est une clé d'authentification permettant aux applications externes d'appeler l'API de GTG CRM en toute sécurité. Sur la page de détails de l'application, repérez la section « Jeton API » et cliquez sur « Générer un jeton ». Le jeton, qui commence par « gtg_ », s'affichera une seule fois. Copiez-le et conservez-le immédiatement en lieu sûr. Ce jeton devrai être utilisé dans l'en-tête Authorization de chaque requête API.

Remarque importante : si vous ajoutez de nouvelles autorisations à l’application après la création du jeton, ce dernier ne bénéficiera pas automatiquement de ces nouvelles autorisations. Vous devrez créer un nouveau jeton pour disposer de tous les droits d’accès configurés.

Étape 4 : Vérifier la connexion API

Une fois le jeton obtenu, l'étape suivante consiste à vérifier que l'intégration fonctionne correctement. Le moyen le plus simple est d'utiliser la commande curl depuis le terminal. L'exemple ci-dessous illustre comment récupérer une liste de contacts depuis GTG CRM.

 curl -X GET https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_API_TOKEN" Si la connexion réussit et que le jeton dispose des autorisations suffisantes, vous recevrez une réponse JSON contenant une liste de contacts avec des informations complètes telles que l'identifiant, le nom, l'adresse électronique, le numéro de téléphone et d'autres champs de données. curl -X GET https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_API_TOKEN"

 { "data": [ { "id": "contact_123", "name": "Nguyễn Văn A", "email": "nguyenvana@example.com", "phone": "0901234567" } ] } Étape 5 : Intégrez-le à votre système { "data": [ { "id": "contact_123", "name": "Nguyễn Văn A", "email": "nguyenvana@example.com", "phone": "0901234567" } ] } 

Après des tests concluants, vous pouvez intégrer l'API à votre application. Voici un exemple utilisant Node.js, l'un des langages les plus populaires pour le développement backend. Cet extrait de code illustre comment récupérer une liste de contacts et créer un nouveau contact dans GTG CRM.

 const axios = require('axios'); const API_URL = 'https://api.gtgcrm.com/v1/integration'; const API_TOKEN = 'your_api_token_here'; async function getContacts() { const response = await axios.get(`${API_URL}/contacts`, { headers: { 'Authorization': `Bearer ${API_TOKEN}` } }); return response.data; } async function createContact(contactData) { const response = await axios.post(`${API_URL}/contacts`, contactData, { headers: { 'Authorization': `Bearer ${API_TOKEN}`, 'Content-Type': 'application/json' } }); return response.data; } De même, vous pouvez utiliser n'importe quel autre langage de programmation, comme Python, PHP, Java ou C#, pour l'intégration. Le principe général consiste à toujours envoyer le jeton dans l'en-tête Authorization au format « Bearer VOTRE_JETON » et à utiliser le type de contenu « application/json » pour les requêtes POST ou PUT. const axios = require('axios'); const API_URL = 'https://api.gtgcrm.com/v1/integration'; const API_TOKEN = 'your_api_token_here'; async function getContacts() { const response = await axios.get(`${API_URL}/contacts`, { headers: { 'Authorization': `Bearer ${API_TOKEN}` } }); return response.data; } async function createContact(contactData) { const response = await axios.post(`${API_URL}/contacts`, contactData, { headers: { 'Authorization': `Bearer ${API_TOKEN}`, 'Content-Type': 'application/json' } }); return response.data; }

Étape 6 : Application des agents d'IA dans le processus proprement dit.

Pour bien comprendre la valeur d'Integration Hub, prenons un exemple concret. Lorsqu'un nouveau client s'inscrit sur le site web de vente d'une entreprise, au lieu que les employés créent manuellement un profil dans le CRM et envoient un e-mail de bienvenue, l'ensemble du processus peut être automatisé.

Le processus fonctionne comme suit : tout d’abord, le client remplit le formulaire d’inscription sur le site web de vente. Le système du site appelle immédiatement l’API CRM de GTG pour créer un nouveau contact avec toutes les informations client, telles que le nom, l’adresse e-mail, le numéro de téléphone et la source du client.

 curl -X POST https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Trần Thị B", "email": "tranthib@example.com", "phone": "0987654321", "source": "Website" }' Dès la création d'un contact dans GTG CRM, l'agent IA l'identifie automatiquement comme un nouveau client provenant du site web. L'agent analyse les informations client afin d'envoyer un e-mail de bienvenue personnalisé, et non un modèle générique. Simultanément, l'agent crée une tâche de suivi pour l'équipe commerciale, qui doit contacter le client dans les 24 heures pour lui proposer un entretien. curl -X POST https://api.gtgcrm.com/v1/integration/contacts \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Trần Thị B", "email": "tranthib@example.com", "phone": "0987654321", "source": "Website" }'

Les avantages de ce processus automatisé sont évidents. Les clients reçoivent un e-mail de bienvenue immédiatement après leur inscription, ce qui renforce leur professionnalisme et instaure un climat de confiance. L'absence de personnel manuel permet un gain de temps considérable et minimise les erreurs. Les e-mails sont personnalisés en fonction des informations client, et non basés sur un contenu générique. Les équipes commerciales sont informées et disposent de tâches de suivi précises, ce qui leur permet de ne manquer aucune opportunité. L'ensemble de ces facteurs contribue à augmenter le taux de conversion des prospects en clients.

Étape 7 : Configurer un webhook pour recevoir automatiquement les données.

Les webhooks sont une technologie qui permet aux systèmes externes d'envoyer proactivement des données à GTG CRM lorsqu'un événement se produit, au lieu d'interroger constamment le système. Pour commencer, rendez-vous sur la page « Intégrations et API », sélectionnez l'onglet « Webhooks », puis cliquez sur « Créer un webhook » et donnez-lui un nom explicite.

Une fois créé, le système fournira deux informations importantes : l’URL du webhook, point de terminaison auquel le système externe enverra des données via HTTP POST, et le secret de signature, code secret permettant de vérifier que la requête provient bien d’un système autorisé et non d’une source frauduleuse.

Il est essentiel de noter que le secret de signature n'est affiché qu'une seule fois lors de la création d'un webhook. Copiez-le et enregistrez-le immédiatement dans le système de gestion des secrets sécurisé de votre entreprise. En cas de perte de ce secret, vous devrez créer un nouveau webhook.

Pour vérifier le bon fonctionnement du webhook, envoyez une requête de test à l'aide de la commande curl. Cette requête doit comporter un en-tête Content-Type défini sur application/json et un en-tête X-Webhook-Signature contenant le secret de signature pour l'authentification.

 curl -X POST "YOUR_WEBHOOK_URL" \ -H "Content-Type: application/json" \ -H "X-Webhook-Signature: YOUR_SIGNING_SECRET" \ -d '{ "event": "order.completed", "eventId": "evt_123456", "data": { "orderId": "ORD-001", "customerName": "Nguyễn Văn A", "amount": 500000 } }' Si le webhook fonctionne correctement, cet événement apparaîtra dans la liste des événements reçus. curl -X POST "YOUR_WEBHOOK_URL" \ -H "Content-Type: application/json" \ -H "X-Webhook-Signature: YOUR_SIGNING_SECRET" \ -d '{ "event": "order.completed", "eventId": "evt_123456", "data": { "orderId": "ORD-001", "customerName": "Nguyễn Văn A", "amount": 500000 } }' 

Étape 8 : Combiner les webhooks avec l’automatisation et les agents d’IA

La véritable puissance d'Integration Hub n'est pleinement exploitée que lorsque les webhooks sont associés à des processus d'automatisation et à des agents d'IA. Cela permet aux entreprises de créer des processus intelligents qui réagissent automatiquement aux événements provenant de systèmes externes, sans intervention manuelle.

Pour configurer un processus, accédez au menu « Automatisation » dans GTG CRM et cliquez sur « Créer un nouveau processus ».

L'étape la plus importante consiste à configurer le déclencheur afin que le processus sache quand s'activer. Sélectionnez le module « Intégration externe », l'objet « Webhook » et l'action « Obtenir des données ». Ainsi, à chaque réception d'un événement provenant d'un système externe, le processus sera automatiquement déclenché.

Après avoir configuré le déclencheur, ajoutez la tâche « Agent IA » au flux de travail. Cliquez sur « Ajouter une tâche », sélectionnez le module « IA », puis « Tâche Agent IA ». C’est ici que vous saisirez les instructions à l’agent IA concernant le traitement des données reçues du webhook.

L'invite de l'agent IA permet aux entreprises de démontrer leur logique métier. Par exemple : « Lorsque l'événement order.completed est déclenché, créez une note de document enregistrant l'heure de réception de l'événement et les informations de la commande. Envoyez ensuite un e-mail de remerciement au client et notifiez l'équipe commerciale. »

Une fois la configuration terminée, passez le processus en mode « Actif ». Désormais, lorsqu'un système externe enverra un événement au webhook, l'agent IA exécutera automatiquement les tâches demandées.

Lorsqu'un événement est soumis, vous pouvez suivre sa progression dans l'historique d'exécution du processus. L'agent IA enregistre les résultats du traitement afin que l'entreprise puisse les vérifier et les auditer.

Ce document a été créé sur demande :

Étude de cas réelle : MM3.vn automatise le contenu marketing.

MM3, entreprise exploitant le site web mm3.vn, a utilisé Integration Hub et un agent IA pour automatiser intégralement son processus de création de contenu : collecte de données de marché, génération d’images par IA, rédaction analytique, publication sur le site web et les réseaux sociaux, et référencement naturel automatisé. Résultat : une réduction drastique du nombre de rédacteurs (de 2 à 3) à zéro, avec une production d’articles illimitée.

📖 Lire l'étude de cas détaillée sur MM3.vn →

Les principaux avantages de l'utilisation d'Integration Hub

Le gain de temps est l'avantage le plus direct et évident. L'automatisation de la synchronisation des données entre les systèmes élimine complètement la saisie manuelle, une tâche fastidieuse et source d'erreurs. Les employés peuvent ainsi se concentrer sur des tâches à plus forte valeur ajoutée plutôt que sur des tâches répétitives.

Tirer parti de l'infrastructure existante représente un avantage considérable pour les entreprises ayant investi dans des systèmes logiciels. Au lieu de remplacer l'ensemble de leur technologie, elles peuvent simplement connecter GTG CRM pour y intégrer des fonctionnalités d'IA et d'automatisation. Cela minimise les risques d'interruption d'activité et protège leur investissement technologique.

Optimisez votre efficacité commerciale grâce à des agents IA capables d'assurer un service client 24h/24 et 7j/7 sans interruption. Chaque opportunité est suivie et traitée rapidement, vous garantissant ainsi de ne manquer aucun prospect, même en cas d'indisponibilité de vos équipes ou de travail en dehors des heures normales.

La flexibilité et l'évolutivité sont des atouts majeurs de l'architecture API. Les entreprises peuvent facilement ajouter de nouvelles fonctionnalités ou se connecter à d'autres systèmes en fonction de l'évolution de leurs besoins. Libérées d'une plateforme rigide, elles peuvent s'adapter et évoluer à leur propre rythme.

Le contrôle de sécurité est assuré par un système de gestion des accès précis, basé sur le périmètre et les jetons. Les entreprises peuvent attribuer des autorisations spécifiques à chaque application intégrée, garantissant ainsi que les données sensibles ne soient accessibles qu'aux systèmes autorisés.

Les webhooks bidirectionnels étendent considérablement les capacités d'intégration par rapport aux solutions API traditionnelles. Les entreprises peuvent non seulement appeler les API de manière proactive en cas de besoin, mais aussi recevoir automatiquement des données provenant de systèmes externes en temps réel.

L'automatisation du contenu est une fonctionnalité unique de GTG CRM. En combinant les webhooks, l'automatisation et les agents d'IA, les entreprises peuvent générer automatiquement des articles, des images et des publications pour les réseaux sociaux à partir de données brutes. Ceci est particulièrement utile pour les entreprises des secteurs du contenu et du marketing.

Le référencement automatisé via un outil de création de site web intégré à un sitemap et à Google Search Console garantit que tout nouveau contenu est rapidement découvert et indexé par les moteurs de recherche, générant ainsi du trafic organique pour votre entreprise.

Considérations importantes lors de la mise en œuvre.

La sécurité des jetons est primordiale. Les jetons d'API donnent accès à des données critiques et ne doivent jamais être partagés avec des tiers ni intégrés au code source. Ils doivent être stockés dans des variables d'environnement ou un système de gestion des secrets dédié. En cas de suspicion de compromission d'un jeton, révoquez-le et créez-en un nouveau immédiatement.

Il est impératif de renouveler le jeton lors de toute modification des autorisations. À chaque ajout d'une nouvelle étendue à l'application, le jeton actuel ne sera pas automatiquement mis à jour. Les entreprises doivent recréer le jeton afin qu'il intègre toutes les autorisations configurées. Omettre cette étape entraîne souvent des erreurs « Accès refusé » difficiles à résoudre.

La sécurisation des webhooks par une clé secrète de signature est similaire à la sécurisation des jetons. Cette clé secrète n'est affichée qu'une seule fois, lors de la création du webhook ; il est donc impératif de la stocker immédiatement. Les systèmes externes envoyant des événements doivent inclure cette clé secrète dans l'en-tête afin que GTG CRM puisse vérifier la validité de la requête.

La limitation du débit est un mécanisme de protection contre la surcharge des systèmes. Les API sont soumises à une limite du nombre de requêtes sur une période donnée. Les applications doivent implémenter une logique de nouvelle tentative avec un délai exponentiel et éviter de solliciter l'API trop fréquemment en peu de temps. Si la limite de débit est dépassée, la requête est rejetée avec le code d'état HTTP 429.

La validation des données avant leur envoi à l'API permet d'éviter les erreurs. Vérifier le format des adresses e-mail, la longueur des chaînes de caractères et autres contraintes de données côté client avant d'appeler l'API permet d'économiser le quota de l'API et d'améliorer l'expérience utilisateur.

La surveillance et la journalisation sont essentielles pour détecter rapidement les problèmes d'intégration. Le suivi des journaux et de l'historique d'exécution des automatisations permet de s'assurer que le webhook reçoit les données correctes, que l'agent IA fonctionne comme prévu et qu'aucune erreur n'est négligée. GTG CRM propose un tableau de bord de surveillance permettant aux entreprises de suivre l'état de l'intégration.

Les instructions des agents d'IA doivent être claires et précises. Plus elles seront détaillées pour chaque type d'événement, plus les résultats de l'IA seront précis. Au lieu d'écrire « traiter l'événement », écrivez plutôt : « Lorsque l'événement est terminé (commande.completed), créez un document répertoriant l'heure et les informations de la commande, puis envoyez un e-mail de remerciement au client à l'aide du modèle A, et enfin, créez une tâche pour l'équipe commerciale avec un délai de 24 heures. »

Conclure

La plateforme d'intégration et l'API de GTG CRM constituent une solution d'intégration complète permettant aux entreprises de connecter leurs systèmes existants à des technologies d'IA de pointe sans avoir à refondre entièrement leur infrastructure technologique. Grâce à des instructions détaillées étape par étape, de la création d'applications et la configuration des autorisations à la mise en place de webhooks et l'intégration avec des agents d'IA, les entreprises peuvent créer des processus d'automatisation intelligents et réaliser d'importantes économies de ressources opérationnelles.

L'étude de cas MM3 démontre clairement le potentiel de cette solution, non seulement pour automatiser des tâches simples, mais aussi pour construire l'ensemble de la chaîne de valeur, des données brutes au contenu publié et au référencement automatisé. Point important, cette solution ne requiert ni connaissances approfondies en programmation ni une grande équipe technique, mais seulement une compréhension de base des API et la capacité de rédiger des instructions en langage naturel pour l'agent IA.

Grâce à son système de contrôle d'accès précis, sa sécurité multicouche et son évolutivité flexible, Integration Hub convient aux entreprises de toutes tailles, des startups aux grandes entreprises. Elles peuvent commencer par des intégrations simples comme la synchronisation des listes de contacts, puis étendre progressivement leurs fonctionnalités à des processus plus complexes tels que l'automatisation du contenu, le service client automatisé ou le traitement des paiements et la facturation.

Pour les entreprises qui débutent, nous recommandons une approche progressive, des tests approfondis à chaque étape et l'utilisation de la version d'essai gratuite de GTG CRM pour se familiariser avec le système avant le déploiement officiel. Commencez par un test simple de webhook pour comprendre son fonctionnement, puis passez progressivement à des tâches plus complexes à mesure que vous gagnez en expérience.

L'équipe d'assistance de GTG CRM est toujours prête à vous conseiller en détail sur les solutions d'intégration adaptées aux besoins spécifiques de chaque entreprise et à son infrastructure technologique actuelle. N'hésitez pas à nous contacter pour obtenir de l'aide lors de la mise en œuvre et de l'optimisation du processus d'intégration.