Leads importieren oder ergänzen
leads_importImportiere 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.
linkedin:accesssalestouch:useVoraussetzungen
Beispiel
Importiere Grace als neuen Lead und füge ada@example.com zum bestehenden LinkedIn-Kontakt https://www.linkedin.com/in/example hinzu.
{
"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"
]
}{
"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
leadserforderlicharrayNeue 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_namestringImportname, der als Lead-Quelle gespeichert wird, zum Beispiel ein Listen- oder Eventname.
tagsarrayTags, 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_scopeVerbinde das MCP erneut und genehmige die angeforderte LinkedIn-Berechtigung.
paid_plan_requiredFolge 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_requiredVersuche 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_inputSende zwischen 1 und 1000 Leads, jeweils mit gültiger E-Mail-Adresse oder LinkedIn-Profil-URL.