SalesTouch Docs
Tutti gli strumenti MCP
Sola letturaEmail

Conversazioni email

email_conversations

Elenca e cerca le conversazioni email con i lead nelle caselle che puoi leggere, dalle più recenti. Filtra per needs_reply (il lead ha scritto per ultimo), awaiting_reply, casella, data o testo in oggetti, messaggi, mittenti e nomi dei lead.

Quando usarlo

Trova le conversazioni email che aspettano una risposta o cerca email passate con i lead in tutte le tue caselle.

Scope richiesti
email:accesssalestouch:use
Esecuzione
Chiamata sincrona a uno strumento MCP

Requisiti

Collega almeno una casella; vengono salvate solo le conversazioni con i lead.

Esempio

Chiedi al tuo agente

Quali lead hanno risposto alle mie email e aspettano ancora una risposta?

Argomenti dello strumento
{
  "status": "needs_reply",
  "limit": 20
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Conversazioni dalle più recenti con il lead, la casella, l’indicatore needs_reply, il numero di messaggi e un estratto dell’ultimo messaggio, oltre a next_cursor.

Parametri

query
string

Testo confrontato con oggetti, contenuto dei messaggi, mittenti, nomi dei lead e loro indirizzi email.

status
string

all (predefinito), needs_reply (il lead ha scritto per ultimo) o awaiting_reply (hai scritto tu per ultimo).

account_id
string

Id o indirizzo della casella restituito da email_accounts. Per impostazione predefinita, tutte le caselle che puoi leggere.

since
string

Solo le conversazioni con attività da questa data ISO 8601.

limit
integer

Numero massimo di conversazioni restituite. Valore predefinito: 20.

cursor
string

next_cursor restituito dalla pagina precedente, riutilizzato con gli stessi filtri.

Gli alias sono mostrati separatamente perché i client MCP inviano un oggetto JSON piatto. Usa un solo alias per ogni gruppo obbligatorio, non tutti gli alias.

Errori comuni

insufficient_scope

Ricollega l’MCP e approva l’autorizzazione LinkedIn richiesta.

paid_plan_required

Usa un workspace SalesTouch con accesso all’MCP LinkedIn.

trial_payment_method_required

Aggiungi un metodo di pagamento nella fatturazione SalesTouch per attivare la prova e l’accesso all’MCP LinkedIn.

EMAIL_ACCOUNT_NOT_FOUND

Usa un id o un indirizzo di casella restituito da email_accounts.

INVALID_CURSOR

Ricomincia senza cursor o riutilizza next_cursor esattamente come restituito.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati