API LinkedIn et assistants IA (MCP) #

Tout ce que vous faites sur les pages LinkedIn peut également être effectué depuis un script ou un assistant IA : vos prospects, la file d’attente des demandes de connexion, vos règles ICP (y compris les pays que vous acceptez et la taille minimale du réseau d’un prospect), votre boîte de réception, vos agents IA et vos paramètres.

Il n’y a rien de nouveau à configurer. Il utilise la même clé API que le reste de DM Champ, donc si vous appelez déjà notre API ou si vous avez un assistant IA connecté, vous êtes prêt.

Où trouver votre clé #

Paramètres → Intégrations → Clé API. Si vous n’en avez pas encore, cliquez sur Générer une clé API. Les étapes complètes se trouvent dans Accès API.

Il n’y a pas de clé LinkedIn distincte à créer, renouveler ou révoquer. La clé agit en votre nom, avec les mêmes autorisations que celles dont vous disposez dans l’application ; traitez-la donc comme un mot de passe. La révoquer dans les Paramètres coupe instantanément tous les scripts et assistants connectés.

Appeler l’API directement #

• URL de base : https://app.sdrpilot.ai/api/v1
• En-tête : X-API-Key: YOUR_API_KEY
• Description lisible par machine : https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (également disponible sous .json)

Le document OpenAPI est public et décrit chaque route, de sorte que la plupart des outils API et des générateurs de code peuvent l’importer directement sans clé.

Authorization: Bearer YOUR_API_KEY fonctionne également. Ce que vous ne pouvez pas faire, c’est envoyer une mauvaise clé en espérant qu’elle soit ignorée au profit d’autre chose : une fois qu’une clé est présentée, la réponse est basée sur cette clé.

Ce qui est renvoyé en cas d’erreur :

Connecter un assistant IA #

Les outils LinkedIn se trouvent sur le même point de terminaison MCP que celui de DM Champ, avec la même clé API, donc un assistant que vous avez déjà connecté les détectera automatiquement. Si vous n’en avez pas encore connecté, suivez Connecter des assistants IA (MCP) et utilisez le point de terminaison qui y est indiqué.

Les outils LinkedIn sont tous préfixés par linkedin_, ils sont donc faciles à repérer dans la liste d’outils de votre assistant et faciles à demander par leur nom (« utilise les outils LinkedIn pour me montrer ce qui est en file d’attente »). Il n’y a pas d’autorisations par outil : un outil peut faire tout ce que vous pouvez faire dans l’application.

Exemple 1 — n’accepter que les prospects de certains pays #

Votre profil ICP contient les règles que les prospects doivent respecter. Cela définit une liste blanche composée des Pays-Bas et de la Belgique. Les codes de pays sont composés de deux lettres en majuscules.

curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'

Deux choses à savoir. Le corps de la requête est l’ensemble complet des règles, pas un correctif : une règle que vous omettez est désactivée. Et la réponse inclut un bloc impact_on_queue vous indiquant combien de demandes de connexion déjà en file d’attente échoueraient face aux nouvelles règles, par exemple {"examined": 389, "would_withdraw": 155}. Enregistrer des règles ne retire rien par soi-même.

Dans un assistant, vous diriez simplement : « Définis mon ICP pour n’accepter que les Pays-Bas et la Belgique, et dis-moi ce que cela impliquerait pour ma file d’attente. »

Exemple 2 — voir ce qui est en file d’attente #

Demandes de connexion qui ont été approuvées mais pas encore envoyées :

curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Chaque ligne contient le nom de la personne, son titre, son entreprise, son lieu, son pays, son nombre de relations et d’abonnés, ainsi que son score. Vous pouvez restreindre la liste avec country, min_score, max_score et source, et la parcourir avec limit et cursor. Seules les demandes en file d’attente et en attente d’approbation apparaissent ici. Les demandes déjà envoyées appartiennent à l’historique et ne peuvent pas être modifiées.

Exemple 3 — retirer toutes les personnes en dehors de vos pays #

Après avoir modifié vos règles, vérifiez à nouveau la file d’attente par rapport à celles-ci. Sans apply=true, il s’agit d’un aperçu qui ne modifie rien :

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
  -H "X-API-Key: YOUR_API_KEY"

Vous obtenez le nombre de personnes examinées, le nombre de demandes qui seraient retirées, et une répartition par règle, telle que country et network_too_small (le réseau du prospect était plus petit que votre minimum). Satisfait du résultat ? Exécutez-le à nouveau avec ?apply=true et ces demandes seront retirées.

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
  -H "X-API-Key: YOUR_API_KEY"

Si vous préférez retirer un ensemble spécifique, publiez plutôt les identifiants, ou un filtre tel que {"filter":{"status":"queued","country":"NG"}} pour vider tout ce qui correspond. Envoyez des identifiants ou un filtre, mais pas les deux.

Dépannage #

• 401 sur chaque appel — la clé est manquante ou incorrecte. Copiez-la à nouveau depuis Paramètres → Intégrations → Clé API.
• 403 bien que la clé fonctionne ailleurs — ce compte n’est pas lié à un espace de travail LinkedIn, ou LinkedIn n’est pas encore activé pour celui-ci.
• 502 dmchamp_unreachable — un problème temporaire lors de la vérification de votre clé. Rien n’a été autorisé ; réessayez.
• Une règle ne correspond à rien — les codes de pays doivent être sous la forme de deux lettres majuscules (NL, pas Netherlands ou nl), et les codes de langue doivent être en minuscules.
• L’assistant n’affiche aucun outil LinkedIn — reconnectez-le pour qu’il recharge la liste des outils, et vérifiez que vous utilisez la même clé API.

Étapes suivantes #

• Connecter des assistants IA (MCP) — configurez Claude, ChatGPT ou Cursor avec votre clé.
• Accès API — générez ou faites pivoter la clé utilisée ici.