Intégration de vos données HubSpot dans Qlik (Guide technique)

Dans cet article, découvrez comment connecter Qlik Sense à l’API HubSpot afin de récupérer automatiquement des données (comme les emails) via un script REST, et les structurer efficacement pour vos visualisations ou analyses. Un guide étape par étape pour une intégration réussie !

🛠️ Étape 1 : Connexion à l’API HubSpot

Commencez par ouvrir la section Chargement de données dans Qlik Sense, puis cliquez sur Créer une connexion.

1. Recherchez « REST » dans la barre de recherche.
2. Sélectionnez le connecteur REST, puis configurez-le avec l’URL suivante :

https://api.hubspot.com/crm/v3/objects/emails?properties=hs_email_from_firstname,hs_email_from_lastname

Voici comment il se présente :

👉 Cette URL permet d’accéder aux emails et de récupérer le prénom (hs_email_from_firstname) et le nom (hs_email_from_lastname) de l’expéditeur.

🔐 Configuration de l’authentification

Dans la section Additional request parameters, renseignez :

• Query header Name : Authorization
• Value : Bearer <Votre clé API>

⚠️ N’oubliez pas de cocher la case Allow « WITH CONNECTION », indispensable pour la suite du script.

📋 Étape 2 : Structuration du script

Créez une nouvelle section, par exemple nommée emails, puis :

1. Sélectionnez la connexion que vous venez de créer.

1. Cochez la racine (« Root ») dans l’aperçu des données.
2. Cliquez sur « Insérer le script ».

Vous venez d’importer un script de base qui récupère les 10 premiers enregistrements (limite imposée par l’API HubSpot). Pour accéder à toutes les données, il est nécessaire de mettre en place une boucle d’appel API.

🔁 Étape 3 : Boucler l’API HubSpot pour récupérer tous les résultats

L’API HubSpot renvoie un champ "next" contenant une URL de pagination. Pour enchaîner les requêtes automatiquement :

Ajoutez à la fin du script initial :

let next_url = peek('link', 0, 'next');

Cette ligne crée une variable next_url, et lui attribue l’url situé dans le champ ‘link’ de la table next.

Puis lancez la boucle :

do while Len(Trim(next_url)) > 0 AND last_url <> next_url;

Cela permet de :

• Continuer tant que l’URL suivante existe,
• Éviter les boucles infinies en comparant avec l’URL précédente.

Ensuite :

let last_url = '$(next_url)';

💡 Copiez le script précédemment généré par Qlik (de RestConnectorMasterTable: à DROP TABLE RestConnectorMasterTable;) à l’intérieur de la boucle, en y ajoutant cette clause à la requête SQL :

WITH CONNECTION (
    Url "$(next_url)"
);

⚠️ Respectez l’indentation pour éviter tout problème dans le script.

Enfin, terminez la boucle avec :

let next_url = peek('link', -1, 'next');
LOOP

✅ Résultat : Données HubSpot accessibles, propres et prêtes à analyser

Grâce à ce processus, vous disposez d’un script dynamique capable de récupérer toutes les données disponibles via HubSpot, avec un traitement automatique de la pagination.

🎯 Utilisez-le comme base pour d’autres types de données (contacts, entreprises, tickets, etc.) en adaptant simplement l’URL et les propriétés.