SalesTouch Docs
Tutti gli strumenti MCP
Sola letturaLinkedIn

Messaggi di una conversazione LinkedIn

linkedin_conversations_messages

Leggi una pagina di messaggi del provider da una conversazione linkedin individuata tramite id chat o profilo. order controlla solo la presentazione nella pagina; i cursori opachi percorrono pagine più vecchie indipendentemente da order. Una pagina non contiene la cronologia completa.

Quando usarlo

Carica una pagina della cronologia dei messaggi del provider per una conversazione o un membro noto.

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

Requisiti

Fornisci un linkedin_conversation_id/chat_id/thread_id o un membro di destinazione.
account_id è facoltativo quando SalesTouch può individuare automaticamente un account collegato.
Riutilizza il cursor restituito senza modificarlo con la stessa conversazione e gli stessi filtri finché has_more è true. Ogni continuazione carica una pagina più vecchia del provider indipendentemente da order; oldest_first è cronologico nella singola pagina, non tra pagine.

Esempio

Chiedi al tuo agente

Leggi fino a 50 messaggi con https://www.linkedin.com/in/example, dai più vecchi ai più recenti nella pagina. Finché has_more è true, usa il cursor restituito per leggere pagine più vecchie con le stesse impostazioni.

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

Risultato atteso: Una pagina di messaggi normalizzati con partecipanti, cursor e has_more. Una singola pagina non deve essere considerata la cronologia completa della conversazione. Se non esiste ancora una conversazione con il membro, items è vuoto, conversation è null e conversation_found è false.

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.

cursor
string

Cursore opaco del provider restituito dalla pagina precedente. Recupera pagine più vecchie indipendentemente da order.

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.

linkedin_conversation_id
string

ID conversazione LinkedIn o ID chat del provider. Non confonderlo con conversation_id, che contiene la sessione di analisi MCP PostHog.

limit
integer

Numero massimo di messaggi to return per page. Valore predefinito: 50.

sender_id
string

Filtra i messaggi per ID mittente del provider.

include_participants
boolean

Includi i partecipanti normalizzati alla conversazione. Valore predefinito: true.

order
string

Ordine dei messaggi solo all’interno di ogni pagina del provider. Valore predefinito: oldest_first. Non cambia il percorso del cursore verso pagine più vecchie.

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

Segui l’action_url dell’errore: avvia la prova gratuita, scegli un piano se la prova o l’abbonamento è terminato, oppure aggiorna il metodo di pagamento dopo un pagamento non riuscito. details.reason indica il caso.

trial_payment_method_required

Riprova tra un minuto se hai appena completato il checkout; altrimenti 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