Sendet E-MailsEmail

E-Mail senden

email_send

Sende eine persönliche 1:1-E-Mail aus dem eigenen verbundenen Postfach des Nutzers, als neuen Verlauf oder als Antwort. Sendungen beachten Tageslimits, Warmup und Arbeitszeiten des Postfachs; eingeplante Sendungen melden scheduled_for. Eine Antwort auf einem beliebigen Kanal storniert vorher eingeplante Ansprache, außer stop_on_reply ist false. Nicht für Newsletter oder Massen-E-Mails.

Wann verwenden

Sende einem Lead eine persönliche E-Mail aus deinem eigenen Postfach oder antworte in einem bestehenden E-Mail-Verlauf.

Erforderliche Scopes

email:accesssalestouch:use

Ausführung

Synchroner MCP-Tool-Aufruf

Voraussetzungen

Gib lead_id oder to an.

Gib body an und für einen neuen Verlauf zusätzlich subject.

account_id ist optional: SalesTouch wählt das bereits mit dem Lead genutzte Postfach, sonst das mit der meisten freien Tageskapazität.

Setze queue auf true oder übergib scheduled_for, um auf den nächsten freien Versandslot zu warten, statt am Tageslimit zu scheitern.

Beispiel

Frage deinen Agenten

Schicke Ada ein kurzes Follow-up per E-Mail zur Demo von letzter Woche und plane es innerhalb meiner Versandlimits ein.

Tool-Argumente

{
  "lead_id": "lead_example",
  "subject": "Following up on the demo",
  "body": "Hi Ada,\n\nThanks again for your time last week. Would a short call on Thursday work?\n\nBest,",
  "queue": true
}

MCP-Antwortumschlag

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Ein gesendetes Ergebnis mit Verlaufs- und Nachrichten-ID oder ein eingeplantes Ergebnis mit queued_action_id und scheduled_for.

Parameter

NameTypBeschreibung

account_id

string

ID oder E-Mail-Adresse eines verbundenen Postfachs aus email_accounts. Standard: das bereits mit dem Lead genutzte Postfach, sonst das Postfach mit der meisten freien Tageskapazität.

lead_id

string

Kanonische SalesTouch-Lead-ID zurückgegeben von lead_status or leads_search.

to

string

E-Mail-Adresse des Empfängers. Ohne lead_id erforderlich; mit lead_id wird sie diesem Lead zugeordnet.

first_name

string

Vorname des Empfängers, gespeichert, wenn die Adresse einen neuen Lead anlegt.

last_name

string

Nachname des Empfängers, gespeichert, wenn die Adresse einen neuen Lead anlegt.

subject

string

Betreff der E-Mail. Für einen neuen Verlauf erforderlich; Antworten übernehmen den Betreff des Verlaufs.

bodyerforderlich

string

E-Mail-Text als reiner Text. Die Signatur des Postfachs wird angehängt.

reply_to_thread_id

string

ID eines E-Mail-Verlaufs aus email_threads. Die Antwort wird aus dem Postfach dieses Verlaufs gesendet.

stop_on_reply

boolean

Diese eingeplante E-Mail entfällt, wenn der Lead vor dem Versand auf einem beliebigen Kanal antwortet. Standard: true.

scheduled_for

string

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

queue

boolean

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

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

Verwende einen SalesTouch-Workspace mit Zugriff auf das LinkedIn-MCP.

trial_payment_method_required

Füge 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.

email_account_required

Verbinde ein Postfach in den SalesTouch-Einstellungen und versuche es erneut.

email_reconnect_required

Verbinde das Postfach in den SalesTouch-Einstellungen neu und versuche es erneut.

lead_email_missing

Importiere mit leads_import eine E-Mail-Adresse für den Lead oder übergib to.

email_recipient_suppressed

Nicht erneut versuchen: Diese Adresse ist bereits gebounct. Suche eine andere Adresse für den Lead.

E-Mail senden

Wann verwenden

Voraussetzungen

Beispiel

Parameter

Häufige Fehler

Verwandte Tools

Auf dieser Seite