Table des matières
Introduction
Dans le monde numérique d’aujourd’hui, intégrer HubSpot avec Kinsta est devenu crucial pour les agences qui souhaitent automatiser la création de sites WordPress. Lorsqu’un nouveau client s’inscrit pour vos services, le temps entre la signature du contrat et la mise en ligne d’un site WordPress est essentiel. Grâce à l’API Kinsta, vous pouvez automatiser une partie de ce processus, rendant ainsi l’onboarding de nouveaux clients beaucoup plus efficace.
Pourquoi automatiser la création de sites ?
La configuration manuelle d’un site peut introduire des délais à un moment où la dynamique de la relation client est primordiale. Les nouvelles inscriptions nécessitent souvent qu’un membre de l’équipe crée un environnement d’hébergement, configure WordPress et génère des identifiants. Bien que MyKinsta facilite ces tâches, des retards peuvent survenir si le processus dépend de la disponibilité d’un membre de l’équipe. En utilisant l’API Kinsta, des agences comme Straight out Digital (Sod) ont réussi à transformer des opérations qui prenaient du temps en workflows automatisés. Cela permet de déclencher le processus de création de site de manière programmatique, rendant l’opération beaucoup plus rapide et efficace.
Pré-requis pour l’intégration
Pour suivre ce tutoriel, vous aurez besoin de :
- Au moins un site existant dans votre compte Kinsta pour assurer l’accès à l’API.
- Un compte HubSpot avec un formulaire configuré pour capturer les inscriptions des clients.
- Node.js 18 ou une version ultérieure installée localement.
Vous pouvez générer une clé API Kinsta dans le tableau de bord MyKinsta. Allez dans Paramètres de l’entreprise > Clés API et cliquez sur Créer une clé API. N’oubliez pas de stocker cette clé en lieu sûr, car elle ne sera affichée qu’une seule fois.
Étape 1 : Configurer votre formulaire HubSpot
Dans votre tableau de bord HubSpot, créez ou sélectionnez le formulaire qui capture les nouvelles inscriptions des clients. Le formulaire doit contenir au minimum des champs pour le prénom, l’adresse e-mail et le nom de l’entreprise. Ces valeurs seront utilisées plus tard lors de l’appel à l’API Kinsta.
Une fois votre formulaire prêt, allez dans Automatisation > Workflows dans le menu de navigation de HubSpot et cliquez sur Créer un workflow. Sélectionnez Démarrer à partir de zéro pour ouvrir l’éditeur de workflow. Cliquez sur le déclencheur et choisissez Soumission de formulaire comme déclencheur d’inscription. Sélectionnez ensuite votre formulaire dans le menu déroulant et complétez la configuration.
Étape 2 : Construire le middleware
HubSpot peut envoyer un webhook à une URL lorsque un contact soumet votre formulaire, mais il n’a pas la capacité de communiquer directement avec l’API Kinsta. C’est là qu’intervient une couche middleware qui reçoit la charge utile de HubSpot, extrait les données nécessaires, les reformate et les transmet à l’API Kinsta.
Pour cela, nous allons utiliser Express.js, un framework web Node.js minimal qui facilite la création d’un serveur HTTP. Installez-le après avoir initialisé un nouveau projet Node.js :
npm init -y
npm install express dotenv
Votre serveur résidera dans un fichier app.js. Il démarrera Express, indiquera à celui-ci de parser les corps de requête entrants en JSON, définira une route qui écoute les requêtes POST de HubSpot et démarrera le serveur sur un port local.
Étape 3 : Authentification avec l’API Kinsta
L’API Kinsta utilise l’authentification par jeton Bearer. Chaque requête que vous envoyez doit inclure votre clé API dans l’en-tête d’autorisation. Cela permet à l’API d’identifier votre compte et de vérifier votre niveau d’accès. La ligne require(‘dotenv’).config() au début de app.js charge votre fichier .env lorsque l’application démarre, ce qui permet d’accéder à votre clé API au moment de l’exécution.
Étape 4 : Créer le site WordPress via l’API Kinsta
Une fois l’authentification en place, vous pouvez faire la requête de création de site. L’API Kinsta accepte une requête POST avec les détails du site que vous souhaitez créer. Plutôt que d’attendre que le site soit prêt avant de répondre, l’API renvoie immédiatement une référence que vous utilisez pour suivre l’opération.
Étape 5 : Surveiller le statut de l’opération
La création de site s’exécute de manière asynchrone, vous devez donc interroger l’endpoint /operations/{operation_id} pour vérifier quand le site est prêt. L’API renvoie le statut actuel de l’opération chaque fois que vous l’appelez. Lorsque ce statut change en « terminé », la réponse contient des détails sur le nouveau site.
Conclusion
Automatiser l’intégration de HubSpot avec Kinsta permet non seulement de gagner du temps, mais aussi d’améliorer l’expérience client. En suivant ces étapes, vous pouvez créer un processus d’onboarding fluide et efficace pour vos nouveaux clients, réduisant ainsi le travail manuel impliqué dans la création de nouveaux sites WordPress.