33800 Docs

← Retour

Proposition : OAuth2 Multi-Provider + Connecteurs Meta/TikTok

Date : 03/02/2026 Statut : En attente de validation

Contexte

Actuellement, Connectors Hub supporte OAuth2 uniquement pour Google. L'utilisateur souhaite :

  1. Ajouter les providers Meta (Instagram/Facebook) et TikTok pour récupérer les KPIs analytics
  2. Généraliser l'espace de configuration OAuth2 (style VPN profiles) pour lier facilement les credentials aux instances

Objectifs

Plan d'implémentation

Phase 1 : Backend Providers (connectors-api)

Fichier : src/data/oauth-providers.ts

Provider Auth URL Scopes principaux
meta facebook.com/v21.0/dialog/oauth instagram_basic, instagram_manage_insights, pages_read_engagement
tiktok tiktok.com/v2/auth/authorize/ user.info.basic, user.info.stats, video.list

Fichier : src/services/oauth.ts

Fichier : src/index.ts

Phase 2 : Backend Connecteurs (connectors-api)

Fichier : src/data/connector-types.ts

Instagram (via Meta Graph API v21.0)

Endpoint Description
GET /{ig-user-id}/insights?metric=impressions,reach&period=day KPIs compte
GET /{ig-user-id}/insights?metric=follower_count&period=lifetime Evolution followers
GET /{media-id}/insights?metric=engagement,saved KPIs par média
GET /{ig-user-id}/media Liste médias
GET /{ig-user-id}/stories Stories actives

Facebook (via Meta Graph API v21.0)

Endpoint Description
GET /me/accounts Mes pages
GET /{page-id}/insights?metric=page_impressions,page_fans KPIs page
GET /{page-id}/posts Posts de la page

TikTok (API v2)

Endpoint Description
GET /user/info/?fields=follower_count,likes_count,video_count KPIs profil
POST /video/list/ Liste vidéos
POST /video/query/?fields=view_count,like_count,comment_count KPIs vidéos

Phase 3 : Frontend (connectors-front)

Refactorer : src/routes/settings/oauth/index.tsx

Créer : src/routes/settings/oauth/new.tsx

Créer : src/routes/settings/oauth/[id]/index.tsx

Fichiers impactés

Fichier Action Estimation
connectors-api/src/data/oauth-providers.ts Modifier +80 lignes
connectors-api/src/data/connector-types.ts Modifier +250 lignes
connectors-api/src/services/oauth.ts Modifier +60 lignes
connectors-api/src/index.ts Modifier +40 lignes
connectors-front/src/routes/settings/oauth/index.tsx Refactorer ~300 lignes
connectors-front/src/routes/settings/oauth/new.tsx Créer ~250 lignes
connectors-front/src/routes/settings/oauth/[id]/index.tsx Créer ~280 lignes
connectors-front/src/lib/api.ts Modifier +15 lignes

Prérequis externes

Provider Action requise
Meta Créer app sur developers.facebook.com, demander App Review pour instagram_manage_insights
TikTok Créer app sur developers.tiktok.com

Vérification post-implémentation

  1. [ ] Créer credential Meta → Autoriser via Facebook OAuth → Status "connected"
  2. [ ] Créer instance Instagram liée au credential Meta
  3. [ ] Appeler endpoint insights Instagram → Données KPIs reçues
  4. [ ] Vérifier client_secret chiffré en BDD
  5. [ ] Tester auto-refresh token après expiration

Notes

En attente de validation pour commencer l'implémentation.