Review Sources

Review Sources est l'inventaire de Rankion de toutes les plateformes d'avis externes qui influencent ta marque — Google Business, Trustpilot, Yelp, Trusted Shops, ProvenExpert, similaires. Chaque source est connectée à Rankion via webhook et livre directement dans la plateforme les avis entrants, les moyennes d'étoiles et le volume. On peut en dériver des citations pour AI-Visibility Tracking, identifier les sources faibles et nominer de nouvelles plateformes via la waitlist. L'authentification passe par source via une clé API rotable, tous les endpoints sont team-scoped.

Ce qu'il peut faire

• Connecter des sources — créer une source par plateforme, générer l'URL webhook plus la clé secrète et la déposer chez le provider.
• Réception webhook — POST /webhooks/reviews/{source} est public (key-auth) et reçoit les reviews entrantes, parse étoiles, auteur, body, date.
• Rotation de clé — secret compromis ? rotate-key retire l'ancienne clé sans perte et livre une nouvelle.
• Disconnect / Reconnect — pause la source sans la supprimer (par ex. lors d'outages temporaires du provider).
• Waitlist — plateforme manquante ? waitlist enregistre ton souhait — priorisé pour le prochain tour de roadmap.
• Citation feed — les reviews de ces sources peuvent être référencées par Community Monitor et AI-Visibility Tracking comme signaux de citation.

Quand l'utiliser

• Tu veux gérer en un seul endroit toutes les plateformes d'avis sur lesquelles ta marque est listée.
• Tu utilises AI-Visibility Tracking et tu veux voir quelles sources de reviews sont effectivement citées par ChatGPT, Perplexity & Co.
• Tu veux roter / disconnecter sans passer par le dashboard provider.
• Tu as besoin d'une source que Rankion ne supporte pas encore — la waitlist est ton levier.

Workflow

1. Créer une source — POST /review-sources/webhook avec {source: "trustpilot"|"google"|...} crée une nouvelle entrée incl. webhook secret.
2. Déposer le webhook chez le provider — la réponse livre webhook_url et secret. Les inscrire chez le provider.
3. Les reviews coulent — le provider poste sur /webhooks/reviews/{source}. Rankion valide via secret, sauvegarde la review, normalise les étoiles 1–5.
4. Vérifier le statut — GET /review-sources/{id} montre count des reviews, dernier hit webhook, étoiles moyennes.
5. Rotater en cas de soupçon — POST /review-sources/{id}/rotate-key → nouveau secret, ancien immédiatement invalide.
6. Pauser / reprendre — disconnect met le statut sur paused, reconnect réactive.

API

Exemple — créer une source.

curl -X POST $BASE/review-sources/webhook \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"source":"trustpilot"}'

Réponse.

{
  "id": 7,
  "source": "trustpilot",
  "webhook_url": "https://rankion.ai/api/v1/webhooks/reviews/trustpilot",
  "secret": "rs_live_...",
  "status": "active"
}

Crédits et limites

• Connexion & gestion : gratuit. La réception webhook est gratuite.
• Corrélation de citations avec AI-Visibility tourne dans le tracking run, où les crédits sont comptés — pas ici.
• Rate-limit réception webhook : typiquement 10 req/sec par source. En cas de burst, les events sont mis en queue.
• Isolation cross-team : les sources sont team-scoped, une autre équipe ne voit pas tes reviews.

Modules associés

• Community Monitor — mentions externes + reviews comme feed brand-mention combiné.
• AI-Visibility Tracking — utilise les citations de reviews comme signal de trust pour le score AVI.
• Intégrations Google — statut Google Reviews comme indicateur de la connexion Google Reviews.