Intégrer les comptes sociaux des clients

Utilisez le MCP Server pour intégrer les comptes sociaux de vos clients sous forme de sous-profils avec une URL d’association sociale JWT.

Les intégrateurs disposant d’un Business Plan ou Enterprise Plan peuvent intégrer les comptes sociaux de leurs clients sous forme de sous-profils. À l’aide du MCP Server, un agent crée un sous-profil, le cible, et génère une URL d’association en authentification unique que le client ouvre pour connecter ses comptes.

​

Flux

1. Créer un sous-profil

   Appelez create_profile (au niveau du compte — sans profileKey). Il renvoie une profile key pour le nouveau sous-profil.

2. Cibler le sous-profil

   Utilisez la profile key renvoyée sur les appels suivants — soit via l’en-tête Profile-Key sur la connexion, soit comme argument profileKey par appel. Consultez Connect & Setup pour la priorité.

3. Générer une URL d'association sociale

   Appelez generate_jwt_social_linking_url pour générer une URL d’association en authentification unique. La clé de signature JWT et le domaine d’onboarding sont dérivés côté serveur — l’appelant ne fournit aucun en-tête X-Ayrshare-* et aucune clé privée ni domaine.

4. Le client associe ses comptes

   Le client ouvre l’URL et autorise (OAuth) ses comptes sociaux. Les comptes connectés sont associés au sous-profil.

​

Prérequis

generate_jwt_social_linking_url requiert un profileKey. Si aucun n’est résolu, l’appel renvoie 400 avec le message « Profile Key is required… ».

Un domaine d’association sociale doit être provisionné pour votre compte. Cette fonctionnalité est disponible sur les Business Plan et Enterprise Plan.

​

États d’erreur

Condition	Réponse
Aucun domaine provisionné	400 — « No social-linking domain is provisioned for this account (available on Business/Enterprise plans). »
Aucune clé de signature	400 — « No signing key found for this account’s social-linking domain. »

​

Étapes suivantes

Connect & Setup

Authentification et ciblage de profil.

Tool Catalog

Les 27 outils regroupés par domaine, avec leur portée et leur objectif.