Passer au contenu principal

API, MCP et widget d'affichage des avis

Accéder à vos données par l'API, interroger Feedier depuis Claude avec le serveur MCP, et afficher vos avis clients sur votre site.

F
Écrit par François Forest

En bref : l'API lit et écrit vos données depuis vos systèmes. Le serveur MCP permet à un assistant IA comme Claude d'interroger vos feedbacks. Le widget d'affichage publie vos notes et avis sur votre site.

L'API REST Feedier

Menu → Paramètres → Paramètres avancés → API (admins uniquement)

Documentation de l'API : https://developers.feedier.com/

Élément

Usage

URL de la documentation

La référence complète des points d'accès

URL de point de terminaison

L'adresse de base de l'API de votre espace

Clé publique

Un identifiant non sensible, utilisé par les widgets

Clé privée

Votre jeton d'accès à l'API publique (points d'accès /v3)

Authentifiez chaque appel avec la clé privée :

Authorization: Bearer <votre_clé_privée>

La clé privée doit rester secrète. Elle est réservée aux échanges de serveur à serveur et ne doit jamais apparaître dans une application côté navigateur ou mobile.

Cas d'usage

Comment

Envoyer une enquête après chaque achat

Déclencher une campagne existante avec les attributs du client. Voir Diffuser une enquête.

Extraire des feedbacks vers votre entrepôt de données

Lire les feedbacks, filtrés en FQL

Gérer les désabonnements

Points d'accès push-unsubscribes

Les attributs sensibles restent lisibles par l'API. Une clé privée donne accès à toutes les données de l'espace de travail : pour isoler des données, utilisez des espaces de travail séparés.

Le serveur MCP Feedier

Feedier expose un serveur MCP (Model Context Protocol). Un assistant compatible, comme Claude ou Copilot, peut alors mesurer vos KPI, explorer vos thèmes, générer des rapports et des plans d'action, dans les limites de vos droits.

Outils

Ping, Scope, Measure, Explore, Discover, Report, GenerateActionPlan

Ressources

Topics, Attributes, Segments, Questions, KPIs

Exemple: Connecter Claude

  1. Dans Claude, ouvrez les paramètres des connecteurs et ajoutez un connecteur personnalisé.

  2. Nom : Feedier. URL : https://bx.feedier.com/mcp (ou https://<votre-domaine>/mcp avec un domaine personnalisé).

  3. Connectez-vous avec votre compte Feedier et approuvez l'accès.

  4. Posez vos questions : « Mesure le NPS des 30 derniers jours », « Explore les principaux thèmes de la semaine dernière », « Génère un plan d'action à partir des détracteurs ».

L'assistant ne voit que ce que votre compte Feedier connecté peut voir : votre rôle, vos équipes et la visibilité des attributs s'appliquent.

Le widget d'affichage des avis

Affichez une note moyenne et des avis clients sur votre site, sans développement complexe. Il existe deux modes : compact (une note) et complet (une liste de cartes d'avis).

compact

complet

  1. Ajoutez le script dans l'en-tête de votre site, avec votre clé publique :

<script async defer src="https://display-widget.feedier.com/widget.js?api_key={CLÉ_PUBLIQUE}"></script>
  1. Placez un bloc à l'endroit voulu :

<div data-feedier-widget data-layout="compact" data-primary-color="#cc0d2b" data-kpi='ratings("survey.id", "=", "123")' data-score-max="5"></div>

Paramètre

Obligatoire

Rôle

data-layout

✅

compact ou full

data-kpi

✅

Le KPI affiché, écrit comme une formule de KPI

data-score-max

✅

Le maximum de l'échelle (5 pour une note, 10 pour un NPS)

data-primary-color

La couleur, en hexadécimal

data-min-count

N'affiche le widget qu'au-delà de ce nombre de feedbacks

data-threshold

N'affiche le widget que si le score dépasse ce seuil

data-fql

Un filtre FQL sur les feedbacks affichés

data-locale / data-locales

La langue (en ou fr) et vos propres libellés

data-target (compact)

L'élément vers lequel diriger le clic, par exemple le widget complet

data-description (complet)

Un texte HTML sous le titre

data-heading-attribute-name, data-score-feedback-item-id, data-verbatims-feedback-item-id (complet)

Le titre, la note et le verbatim de chaque carte

Astuce : combinez data-min-count et data-threshold pour n'afficher la note que lorsqu'elle est fiable et flatteuse, par exemple au moins 200 avis et une moyenne supérieure à 3,5.

Webhook de l'espace de travail

Un webhook peut être déclenché lorsqu'un nouvel utilisateur rejoint Feedier, pour l'ajouter à vos propres outils. Pour les feedbacks, utilisez plutôt une automatisation.

FAQ

Où trouver l'identifiant d'une enquête ou d'une question ?

Dans l'URL de la page correspondante, ou dans l'onglet Options → Gestion de l'enquête de Feedier Surveys.

Peut-on régénérer la clé privée ?

Contactez le support : tous les appels qui utilisent l'ancienne clé devront être mis à jour.


Dernière vérification : 11 novembre 2026, version 4.23.5.

Icône de pièce jointe
Avez-vous trouvé la réponse à votre question ?