Lecture seuleLinkedIn

Conversations LinkedIn

linkedin_conversations_list

Listez les conversations LinkedIn récentes des comptes connectés.

Quand l’utiliser

Lisez le flux global unifié des conversations LinkedIn ou parcourez les flux explicites Classic, Sales Navigator, d’entreprise, de dossier ou d’identifiant de boîte.

Scopes requis

linkedin:accesssalestouch:use

Exécution

Appel d’outil MCP synchrone

Prérequis

account_id est facultatif lorsque SalesTouch peut résoudre automatiquement un compte connecté.

Omettez inbox_tags pour le flux global dédupliqué ; utilisez un ou plusieurs tags renvoyés par linkedin_inboxes_list pour le restreindre.

Réutilisez un curseur uniquement avec les mêmes filtres de date/non-lu, sélection de boîtes et valeur sort_by. account_id peut être omis ou restreint à l’un des comptes du curseur.

Quand scan_incomplete vaut true, une page vide ou courte ne signifie pas qu’aucune conversation ne correspond : rappelez l’outil avec le curseur renvoyé et les mêmes filtres.

Exemple

Demandez à votre agent

Liste mes 20 conversations LinkedIn non lues les plus récentes et inclus les participants.

Arguments de l’outil

{
  "limit": 20,
  "unread": true,
  "include_participants": true
}

Enveloppe de réponse MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Résultat attendu : Une liste paginée stable avec les métadonnées de produit/dossier des boîtes et un curseur multi-boîtes opaque lié à la requête.

Paramètres

NomTypeDescription

account_id

string

Identifiant, nom d’utilisateur, e-mail, handle ou URL du compte SalesTouch connecté.

cursor

string

Curseur de pagination.

before

string

Borne supérieure de date et heure UTC au format ISO 8601.

after

string

Borne inférieure de date et heure UTC au format ISO 8601.

inbox_tags

array

Tags lisibles renvoyés par linkedin_inboxes_list. Les valeurs sont combinées avec un OU. Exemples: classic_primary, sales_navigator, archived, company_primary, company_123_primary, unread. Les vues dérivées ne sont interrogées que lorsque leur tag de dossier est explicite.

sort_by

string

Utilisez last_message_at pour le fil global unifié (default), ou inbox pour parcourir les flux dans un ordre déterministe compte/produit/dossier.

limit

integer

Nombre maximal de conversations à renvoyer. Par défaut : 25.

unread

boolean

Filtrer les conversations non lues ou lues.

include_participants

boolean

Inclure les participants normalisés de la conversation.

Les alias sont affichés séparément, car les clients MCP envoient un objet JSON plat. Utilisez un seul alias par groupe obligatoire, pas tous les alias.

Erreurs fréquentes

insufficient_scope

Reconnectez le MCP et approuvez l’autorisation LinkedIn demandée.

paid_plan_required

Suivez l’action_url de l’erreur : démarrez l’essai gratuit, choisissez un forfait si l’essai ou l’abonnement a pris fin, ou mettez à jour le moyen de paiement après un échec de paiement. details.reason indique le cas.

trial_payment_method_required

Réessayez dans une minute si le paiement vient d’être validé ; sinon ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.

Conversations LinkedIn

Quand l’utiliser

Prérequis

Exemple

Paramètres

Erreurs fréquentes

Outils associés

Sur cette page