Envoyer un e-mail
email_sendEnvoyez un e-mail personnel 1:1 depuis la boîte mail connectée de l’utilisateur, dans un nouveau fil ou en réponse. Un e-mail isolé part immédiatement dans la limite quotidienne de la boîte. Plusieurs e-mails depuis une même boîte en peu de temps nécessitent queue: true ; les envois en file sont espacés selon le warmup et les horaires d’envoi et 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. Des fichiers peuvent être joints. 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.
email:accesssalestouch:usePrérequis
Exemple
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.
{
"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
}{
"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_idstringIdentifiant 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_idstringIdentifiant canonique du lead SalesTouch renvoyé par lead_status or leads_search.
tostringAdresse e-mail du destinataire. Obligatoire sans lead_id ; avec lead_id, elle est rattachée à ce lead.
first_namestringPrénom du destinataire, enregistré lorsque l’adresse crée un nouveau lead.
last_namestringNom de famille du destinataire, enregistré lorsque l’adresse crée un nouveau lead.
subjectstringObjet de l’e-mail. Obligatoire pour un nouveau fil ; les réponses reprennent l’objet du fil.
bodyobligatoirestringCorps de l’e-mail en texte brut. La signature de la boîte mail est ajoutée.
reply_to_thread_idstringIdentifiant de fil d’e-mails renvoyé par email_threads. La réponse part de la boîte mail de ce fil.
stop_on_replybooleanAnnule cet e-mail en file si le lead répond sur n’importe quel canal avant l’envoi. Valeur par défaut : true.
attachmentsarrayFichiers à joindre : 5 au plus, 15 Mo au total. Utilisez un attachment_id de email_messages ou email_threads pour transférer un fichier, une URL HTTPS publique ou des octets en base64 ; le base64 en ligne est limité à 3 Mo par requête, envoyez donc les fichiers plus lourds par url. Les PDF, images, MP4/MOV, documents Office et TXT/CSV/RTF sont acceptés ; le HTML et les exécutables ne le sont pas.
scheduled_forstringDate 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.
queuebooleanDé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_scopeReconnectez le MCP et approuvez l’autorisation LinkedIn demandée.
paid_plan_requiredSuivez l’action_url de l’erreur : démarrez l’essai gratuit, choisissez un forfait si l’essai ou l’abonnement a pris fin, ou mettez à jour le moyen de paiement après un échec de paiement. details.reason indique le cas.
trial_payment_method_requiredRéessayez dans une minute si le paiement vient d’être validé ; sinon ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.
action_limit_queue_requiredRépétez l’appel avec queue défini sur true.
email_account_requiredConnectez une boîte mail dans les paramètres SalesTouch, puis réessayez.
email_reconnect_requiredReconnectez la boîte mail dans les paramètres SalesTouch, puis réessayez.
lead_email_missingImportez une adresse e-mail pour le lead avec leads_import, ou passez to.
email_recipient_suppressedNe réessayez pas : cette adresse a déjà rebondi. Trouvez une autre adresse pour le lead.