SalesTouch Docs
Tutti gli strumenti MCP
Sola letturaLinkedIn

Conversazioni LinkedIn

linkedin_conversations_list

Elenca le conversazioni recenti di messaggistica LinkedIn dagli account collegati.

Quando usarlo

Leggi il feed globale unificato delle conversazioni LinkedIn oppure scorri flussi espliciti Classic, Sales Navigator, aziendali, di cartella o per id casella.

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

Requisiti

account_id è facoltativo quando SalesTouch può individuare automaticamente un account collegato.
Ometti inbox_tags per il feed globale deduplicato; usa uno o più tag restituiti da linkedin_inboxes_list per restringerlo.
Riutilizza un cursore solo con gli stessi account, filtri data/non letti, selezione delle caselle e valore sort_by.

Esempio

Chiedi al tuo agente

Elenca le mie 20 conversazioni LinkedIn non lette più recenti e includi i partecipanti.

Argomenti dello strumento
{
  "limit": 20,
  "unread": true,
  "include_participants": true
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Un elenco impaginato stabile con metadati di prodotto/cartella delle caselle e un cursore multi-casella opaco legato alla query.

Parametri

account_id
string

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

cursor
string

Cursore di impaginazione.

before
string

Limite superiore di data e ora UTC in formato ISO 8601.

after
string

Limite inferiore di data e ora UTC in formato ISO 8601.

inbox_tags
array

Tag leggibili restituiti da linkedin_inboxes_list. I valori vengono combinati con OR. Esempi: classic_primary, sales_navigator, archived, company_primary, company_123_primary, unread. Le viste derivate vengono interrogate solo quando il tag della cartella è esplicito.

sort_by
string

Usa last_message_at per il feed globale unificato (default), oppure inbox per scorrere i flussi in ordine deterministico account/prodotto/cartella.

limit
integer

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

unread
boolean

Filtra conversazioni lette o non lette.

include_participants
boolean

Includi i partecipanti normalizzati alla conversazione.

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