SalesTouch Docs
Alle MCP-Tools
Nur LesenEmail

E-Mail-Konversationen

email_conversations

Liste und durchsuche E-Mail-Konversationen mit Leads in den Postfächern, die du lesen kannst, die neuesten zuerst. Filtere nach needs_reply (der Lead hat zuletzt geschrieben), awaiting_reply, Postfach, Datum oder Text in Betreffzeilen, Nachrichten, Absendern und Lead-Namen.

Wann verwenden

Finde E-Mail-Konversationen, die eine Antwort brauchen, oder durchsuche frühere E-Mails mit Leads in allen deinen Postfächern.

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

Voraussetzungen

Verbinde mindestens ein Postfach; nur Konversationen mit Leads werden gespeichert.

Beispiel

Frage deinen Agenten

Welche Leads haben auf meine E-Mails geantwortet und warten noch auf eine Antwort?

Tool-Argumente
{
  "status": "needs_reply",
  "limit": 20
}
MCP-Antwortumschlag
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Konversationen, die neuesten zuerst, mit Lead, Postfach, needs_reply-Kennzeichen, Nachrichtenanzahl und einem Auszug der letzten Nachricht sowie next_cursor.

Parameter

query
string

Text, der mit Betreffzeilen, Nachrichtentexten, Absendern, Lead-Namen und Lead-E-Mail-Adressen abgeglichen wird.

status
string

all (Standard), needs_reply (der Lead hat zuletzt geschrieben) oder awaiting_reply (du hast zuletzt geschrieben).

account_id
string

Postfach-ID oder -Adresse aus email_accounts. Standardmäßig alle Postfächer, die du lesen kannst.

since
string

Nur Konversationen mit Aktivität seit diesem ISO-8601-Datum.

limit
integer

Maximale Anzahl zurückgegebener Konversationen. Standard: 20.

cursor
string

next_cursor der vorherigen Seite, mit denselben Filtern wiederverwendet.

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.

EMAIL_ACCOUNT_NOT_FOUND

Verwende eine Postfach-ID oder -Adresse aus email_accounts.

INVALID_CURSOR

Beginne ohne cursor neu oder verwende next_cursor genau so, wie er zurückgegeben wurde.

Auf dieser Seite

Wann verwendenVoraussetzungenBeispielParameterHäufige FehlerVerwandte Tools