SalesTouch Docs
Tutti gli strumenti MCP
Invia emailEmail

Invia email

email_send

Invia un’email personale 1:1 dalla casella collegata dell’utente, come nuovo thread o come risposta. Gli invii rispettano i limiti giornalieri, il warmup e gli orari di lavoro della casella; gli invii in coda riportano scheduled_for. Una risposta su qualsiasi canale annulla l’outreach messo in coda prima di essa, salvo che stop_on_reply sia false. Non adatto a newsletter o invii massivi.

Quando usarlo

Invia un’email personale a un lead dalla tua casella oppure rispondi in un thread email esistente.

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

Requisiti

Fornisci lead_id o to.
Fornisci body e, per un nuovo thread, subject.
account_id è facoltativo: SalesTouch sceglie la casella già usata con il lead, poi quella con più capacità giornaliera libera.
Imposta queue su true, o passa scheduled_for, per attendere il prossimo slot di invio libero invece di fallire al limite giornaliero.

Esempio

Chiedi al tuo agente

Invia ad Ada un breve follow-up via email sulla demo della settimana scorsa e mettilo in coda entro i miei limiti di invio.

Argomenti dello strumento
{
  "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
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Un risultato inviato con gli id del thread e del messaggio, oppure un risultato in coda con queued_action_id e scheduled_for.

Parametri

account_id
string

Id o indirizzo email di una casella collegata restituito da email_accounts. Predefinito: la casella già usata con il lead, poi quella con più capacità giornaliera libera.

lead_id
string

ID canonico del lead SalesTouch restituito da lead_status or leads_search.

to
string

Indirizzo email del destinatario. Obbligatorio senza lead_id; con lead_id viene associato a quel lead.

first_name
string

Nome del destinatario, salvato quando l’indirizzo crea un nuovo lead.

last_name
string

Cognome del destinatario, salvato quando l’indirizzo crea un nuovo lead.

subject
string

Oggetto dell’email. Obbligatorio per un nuovo thread; le risposte riutilizzano l’oggetto del thread.

bodyobbligatorio
string

Corpo dell’email in testo semplice. Viene aggiunta la firma della casella.

reply_to_thread_id
string

Id del thread email restituito da email_threads. La risposta parte dalla casella di quel thread.

stop_on_reply
boolean

Salta questa email in coda se il lead risponde su qualsiasi canale prima dell’invio. Valore predefinito: true.

scheduled_for
string

Data e ora ISO 8601 futura con fuso orario. L’azione non verrà mai eseguita prima di questo momento e l’accodamento è implicito.

queue
boolean

Imposta true per mettere in coda l’azione quando non può essere eseguita ora.

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.

action_limit_queue_required

Ripeti la chiamata con queue impostato su true.

email_account_required

Collega una casella nelle impostazioni di SalesTouch, poi riprova.

email_reconnect_required

Ricollega la casella nelle impostazioni di SalesTouch, poi riprova.

lead_email_missing

Importa un indirizzo email per il lead con leads_import oppure passa to.

email_recipient_suppressed

Non riprovare: questo indirizzo è già rimbalzato. Trova un altro indirizzo per il lead.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati