SalesTouch Docs
Alle MCP-Tools
Nur LesenLinkedIn

Nachrichten einer LinkedIn-Konversation

linkedin_conversations_messages

Lies eine Nachrichtenseite des Anbieters aus einer über Chat-ID oder Zielprofil ermittelten linkedin-Konversation. order steuert nur die Darstellung innerhalb dieser Seite; undurchsichtige Cursor führen unabhängig von order zu älteren Seiten. Eine Seite enthält nicht den vollständigen Verlauf.

Wann verwenden

Lade eine Seite des Nachrichtenverlaufs vom Anbieter für eine bekannte Konversation oder ein bekanntes Mitglied.

Erforderliche Scopes
linkedin:accesssalestouch:use
Ausführung
Synchroner MCP-Tool-Aufruf

Voraussetzungen

Gib eine linkedin_conversation_id/chat_id/thread_id oder ein Mitgliedsziel an.
account_id ist optional, wenn SalesTouch ein verbundenes Konto automatisch ermitteln kann.
Verwende den zurückgegebenen cursor unverändert mit derselben Konversation und denselben Filtern, solange has_more true ist. Jede Fortsetzung lädt unabhängig von order eine ältere Anbieterseite; oldest_first ist innerhalb jeder Seite chronologisch, nicht über Seitengrenzen hinweg.

Beispiel

Frage deinen Agenten

Lies bis zu 50 Nachrichten mit https://www.linkedin.com/in/example, innerhalb der Seite die ältesten zuerst. Solange has_more true ist, verwende den zurückgegebenen cursor, um ältere Seiten mit denselben Einstellungen zu lesen.

Tool-Argumente
{
  "identifier": "https://www.linkedin.com/in/example",
  "limit": 50,
  "order": "oldest_first"
}
MCP-Antwortumschlag
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Eine Seite normalisierter Nachrichten mit Konversationsteilnehmern, cursor und has_more. Eine einzelne Seite darf nicht als vollständiger Konversationsverlauf behandelt werden. Gibt es noch keine Konversation mit dem Mitglied, ist items leer, conversation null und conversation_found false.

Parameter

account_id
string

ID, Benutzername, E-Mail, Handle oder Konto-URL des verbundenen SalesTouch-Kontos.

identifier
string

Handle, öffentliche ID, Konto-ID oder Profil-URL des LinkedIn-Mitglieds.

lead_id
string

Kanonische SalesTouch-Lead-ID. Wird lokal vor jeder Anfrage an den LinkedIn-Anbieter aufgelöst.

cursor
string

Undurchsichtiger Anbieter-Cursor aus der vorherigen Seite. Er ruft unabhängig von order ältere Seiten ab.

before
string

Obere Grenze für UTC-Datum und -Uhrzeit im ISO-8601-Format.

after
string

Untere Grenze für UTC-Datum und -Uhrzeit im ISO-8601-Format.

linkedin_conversation_id
string

LinkedIn-Gesprächs-ID oder Chat-ID des Anbieters. Nicht mit conversation_id verwechseln, das die PostHog-MCP-Analysesitzung enthält.

limit
integer

Höchstzahl der Nachrichten to return per page. Standard: 50.

sender_id
string

Nachrichten nach Absender-ID des Anbieters filtern.

include_participants
boolean

Normalisierte Gesprächsteilnehmer einschließen. Standard: true.

order
string

Nachrichtenreihenfolge nur innerhalb jeder Anbieterseite. Standard: oldest_first. Ändert nicht die Cursor-Richtung zu älteren Seiten.

Aliasse werden einzeln angezeigt, da MCP-Clients ein flaches JSON-Objekt senden. Verwende pro erforderlicher Gruppe genau einen Alias, nicht alle Aliasse.

Häufige Fehler

insufficient_scope

Verbinde das MCP erneut und genehmige die angeforderte LinkedIn-Berechtigung.

paid_plan_required

Folge der action_url des Fehlers: Starte die kostenlose Testphase, wähle einen Tarif, wenn die Testphase oder das Abo beendet ist, oder aktualisiere die Zahlungsmethode nach einer fehlgeschlagenen Zahlung. details.reason nennt den Fall.

trial_payment_method_required

Versuche es nach einer Minute erneut, wenn der Checkout gerade abgeschlossen wurde; füge sonst in der SalesTouch-Abrechnung eine Zahlungsmethode hinzu, um die Testphase und den Zugriff auf das LinkedIn-MCP zu aktivieren.

Auf dieser Seite

Wann verwendenVoraussetzungenBeispielParameterHäufige FehlerVerwandte Tools