Lecture seuleLinkedIn

Rechercher des leads

leads_search

Recherchez dans le répertoire de leads de l’espace de travail par identité, statut CRM, statut de boîte de réception, tags, source et dates de contact par message.

Quand l’utiliser

Trouvez et segmentez les leads déjà observés par SalesTouch sans analyser les conversations LinkedIn.

Scopes requis

linkedin:accesssalestouch:use

Exécution

Appel d’outil MCP synchrone

Prérequis

Tous les filtres sont facultatifs et s’appliquent à l’espace de travail actuel.

Exemple

Demandez à votre agent

Trouve les leads contactés portant le tag Founder dont le dernier message envoyé date des 90 derniers jours.

Arguments de l’outil

{
  "crm_status": [
    "Contacted"
  ],
  "tags_any": [
    "Founder"
  ],
  "limit": 25
}

Enveloppe de réponse MCP

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

Résultat attendu : Une liste paginée par curseur contenant les mini-profils, les statuts CRM et de boîte de réception, les tags, les dates de contact et les résumés des sources.

Paramètres

NomTypeDescription

crm_scope

string

Périmètre CRM : organization, member:<id> ou group:<id>. Par défaut, votre groupe partagé ou votre CRM personnel.

query

string

Texte comparé aux noms des leads, au titre, à l’URL LinkedIn, aux identités connues et aux adresses e-mail.

crm_status

array

Additional tool input.

inbox_status

array

État opérationnel de la messagerie: NOT_CONTACTED signifie qu’aucun message sortant n’a été envoyé; OUTREACH_SCHEDULED signifie qu’un message sortant est en file; AWAITING_PROSPECT_REPLY signifie que le dernier message vient de nous; PROSPECT_REPLIED signifie que le dernier message vient du prospect.

tags_any

array

Additional tool input.

tags_all

array

Additional tool input.

source_type

string

Type exact de la source du lead.

source_id

string

Identifiant exact de la source du lead renvoyé par lead_status ou leads_search.

has_email

boolean

true pour les leads qui ont une adresse e-mail, false pour ceux qui n’en ont pas.

last_contacted_from

string

Borne inférieure incluse for le dernier message envoyé, sur LinkedIn ou par e-mail.

last_contacted_to

string

Borne supérieure incluse for le dernier message envoyé, sur LinkedIn ou par e-mail.

last_inbound_from

string

Borne inférieure incluse for le dernier message reçu, sur LinkedIn ou par e-mail.

last_inbound_to

string

Borne supérieure incluse for le dernier message reçu, sur LinkedIn ou par e-mail.

sort

string

Ordre des leads. Par défaut : updated_desc.

cursor

string

Curseur opaque de pagination des leads. Réutilisez-le uniquement avec les mêmes filtres et le même ordre de tri.

limit

integer

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

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.

Rechercher des leads

Quand l’utiliser

Prérequis

Exemple

Paramètres

Erreurs fréquentes

Outils associés

Sur cette page