Review Sources

Review Sources es el inventario de Rankion de todas las plataformas externas de valoraciones que afectan a tu marca — Google Business, Trustpilot, Yelp, Trusted Shops, ProvenExpert y similares. Cada fuente se conecta a Rankion vía webhook y entrega valoraciones entrantes, medias de estrellas y volumen directamente a tu plataforma. De ahí se derivan citations para AI-Visibility-Tracking, se identifican fuentes débiles y se proponen nuevas plataformas vía waitlist. La autenticación corre por fuente mediante una API-key rotable; todos los endpoints son team-scoped.

Qué puede hacer

• Conectar fuentes — crea una source por plataforma, genera webhook-URL más secret-key y dáselos al provider.
• Recepción de webhooks — POST /webhooks/reviews/{source} es público (key-auth) y recibe reviews entrantes, parseando estrellas, autor, body, fecha.
• Rotación de keys — ¿secret comprometido? rotate-key retira la antigua sin pérdida y entrega una nueva.
• Disconnect / Reconnect — pausa la fuente sin borrarla (p.ej. en outages temporales del provider).
• Waitlist — ¿falta plataforma? waitlist registra tu deseo — se prioriza en la próxima ronda de roadmap.
• Citation-Feed — las reviews de estas fuentes pueden ser referenciadas por Community Monitor y AI-Visibility Tracking como señales de citation.

Cuándo usarlo

• Quieres gestionar en un solo sitio todas las plataformas de valoración donde tu marca está listada.
• Usas AI-Visibility-Tracking y quieres ver qué review sources son citadas realmente por ChatGPT, Perplexity & Co.
• Quieres rotar/desconectar sin entrar al dashboard del provider.
• Necesitas una source que Rankion aún no soporta — la waitlist es tu palanca.

Workflow

1. Crea source — POST /review-sources/webhook con {source: "trustpilot"|"google"|...} crea entrada incluido webhook-secret.
2. Da el webhook al provider — la response entrega webhook_url y secret. Pégalos en el provider.
3. Llegan reviews — el provider hace POST a /webhooks/reviews/{source}. Rankion valida con el secret, guarda la review, normaliza estrellas 1–5.
4. Revisa estado — GET /review-sources/{id} muestra reviews-count, último webhook-hit, media de estrellas.
5. Si hay sospecha, rota — POST /review-sources/{id}/rotate-key → nuevo secret, el antiguo queda inválido al instante.
6. Pausar / reanudar — disconnect pone el status a paused, reconnect lo reactiva.

API

Ejemplo — crear source.

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

Response.

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

Créditos y límites

• Conexión y gestión: sin coste. La recepción de webhooks es sin coste.
• Correlación citation con AI-Visibility corre dentro del tracking-run, allí se contabilizan créditos — no aquí.
• Rate-limit recepción de webhooks: típicamente 10 req/sec por source. En burst, los eventos se encolan.
• Aislamiento cross-team: las sources son team-scoped, otro team no ve tus reviews.

Módulos relacionados

• Community Monitor — menciones externas + reviews como feed combinado de brand-mentions.
• AI-Visibility Tracking — usa review-citations como señal de trust para el AVI-Score.
• Google Integrations — el estado de Google-Reviews como indicador para la conexión de Google Reviews.