SalesTouch Docs
Alle MCP-Tools
Schreibt auf LinkedInLinkedIn

Leads importieren oder ergänzen

leads_import

Importiere neue Leads oder aktualisiere und ergänze bestehende Kontakte (bis zu 1000 pro Aufruf). Verwende dieses Tool, um einem bestehenden LinkedIn-Lead eine E-Mail-Adresse hinzuzufügen: Gib seine linkedin_url und email an. Der Abgleich erfolgt zuerst über vorhandene E-Mail-Adressen, dann über LinkedIn-Profile; Namen allein identifizieren keine Leads. Fehlende Profilfelder werden ergänzt, bestehende Werte bleiben erhalten und Tags werden hinzugefügt. Es werden nur Kontaktdaten gespeichert; keine Nachrichten werden gesendet.

Wann verwenden

Importiere neue Leads oder ergänze bestehende Kontakte, etwa durch eine E-Mail-Adresse für einen bereits in SalesTouch vorhandenen LinkedIn-Lead.

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

Voraussetzungen

Gib jedem Lead eine E-Mail-Adresse oder eine LinkedIn-Profil-URL.
Gib für einen bestehenden LinkedIn-Kontakt seine aktuelle linkedin_url und die hinzuzufügende email an; finde ihn zuerst mit leads_search.
Bestehende Profilwerte bleiben erhalten: Nur fehlende Felder werden ergänzt und Tags hinzugefügt. Ein Abgleich über Name oder lead_id wird nicht unterstützt.
Wenn die E-Mail-Adresse und das LinkedIn-Profil zu zwei verschiedenen Leads gehören, werden sie im LinkedIn-Lead zusammengeführt und die Zeile gibt die Warnung merged_with_existing_linkedin_lead zurück; verwende danach die zurückgegebene lead_id.
Sende höchstens 1000 Leads pro Aufruf und teile größere Listen in Pakete auf.

Beispiel

Frage deinen Agenten

Importiere Grace als neuen Lead und füge ada@example.com zum bestehenden LinkedIn-Kontakt https://www.linkedin.com/in/example hinzu.

Tool-Argumente
{
  "leads": [
    {
      "email": "grace@example.com",
      "phone": "+1 202 555 0143",
      "first_name": "Grace",
      "last_name": "Hopper"
    },
    {
      "linkedin_url": "https://www.linkedin.com/in/example",
      "email": "ada@example.com"
    }
  ],
  "source_name": "Webinar October",
  "tags": [
    "Webinar"
  ]
}
MCP-Antwortumschlag
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Anzahl erstellter, ergänzter und übersprungener Kontakte, Fehler und Warnungen pro Zeile sowie die lead_id jedes gespeicherten Kontakts. Eine Aktualisierung bedeutet nicht, dass vorhandene Profilfelder überschrieben wurden.

Parameter

leadserforderlich
array

Neue Leads zum Importieren oder bestehende Kontakte zum Ergänzen, höchstens 1000 pro Aufruf. Jede Zeile benötigt email oder linkedin_url. Gib beide Felder in derselben Zeile an, um einem bestehenden LinkedIn-Kontakt eine E-Mail-Adresse hinzuzufügen.

source_name
string

Importname, der als Lead-Quelle gespeichert wird, zum Beispiel ein Listen- oder Eventname.

tags
array

Tags, die jedem importierten Lead hinzugefügt werden.

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.

invalid_input

Sende zwischen 1 und 1000 Leads, jeweils mit gültiger E-Mail-Adresse oder LinkedIn-Profil-URL.