Lecture seuleEmail

Conversations e-mail

email_conversations

Listez et recherchez les conversations e-mail avec vos leads dans les boîtes que vous pouvez lire, des plus récentes aux plus anciennes. Filtrez par needs_reply (le lead a écrit en dernier), awaiting_reply, boîte, date, ou texte dans les objets, les messages, les expéditeurs et les noms des leads.

Quand l’utiliser

Trouvez les conversations e-mail qui attendent une réponse, ou cherchez d’anciens e-mails avec vos leads, dans toutes vos boîtes.

Scopes requis

email:accesssalestouch:use

Exécution

Appel d’outil MCP synchrone

Prérequis

Connectez au moins une boîte mail ; seules les conversations avec des leads sont enregistrées.

Exemple

Demandez à votre agent

Quels leads ont répondu à mes e-mails et attendent encore une réponse ?

Arguments de l’outil

{
  "status": "needs_reply",
  "limit": 20
}

Enveloppe de réponse MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Résultat attendu : Les conversations, des plus récentes aux plus anciennes, avec le lead, la boîte mail, l’indicateur needs_reply, le nombre de messages et un extrait du dernier message, ainsi que next_cursor.

Paramètres

NomTypeDescription

query

string

Texte comparé aux objets, au contenu des messages, aux expéditeurs, aux noms des leads et à leurs adresses e-mail.

status

string

all (par défaut), needs_reply (le lead a écrit en dernier) ou awaiting_reply (vous avez écrit en dernier).

account_id

string

Identifiant ou adresse de boîte mail renvoyé par email_accounts. Par défaut, toutes les boîtes que vous pouvez lire.

since

string

Uniquement les conversations actives depuis cette date ISO 8601.

limit

integer

Nombre maximal de conversations renvoyées. Par défaut : 20.

cursor

string

next_cursor renvoyé par la page précédente, réutilisé avec les mêmes filtres.

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.

EMAIL_ACCOUNT_NOT_FOUND

Utilisez un identifiant ou une adresse de boîte renvoyé par email_accounts.

INVALID_CURSOR

Recommencez sans cursor, ou réutilisez next_cursor tel qu’il a été renvoyé.

Conversations e-mail

Quand l’utiliser

Prérequis

Exemple

Paramètres

Erreurs fréquentes

Outils associés

Sur cette page