SalesTouch Docs
Tutti gli strumenti MCP
Sola letturaLinkedIn

Ricerca conversazioni LinkedIn

linkedin_conversations_search

Trova conversazioni di messaggistica LinkedIn tramite identità del profilo o ricerca testuale locale.

Quando usarlo

Trova una conversazione a partire dall’identità di un profilo o da un testo presente nei messaggi recenti.

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

Requisiti

Fornisci un membro di destinazione, una query o entrambi.
account_id è facoltativo quando SalesTouch può individuare automaticamente un account collegato.

Esempio

Chiedi al tuo agente

Trova la mia conversazione LinkedIn con https://www.linkedin.com/in/example.

Argomenti dello strumento
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "limit": 5
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Conversazioni corrispondenti ordinate in base alla scansione delle conversazioni recenti.

Parametri

account_id
string

ID, nome utente, e-mail, handle o URL dell’account SalesTouch collegato.

identifier
string

Handle, ID pubblico, ID account o URL del profilo del membro LinkedIn.

lead_id
string

ID canonico del lead SalesTouch. Risolto localmente prima di qualsiasi richiesta al provider LinkedIn.

query
string

Text to match against conversations e recent messaggi.

limit
integer

Numero massimo di conversazioni da restituire. Valore predefinito: 10.

scan_limit
integer

Numero massimo di conversazioni recenti da analizzare. Valore predefinito: 100.

message_scan_limit
integer

Numero massimo di messaggi recenti da analizzare. Valore predefinito: 250.

provider_request_limit
integer

Numero massimo di letture mirate dei messaggi durante il filtro locale del testo. Valore predefinito: 8.

inspected_conversation_ids
array

ID di conversazioni già controllate da questo workflow. Vengono conservati e ignorati alla ripresa.

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