SalesTouch Docs
Tous les outils MCP
Envoie des e-mailsEmail

Envoyer un e-mail

email_send

Envoyez un e-mail personnel 1:1 depuis la boîte mail connectée de l’utilisateur, dans un nouveau fil ou en réponse. Les envois respectent les limites quotidiennes, le warmup et les horaires d’envoi de la boîte ; les envois mis en file indiquent scheduled_for. Une réponse sur n’importe quel canal annule la prospection mise en file avant elle, sauf si stop_on_reply vaut false. Pas pour les newsletters ni les envois en masse.

Quand l’utiliser

Envoyez un e-mail personnel à un lead depuis votre propre boîte mail, ou répondez dans un fil d’e-mails existant.

Scopes requis
email:accesssalestouch:use
Exécution
Appel d’outil MCP synchrone

Prérequis

Fournissez lead_id ou to.
Fournissez body, et un subject pour un nouveau fil.
account_id est facultatif : SalesTouch choisit la boîte déjà utilisée avec le lead, puis celle qui a le plus de capacité quotidienne disponible.
Définissez queue à true, ou passez scheduled_for, pour attendre le prochain créneau d’envoi libre au lieu d’échouer à la limite quotidienne.

Exemple

Demandez à votre agent

Envoie à Ada une courte relance par e-mail sur la démo de la semaine dernière et mets-la en file dans mes limites d’envoi.

Arguments de l’outil
{
  "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
}
Enveloppe de réponse MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Résultat attendu : Un résultat envoyé avec les identifiants du fil et du message, ou un résultat en file avec queued_action_id et scheduled_for.

Paramètres

account_id
string

Identifiant ou adresse e-mail d’une boîte mail connectée renvoyé par email_accounts. Par défaut : la boîte déjà utilisée avec le lead, puis celle qui a le plus de capacité quotidienne disponible.

lead_id
string

Identifiant canonique du lead SalesTouch renvoyé par lead_status or leads_search.

to
string

Adresse e-mail du destinataire. Obligatoire sans lead_id ; avec lead_id, elle est rattachée à ce lead.

first_name
string

Prénom du destinataire, enregistré lorsque l’adresse crée un nouveau lead.

last_name
string

Nom de famille du destinataire, enregistré lorsque l’adresse crée un nouveau lead.

subject
string

Objet de l’e-mail. Obligatoire pour un nouveau fil ; les réponses reprennent l’objet du fil.

bodyobligatoire
string

Corps de l’e-mail en texte brut. La signature de la boîte mail est ajoutée.

reply_to_thread_id
string

Identifiant de fil d’e-mails renvoyé par email_threads. La réponse part de la boîte mail de ce fil.

stop_on_reply
boolean

Annule cet e-mail en file si le lead répond sur n’importe quel canal avant l’envoi. Valeur par défaut : true.

scheduled_for
string

Date et heure ISO 8601 future avec fuseau horaire. L’action ne s’exécutera jamais avant cette date et la mise en file est implicite.

queue
boolean

Définissez true pour mettre cette action en file si elle ne peut pas s’exécuter maintenant.

Les alias sont affichés séparément, car les clients MCP envoient un objet JSON plat. Utilisez un seul alias par groupe obligatoire, pas tous les alias.

Erreurs fréquentes

insufficient_scope

Reconnectez le MCP et approuvez l’autorisation LinkedIn demandée.

paid_plan_required

Utilisez un espace de travail SalesTouch avec un accès au MCP LinkedIn.

trial_payment_method_required

Ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.

action_limit_queue_required

Répétez l’appel avec queue défini sur true.

email_account_required

Connectez une boîte mail dans les paramètres SalesTouch, puis réessayez.

email_reconnect_required

Reconnectez la boîte mail dans les paramètres SalesTouch, puis réessayez.

lead_email_missing

Importez une adresse e-mail pour le lead avec leads_import, ou passez to.

email_recipient_suppressed

Ne réessayez pas : cette adresse a déjà rebondi. Trouvez une autre adresse pour le lead.