SalesTouch Docs
Tutti gli strumenti MCP
Sola letturaLinkedIn

Cerca lead

leads_search

Cerca nella directory dei lead del workspace per identità, stato CRM, stato della casella, tag, fonte e date di contatto tramite messaggio.

Quando usarlo

Trova e segmenta i lead già osservati da SalesTouch senza analizzare le conversazioni LinkedIn.

Scope richiesti
linkedin:accesssalestouch:use
Esecuzione
Chiamata sincrona a uno strumento MCP

Requisiti

Tutti i filtri sono facoltativi e si applicano al workspace corrente.

Esempio

Chiedi al tuo agente

Trova i lead contattati con il tag Founder il cui ultimo messaggio inviato risale agli ultimi 90 giorni.

Argomenti dello strumento
{
  "crm_status": [
    "Contacted"
  ],
  "tags_any": [
    "Founder"
  ],
  "limit": 25
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Un elenco impaginato tramite cursore con mini-profili, stati CRM e della casella, tag, date di contatto e riepiloghi delle fonti.

Parametri

query
string

Text matched against lead names, headline, LinkedIn URL, e known identities.

crm_status
array

Additional tool input.

inbox_status
array

Stato operativo dei messaggi: NOT_CONTACTED significa che non è stato inviato alcun messaggio in uscita; OUTREACH_SCHEDULED significa che un messaggio in uscita è in coda; AWAITING_PROSPECT_REPLY significa che l’ultimo messaggio è nostro; PROSPECT_REPLIED significa che l’ultimo messaggio proviene dal prospect.

tags_any
array

Additional tool input.

tags_all
array

Additional tool input.

source_type
string

Tipo esatto della fonte del lead.

source_id
string

ID esatto della fonte del lead restituito da lead_status o leads_search.

last_contacted_from
string

Limite inferiore inclusivo for l’ultimo messaggio LinkedIn inviato.

last_contacted_to
string

Limite superiore inclusivo for l’ultimo messaggio LinkedIn inviato.

last_inbound_from
string

Limite inferiore inclusivo for l’ultimo messaggio LinkedIn ricevuto.

last_inbound_to
string

Limite superiore inclusivo for l’ultimo messaggio LinkedIn ricevuto.

sort
string

Ordinamento dei lead. Valore predefinito: updated_desc.

cursor
string

Cursore opaco di impaginazione dei lead. Riutilizzalo solo con gli stessi filtri e lo stesso ordinamento.

limit
integer

Numero massimo di lead da restituire. Valore predefinito: 25.

Gli alias sono mostrati separatamente perché i client MCP inviano un oggetto JSON piatto. Usa un solo alias per ogni gruppo obbligatorio, non tutti gli alias.

Errori comuni

insufficient_scope

Ricollega l’MCP e approva l’autorizzazione LinkedIn richiesta.

paid_plan_required

Usa un workspace SalesTouch con accesso all’MCP LinkedIn.

trial_payment_method_required

Aggiungi un metodo di pagamento nella fatturazione SalesTouch per attivare la prova e l’accesso all’MCP LinkedIn.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati