Vue d'ensemble
Les clés API vous permettent de connecter Dashboardly à un assistant IA tel que ChatGPT, Claude ou Cursor, afin que l'assistant puisse répondre à des questions sur vos données TikTok Shop en langage courant. Vous demandez « Quel a été mon Net Profit la semaine dernière ? » ou « Quel SKU s'est le plus vendu hier dans ma boutique du Royaume-Uni ? » et l'assistant récupère la réponse directement à partir de vos données Dashboardly en temps réel.
La connexion utilise un standard ouvert appelé Model Context Protocol (MCP), que tout assistant IA moderne peut comprendre. Vous générez une clé API par assistant (ou une par boutique), vous la collez dans les paramètres de l'assistant, et la conversation est connectée à vos données.
Les clés API sont en lecture seule. Un assistant IA peut lire chaque métrique que vous voyez dans Dashboardly, mais il ne peut pas créer de commandes, modifier les coûts des produits, modifier les paramètres, envoyer des remboursements ou modifier quoi que ce soit dans votre TikTok Shop ou votre compte Dashboardly.
Vous gérez toutes les clés sur la page Settings > API Keys.
Conditions liées à l'offre
Les clés API font partie de la fonctionnalité Intégrations IA de Dashboardly, disponible sur les offres suivantes :
| Offre | Clés API incluses |
|---|---|
| Brand Starter | Non disponible |
| Brand Growth | Disponible |
| Brand Pro | Disponible |
| Brand Elite | Disponible |
Si vous êtes sur Brand Starter, l'onglet API Keys dans les Paramètres affiche une invitation à passer à une offre supérieure. Mettez votre abonnement à niveau sur la page Settings > Subscriptions pour activer la fonctionnalité.
Il n'y a pas de frais par clé. Vous pouvez créer autant de clés que vous le souhaitez sur une offre éligible, sans frais supplémentaires pour les requêtes effectuées par votre assistant IA.
Comment ça fonctionne
Lorsque vous créez une clé API dans Dashboardly, deux choses se produisent :
- La clé est générée. Elle ressemble à
dk_live_...suivi d'une longue chaîne aléatoire. Vous voyez la clé complète une seule fois, au moment de la création. Ensuite, Dashboardly ne conserve qu'une empreinte de celle-ci, de sorte que même notre équipe d'assistance ne peut pas récupérer la clé complète ultérieurement. - La clé est liée à votre compte. Chaque clé est rattachée à votre identifiant de connexion Dashboardly et, en option, à un seul TikTok Shop. Lorsqu'un assistant IA utilise la clé pour demander des données, il reçoit exactement ce que vous verriez si vous ouvriez cette boutique dans votre navigateur.
Votre assistant IA se connecte à un point de terminaison Dashboardly (le serveur MCP) et présente la clé. Le point de terminaison vérifie la clé, détermine quelle boutique la clé est autorisée à lire, et renvoie les données demandées. Chaque requête est enregistrée afin que vous puissiez voir à quelle fréquence votre assistant utilise la clé et quelles questions il pose.
Comme la clé est en lecture seule, l'assistant n'a aucun moyen de modifier quoi que ce soit. L'action la plus « destructrice » qu'il puisse réaliser est de lire une métrique.
Étape par étape : créez votre première clé API
Étape 1 : ouvrez la page API Keys
Accédez à Settings > API Keys dans la barre latérale gauche. Si vous ne voyez pas l'onglet, vérifiez que votre abonnement est sur Brand Growth ou une offre supérieure.
Étape 2 : cliquez sur « New API key »
Dans le coin supérieur droit de la page, cliquez sur le bouton + New API key. Un petit formulaire s'ouvre.
Étape 3 : renseignez les détails
- Name -- une étiquette pour reconnaître la clé plus tard. Utilisez un libellé descriptif comme « Claude Desktop -- US Shop » ou « ChatGPT for John ». Les noms ne sont visibles que par vous.
- Shop -- choisissez une seule boutique, ou laissez le champ sur « All shops » pour donner à la clé l'accès à toutes les boutiques que vous avez connectées. La plupart des utilisateurs préfèrent une clé par boutique afin que chaque conversation IA soit automatiquement limitée aux bonnes données.
- Expires in -- le nombre de jours avant que la clé cesse automatiquement de fonctionner. La valeur par défaut est de 365 jours. Des expirations plus courtes sont plus sûres ; des expirations plus longues signifient que vous n'avez pas à renouveler la clé aussi souvent. Vous pouvez révoquer une clé à tout moment, quelle que soit son expiration.
Étape 4 : cliquez sur « Create key »
Dashboardly génère la clé et l'affiche dans un panneau de confirmation. La clé est affichée intégralement une seule fois.
Étape 5 : copiez la clé immédiatement
Cliquez sur le bouton Copy pour placer la clé dans votre presse-papiers. Collez-la dans un endroit sécurisé (le fichier de configuration de votre assistant, un gestionnaire de mots de passe ou une note sûre). Si vous fermez le panneau sans copier, vous devrez révoquer la clé et en créer une nouvelle -- il n'y a aucun moyen de la récupérer à nouveau.
Étape 6 : connectez votre assistant IA
Ouvrez les paramètres de votre assistant IA et ajoutez Dashboardly comme connexion (le chemin exact varie selon l'assistant ; consultez la section suivante pour des conseils sur chacun).
Étape 7 : confirmez la connexion
Posez à votre assistant une question simple comme « Quel est mon Net Profit pour la semaine dernière ? » Si tout est correctement configuré, l'assistant répond avec la réponse tirée de vos données Dashboardly en temps réel. Si vous voyez une erreur, consultez Pourquoi mon assistant IA ne fonctionne-t-il pas ?.
Connexion d'un assistant IA
La configuration exacte dépend de l'assistant que vous utilisez. Après avoir créé la clé dans Dashboardly, le panneau de confirmation affiche des extraits de configuration prêts à coller pour les outils les plus populaires.
Claude (Desktop et Web)
Dans les paramètres de Claude, recherchez une section appelée Connectors, Integrations ou MCP servers. Ajoutez une nouvelle connexion en collant l'URL du point de terminaison Dashboardly et votre clé API. Une fois enregistré, Claude affiche Dashboardly comme connexion disponible dans n'importe quelle conversation.
Si vous utilisez Claude Desktop, la connexion est ajoutée à un fichier de configuration qui se charge au démarrage de Claude. Le panneau de confirmation dans Dashboardly affiche le texte exact à coller.
ChatGPT
Dans ChatGPT, ouvrez le menu Apps & Connectors et ajoutez Dashboardly comme connecteur personnalisé. Collez l'URL du point de terminaison et la clé API lorsque cela vous est demandé. ChatGPT mémorise la connexion dans toutes vos conversations.
Cursor
Dans Cursor, ouvrez Settings > MCP, cliquez sur Add new MCP server, et collez le point de terminaison et la clé Dashboardly. Cursor utilise la connexion pendant que vous codez, vous pouvez donc poser des questions comme « Quel est mon SKU le plus vendu ce mois-ci ? » sans quitter votre éditeur.
Autres assistants IA
Tout assistant qui comprend le Model Context Protocol peut se connecter. Fournissez à l'assistant l'URL du point de terminaison MCP de Dashboardly et la clé API (traitez-la comme un mot de passe). L'assistant devrait automatiquement découvrir quelles données sont disponibles.
Ce que votre assistant IA peut faire
Une fois connecté, votre assistant peut répondre à des questions couvrant tous les principaux domaines de vos données de boutique. Vous posez des questions en langage courant (ou dans toute langue prise en charge par votre assistant), et l'assistant décide quelles données récupérer.
| Sujet | Exemples de questions |
|---|---|
| Compte et boutiques | « Quelles boutiques sont connectées ? » « Quelle est l'adresse e-mail de mon compte ? » |
| Résumé du tableau de bord | « Donne-moi un aperçu rapide de la semaine dernière. » « Comment les ventes évoluent-elles par rapport au mois dernier ? » |
| Profit & loss | « Quel a été mon Net Profit en mars ? » « Décompose mon P&L par semaine pour le dernier trimestre. » |
| Commandes | « Combien de commandes ai-je reçues hier ? » « Montre-moi les commandes annulées des 7 derniers jours. » |
| Meilleurs produits | « Quels SKU se sont le plus vendus le mois dernier ? » « Quels ont été mes 10 meilleurs produits par chiffre d'affaires ce trimestre ? » |
| Remboursements | « Combien ai-je remboursé la semaine dernière ? » « Quels produits ont le taux de retour le plus élevé ? » |
| Clients | « Combien de clients fidèles ai-je ? » « Quelle est la valeur vie de mon client moyen ? » |
| Marketing et publicités | « Quel a été mon ROAS sur TikTok Ads la semaine dernière ? » « Comment se comportent mes campagnes publicitaires ? » |
| Lives et promotions | « Quels lives ont généré le plus de ventes le mois dernier ? » « Combien ai-je économisé grâce aux subventions de la plateforme en avril ? » |
| Inventaire | « Quels SKU ont un stock faible ? » « Quelle est la valeur actuelle de mon inventaire ? » |
| Répartition géographique | « D'où proviennent la plupart de mes commandes ? » « Comment se portent les ventes en Allemagne ce mois-ci ? » |
| Métriques horaires | « Quelle heure de la journée reçoit le plus de commandes ? » « Montre-moi les ventes d'hier heure par heure. » |
L'assistant ne peut effectuer aucune action dans votre TikTok Shop ni dans Dashboardly. Il ne peut que lire.
Gestion de vos clés
Affichage des clés
La page Settings > API Keys répertorie chaque clé que vous avez créée avec son nom, les premiers caractères de la clé (pour la reconnaître), la boutique à laquelle elle est liée, sa date de création, sa dernière utilisation et sa date d'expiration.
Inspection de l'utilisation
Cliquez sur une clé active pour développer un panneau d'utilisation affichant :
- Le total des appels au cours des 30 derniers jours
- Le taux de réussite (appels ayant renvoyé des données avec succès)
- Le temps de réponse moyen, pour vérifier que la connexion est rapide
- Un graphique d'activité quotidienne pour les 7 derniers jours
- Les outils de données les plus utilisés, pour voir ce que l'assistant demande le plus
C'est utile pour confirmer qu'une clé est utilisée, repérer une activité inhabituelle ou voir sur quoi votre assistant a tendance à se concentrer.
Révocation d'une clé
Si une clé est perdue, exposée ou n'est plus nécessaire, cliquez sur l'icône Revoke à côté d'elle. Dashboardly bloque immédiatement toute requête ultérieure utilisant cette clé. Les assistants IA connectés avec la clé révoquée verront une erreur lors de leur prochaine question.
La révocation est instantanée. Il n'y a aucun délai de grâce.
Expiration des clés
Chaque clé a une date d'expiration définie lors de sa création. Dashboardly affiche un badge d'avertissement sur la page API Keys lorsqu'il reste 14 jours ou moins à une clé. Les clés expirées cessent automatiquement de fonctionner -- inutile de les révoquer.
Pour renouveler une clé selon un calendrier récurrent, créez une nouvelle clé, mettez à jour votre assistant IA pour qu'il l'utilise, puis révoquez l'ancienne.
Applications connectées
Certains assistants IA (notamment ChatGPT) se connectent via un flux de connexion en un clic au lieu de vous demander de copier une clé API. Lorsque vous accordez à Dashboardly l'accès à l'un de ces assistants, il apparaît dans la section Connected Apps au bas de la page API Keys.
Pour chaque application connectée, vous pouvez voir son nom, sa date de première connexion, sa dernière activité et deux façons de la déconnecter :
- Revoke -- bloque les nouvelles connexions de cet assistant. Les sessions actives restent valides jusqu'à une heure, puis expirent.
- Sign out now -- déconnecte immédiatement l'assistant, en mettant fin à toute session active. Utilisez ceci si vous soupçonnez que la connexion est utilisée à mauvais escient.
Sécurité et confidentialité
Les clés API sont sensibles. Traitez chaque clé comme un mot de passe.
- Ne validez jamais une clé dans un dépôt de code public. Si vous le faites accidentellement, révoquez-la depuis Dashboardly et générez-en une nouvelle.
- Ne partagez jamais une clé dans un message de chat, un e-mail ou une capture d'écran. Toute personne disposant de la clé peut lire vos données jusqu'à ce que vous la révoquiez.
- Utilisez une clé par assistant ou par appareil. Ainsi, si une clé est compromise sur un appareil, vous pouvez révoquer uniquement cette clé sans perturber vos autres connexions.
- Définissez une expiration raisonnable. Une clé qui expire dans 90 jours est plus sûre qu'une clé qui dure éternellement. Vous pouvez toujours en créer une nouvelle.
Dashboardly n'affiche jamais la clé complète après sa création. Le seul endroit où la trouver est là où vous l'avez enregistrée lors de la génération de la clé.
Toutes les requêtes des assistants IA sont effectuées via HTTPS. Chaque requête est enregistrée avec un horodatage et le domaine de données interrogé. Vous pouvez auditer cet historique par clé depuis le panneau d'utilisation décrit ci-dessus.
Lecture seule signifie lecture seule : même si une clé était compromise, un attaquant pourrait voir vos données mais ne pourrait modifier aucun coût de produit, envoyer un remboursement ou affecter votre TikTok Shop de quelque manière que ce soit.
Questions fréquentes
Mon assistant IA voit-il l'ensemble de mon compte Dashboardly, ou seulement une boutique ?
Cela dépend de la façon dont vous avez configuré la clé. Si vous avez lié la clé à une seule boutique, l'assistant ne voit que cette boutique. Si vous avez laissé « All shops » sélectionné, l'assistant peut lire les données de toutes les boutiques de votre compte. La plupart des utilisateurs préfèrent une clé par boutique pour plus de clarté.
Puis-je créer des clés différentes pour différents membres de l'équipe ?
Oui. Créez une clé nommée par personne (« Claude -- Maria », « ChatGPT -- John ») et ne partagez chaque clé qu'avec la personne qui en a besoin. Si quelqu'un quitte l'équipe, révoquez sa clé sans affecter les autres.
L'utilisation d'un assistant IA me coûtera-t-elle un supplément ?
Non. Il n'y a aucun frais par requête de la part de Dashboardly. Votre fournisseur d'assistant IA (OpenAI, Anthropic, etc.) vous facture séparément l'assistant lui-même selon sa propre tarification.
Quelle est la fraîcheur des données que voit mon assistant ?
Exactement aussi fraîches que ce que vous voyez dans Dashboardly. Si le tableau de bord affiche une métrique mise à jour il y a 2 minutes, c'est ce que l'assistant obtient. Les chiffres basés sur le règlement (frais, taxes) peuvent être estimés pour les commandes très récentes -- consultez Pourquoi mes données sont-elles en retard ? pour l'explication complète.
Mon assistant IA peut-il apporter des modifications à ma boutique ?
Non. Chaque clé API est en lecture seule. Il n'existe aucun mode « écriture » et il n'est pas prévu d'en ajouter un. Le maximum qu'un assistant puisse faire est de résumer les chiffres qu'il lit.
Qu'advient-il de mes anciennes clés si je rétrograde mon offre ?
Si vous rétrogradez vers Brand Starter, toutes les clés API existantes cessent immédiatement de fonctionner. Repassez à Brand Growth ou une offre supérieure pour les réactiver, ou créez de nouvelles clés après la mise à niveau.
Puis-je voir ce que mon assistant IA a demandé ?
Oui. Le panneau d'utilisation de chaque clé affiche les domaines de données les plus utilisés (commandes, P&L, meilleurs produits, etc.) et un graphique d'activité sur 7 jours. Nous n'enregistrons pas les questions en langage courant saisies par l'utilisateur -- uniquement les outils de données appelés par l'assistant.