Connecter un BI (Power BI/Tableau) et Zapier/Make

Générez votre propre clé API et connectez des outils de BI et d'automatisation aux données de votre CRM, sans aucun compte externe de notre part.

Vous pouvez connecter des outils de BI (Power BI, Tableau, Looker) et des outils d'automatisation (Zapier, Make, n8n) directement à la base de données de votre CRM. Aucun compte externe de notre part n'est nécessaire : vous générez une clé API directement dans le CRM et vous la connectez à l'outil. Tout est en lecture seule et restreint aux données de votre tenant.

Prérequis

• Un compte dans un outil de BI (Power BI, Tableau, Looker Studio) ou d'automatisation (Zapier, Make, n8n) capable de consommer une API REST/JSON avec un en-tête d'authentification.
• Dans Sellio, un accès administrateur pour générer la clé API dans Paramètres → API.

1) Générer une clé API

1. Ouvrez Paramètres → API.
2. Créez une nouvelle clé API et copiez la valeur (elle commence par sk_ et n'apparaît qu'une seule fois, traitez-la donc comme un mot de passe).
3. Dans les outils, envoyez cette clé dans l'en-tête : Authorization: Bearer sk_...

2) Points de terminaison de données (les « tables »)

• GET /api/v1/objects : liste les objets disponibles (les tables que le BI peut lire).
• GET /api/v1/data/{object} : les enregistrements de l'objet aplatis en lignes, avec des colonnes stables : id, created_at, updated_at, owner_id et une colonne par champ (l'api_name du champ).

Pagination : utilisez ?page=1&pageSize=100 (ou ?limit= et ?offset=). Le pageSize maximum est 200. La réponse contient object, columns (nom et type de chaque colonne), page, pageSize, total et rows.

3) Power BI / Tableau / Looker

1. Dans Power BI : Obtenir des données → Web ; dans Tableau : connecteur Web/JSON ; dans Looker Studio : connecteur JSON/URL.
2. Pointez vers l'URL de données, par exemple https://YOUR-CRM/api/v1/data/opportunity
3. Ajoutez l'en-tête Authorization avec la valeur Bearer sk_... (votre clé API).
4. Les colonnes sont stables et typées, vous les mappez donc une seule fois et le rapport continue de fonctionner à mesure que de nouveaux enregistrements arrivent.

4) Zapier / Make / n8n

• Déclencheur par polling (« New/Updated record ») : interrogez GET /api/v1/data/{object}?updated_since=<ISO> (ou created_since=<ISO>) pour ne recevoir que ce qui a changé ou a été créé depuis la dernière vérification. Les enregistrements les plus récents arrivent en premier.
• Déclencheur instantané : dans Paramètres → Webhooks, créez un webhook sortant et pointez l'URL vers le « Catch Hook » de Zapier (ou le « Custom Webhook » de Make/n8n). À chaque création/mise à jour d'enregistrement, le CRM envoie l'événement signé (HMAC) instantanément.

Dans Paramètres → Intégrations, la carte « BI & Automatisation externe » regroupe les liens des points de terminaison et le raccourci pour générer la clé API.

Comment tester

1. Rapide : ouvrez GET https://YOUR-CRM/api/v1/objects avec l'en-tête Authorization: Bearer sk_... (dans un navigateur avec une extension, dans Postman ou avec curl) et vérifiez la liste des objets.
2. Lecture de données : appelez GET /api/v1/data/opportunity?pageSize=5 et confirmez que les lignes incluent les colonnes id, created_at, updated_at, owner_id et les champs.
3. Dans le BI : construisez la connexion en pointant vers l'URL de données et vérifiez que les colonnes apparaissent typées ; dans Zapier/Make, déclenchez le test et observez l'enregistrement arriver.

Dépannage

• 401 Unauthorized : la clé API est manquante, incorrecte ou n'a pas été envoyée sous la forme « Authorization: Bearer sk_... ». Générez-en une nouvelle dans Paramètres → API (la valeur n'apparaît qu'une seule fois) et reconfigurez l'outil.
• 404 sur le point de terminaison : vérifiez l'URL. Les objets se trouvent sur /api/v1/objects et les données sur /api/v1/data/{api_name}. Utilisez l'api_name exact de l'objet (pas le libellé localisé).
• Seules quelques lignes reviennent : les résultats sont paginés. Utilisez ?page=1&pageSize=200 (max 200) et parcourez les pages ; pour les lectures incrémentales, utilisez ?updated_since=<ISO>.
• Le webhook instantané ne se déclenche pas : vérifiez que le webhook sortant dans Paramètres → Webhooks pointe vers le « Catch Hook » (Zapier) / « Custom Webhook » (Make/n8n) et qu'il est actif. Le CRM signe l'envoi (HMAC), validez donc le secret si l'outil l'exige.
• Je ne vois que mes données : c'est correct. Chaque clé API est isolée au tenant propriétaire, elle ne voit donc jamais les données d'une autre entreprise.

Open this article inside the system →