SalesTouch Docs
Tous les outils MCP
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

query
string

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

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.

last_contacted_from
string

Borne inférieure incluse for le dernier message LinkedIn envoyé.

last_contacted_to
string

Borne supérieure incluse for le dernier message LinkedIn envoyé.

last_inbound_from
string

Borne inférieure incluse for le dernier message LinkedIn reçu.

last_inbound_to
string

Borne supérieure incluse for le dernier message LinkedIn reçu.

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

Utilisez un espace de travail SalesTouch avec un accès au MCP LinkedIn.

trial_payment_method_required

Ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.