SalesTouch Docs
Alle MCP-Tools
Schreibt auf LinkedInLinkedIn

LinkedIn-Nachricht

linkedin_message

Sende eine direkte LinkedIn-Nachricht an ein Zielmitglied.

Wann verwenden

Sende eine Direktnachricht an eine bestehende LinkedIn-Verbindung oder einen bekannten Thread.

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

Voraussetzungen

Gib ein Mitgliedsziel an: identifier, recipient, linkedin_url, profile_url oder handle.
Gib den Nachrichteninhalt mit text, message oder content an.
Das optionale attachments verwendet eine hochgeladene attachment_id, content_base64 oder eine öffentliche HTTPS-url. Höchstens 5 Dateien und insgesamt 60 MB; Inline-content_base64 ist auf 3 MB pro Anfrage begrenzt, größere Dateien daher per url oder attachment_id senden. HTML und lokale Pfade werden nicht unterstützt. Verwende idempotency_key bei Wiederholungen erneut.

Beispiel

Frage deinen Agenten

Sende „Danke für die Vernetzung, ich tausche mich gerne aus.“ an https://www.linkedin.com/in/example.

Tool-Argumente
{
  "linkedin_url": "https://www.linkedin.com/in/example",
  "text": "Thanks for connecting, happy to compare notes.",
  "queue": true
}
MCP-Antwortumschlag
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Ein Ergebnis für eine gesendete oder eingereihte Nachricht mit ihrer Aktionskennung.

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.

queue
boolean

Auf true setzen, um diese Aktion einzureihen, wenn sie jetzt nicht ausgeführt werden kann.

scheduled_for
string

Zukünftiges ISO-8601-Datum mit Zeitzone. Die Aktion wird niemals vor diesem Zeitpunkt ausgeführt und automatisch eingereiht.

text
string

Zu sendender Nachrichtentext. Required unless attachments are provided.

attachments
array

Native Nachrichtenanhänge: höchstens 5 Dateien und insgesamt 60 MB. Verwende eine hochgeladene attachment_id, eine öffentliche HTTPS-URL oder Base64-Daten; Inline-Base64 ist auf 3 MB pro Anfrage begrenzt, größere Dateien daher per url oder attachment_id senden. Lokale Pfade und HTML werden nicht unterstützt. Lade ausgewählte Dateien in der App über /api/linkedin/attachments hoch und übergib ihre attachment_id.

idempotency_key
string

Stabiler Schlüssel für eine Nachricht mit Anhängen, höchstens 120 Zeichen. Gleicher Schlüssel und Inhalt führen nie zu zwei Sendungen. Ohne Schlüssel werden identische Nachrichten dedupliziert; ändere ihn bewusst nur für eine neue Sendung.

linkedin_conversation_id
string

Optionale ID einer bestehenden LinkedIn-Unterhaltung. conversation_id ist für die MCP-Analysesitzung reserviert.

bypass_rate_limit
boolean

Antwortabhängiges Warteschlangenverhalten überschreiben. Nachrichten an Leads, die bereits geantwortet haben, umgehen standardmäßig die Limits für eingereihte Sendungen, sofern queue oder scheduled_for nicht gesetzt ist.

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.

action_limit_queue_required

Wiederhole den Aufruf mit queue auf true.

message_requires_connection

Das Mitglied ist kein Kontakt 1. Grades und der Account kann ihm keine InMail senden. Rufe retry_tool (linkedin_invite_then_message) mit retry_with auf; wiederhole linkedin_message nicht.

inmail_credits_exhausted

Der Account hat keine InMail-Credits mehr. Verwende linkedin_invite_then_message oder warte, bis die Credits wieder aufgefüllt sind.

message_too_long

Kürze den Text und sende ihn erneut.

recipient_unreachable

LinkedIn stellt diesem Mitglied von diesem Account aus nichts zu. Nicht erneut versuchen.

Auf dieser Seite

Wann verwendenVoraussetzungenBeispielParameterHäufige FehlerVerwandte Tools