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.

Espaces de travail client et marque blanche #

Lorsqu’une agence revend des services de prospection LinkedIn sous sa propre marque, chaque espace de travail client dispose de ses propres clés API au lieu de la clé globale du compte mentionnée ci-dessus :

• Clés par espace de travail. Le client crée ses clés dans les Paramètres de l’espace de travail. Une clé n’accède qu’aux données de cet espace de travail ; les pages propres à l’agence (clients, image de marque, facturation) renverront une erreur “non trouvé” avec cette clé.
• Les adresses se trouvent sur la carte Paramètres de cet espace de travail. Sur un domaine personnalisé, la carte affiche l’adresse API sur ce domaine (https://<your brand domain>/api/v1), l’adresse MCP à coller dans un assistant IA, ainsi qu’un lien vers la documentation d’aide, le tout sous la marque de l’agence.
• L’interrupteur d’accès API de l’agence. Une agence qui gère sa prospection LinkedIn en tant que marque indépendante dispose d’un interrupteur Accès API par client sur sa page Clients, activé par défaut. Lorsqu’il est désactivé, les clés du client sont refusées en moins d’une minute et la carte API disparaît de ses Paramètres. Le réactiver permet de restaurer les mêmes clés. Les clés d’un client suspendu sont également refusées.

Pour le volet agence de cette fonctionnalité, consultez Revendre la prospection LinkedIn à vos clients.

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 est l’ensemble complet des règles, et non un correctif : une règle que vous omettez est désactivée. De plus, la réponse inclut un bloc impact_on_queue vous indiquant combien de demandes de connexion déjà en file d’attente échoueraient aux nouvelles règles, par exemple {"examined": 389, "would_withdraw": 155}. Une fois enregistrées, les nouvelles règles sont appliquées automatiquement à la file d’attente : les demandes en attente qui ne les respectent pas sont retirées.

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 ou Cursor avec votre clé.
• Accès API — générez ou faites pivoter la clé utilisée ici.