Lecture seuleLinkedIn

Messages d’une conversation LinkedIn

linkedin_conversations_messages

Lisez une page de messages du fournisseur pour une conversation linkedin identifiée par un chat ou un profil cible. order contrôle uniquement la présentation dans cette page ; les curseurs opaques parcourent les pages plus anciennes quel que soit order. Une page ne constitue pas l’historique complet.

Quand l’utiliser

Chargez une page de l’historique des messages du fournisseur pour une conversation ou un membre connu.

Scopes requis

linkedin:accesssalestouch:use

Exécution

Appel d’outil MCP synchrone

Prérequis

Fournissez un linkedin_conversation_id/chat_id/thread_id ou une cible membre.

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

Réutilisez le cursor renvoyé sans le modifier, avec la même conversation et les mêmes filtres, tant que has_more est true. Chaque continuation charge une page plus ancienne du fournisseur quel que soit order ; oldest_first est chronologique dans chaque page, pas entre les pages.

Exemple

Demandez à votre agent

Lis jusqu’à 50 messages avec https://www.linkedin.com/in/example, du plus ancien au plus récent dans la page. Tant que has_more est true, utilise le cursor renvoyé pour lire les pages plus anciennes avec les mêmes paramètres.

Arguments de l’outil

{
  "identifier": "https://www.linkedin.com/in/example",
  "limit": 50,
  "order": "oldest_first"
}

Enveloppe de réponse MCP

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

Résultat attendu : Une page de messages normalisés avec les participants, cursor et has_more. Une seule page ne doit pas être considérée comme l’historique complet de la conversation. Quand aucune conversation n’existe encore avec ce membre, items est vide, conversation vaut null et conversation_found vaut false.

Paramètres

NomTypeDescription

account_id

string

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

identifier

string

Handle, identifiant public, identifiant de compte ou URL de profil du membre LinkedIn.

lead_id

string

Identifiant canonique du lead SalesTouch. Résolu localement avant toute requête au fournisseur LinkedIn.

cursor

string

Curseur opaque du fournisseur renvoyé par la page précédente. Il récupère des pages plus anciennes quel que soit order.

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.

linkedin_conversation_id

string

Identifiant de conversation LinkedIn ou identifiant de chat du fournisseur. Ne le confondez pas avec conversation_id, qui porte la session d’analyse MCP PostHog.

limit

integer

Nombre maximal de messages to return per page. Par défaut : 50.

sender_id

string

Filtrer les messages par identifiant d’expéditeur du fournisseur.

include_participants

boolean

Inclure les participants normalisés de la conversation. Par défaut : true.

order

string

Ordre des messages uniquement dans chaque page du fournisseur. Valeur par défaut : oldest_first. Ne modifie pas le parcours du curseur vers les pages plus anciennes.

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.

Messages d’une conversation LinkedIn

Quand l’utiliser

Prérequis

Exemple

Paramètres

Erreurs fréquentes

Outils associés

Sur cette page