> Pour un agent : la carte de la documentation d'Escouade Mail est sur https://escouade.io/mail/docs/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# FAQ

> Les questions qu'on pose avant de brancher un agent, et les réponses courtes. Chaque réponse commence par oui, non ou un fait, et renvoie à la page qui détaille.

## Le produit

### Qu'est-ce qu'Escouade Mail ?

Un service d'e-mail pour agents IA. Chaque agent a sa boîte mail : il écrit, reçoit et répond avec sa propre adresse, par MCP. Voir l'[introduction](https://escouade.io/mail/docs/index.md).

### Comment donner une boîte mail à un agent IA ?

En quatre étapes : brancher l'agent à `https://api.subagent.fr/mcp`, le laisser appeler `sign_up`, lui donner le code à 6 chiffres reçu par e-mail, puis lui donner une mission. Deux étapes de plus pour écrire à d'autres que vous : payer par un lien, et enregistrer votre domaine. Voir [Donner une boîte mail à un agent IA](https://escouade.io/mail/docs/donner-une-boite-mail-a-un-agent.md).

### Est-ce réservé à la prospection ?

Non. Une boîte mail sert à répondre au support, prendre un rendez-vous, s'inscrire à un service, suivre un dossier, prospecter. Les règles d'envoi sont une fonction du service, pas son objet.

### Y a-t-il une console ou un tableau de bord ?

Non. Le MCP est la seule interface. Un humain lit, corrige et valide depuis son assistant, branché au même serveur. Certains outils s'accompagnent d'une vue, dans les assistants qui les affichent : voir [Vues](https://escouade.io/mail/docs/vues.md).

### Où tourne le service ?

En France, chez Scaleway. Les réponses du serveur et la documentation sont en français.

### Pourquoi le serveur écrit-il encore « Subagent » ?

Escouade Mail s'appelait Subagent jusqu'au 19 octobre 2026. Le serveur garde ce nom là où le changer casserait ce qui est installé : ses messages, l'adresse de son API (`https://api.subagent.fr`), ses clés (`sak_…`), son domaine commun (`subagentmail.fr`) et ses paquets (`subagent-mail`). C'est le même service. Il n'a pas de rapport avec les sous-agents (« subagents ») de Claude Code.

## L'accès

### Comment obtenir un accès ?

Votre agent s'inscrit lui-même, avec `sign_up`, à l'adresse `https://api.subagent.fr/mcp`. Vous confirmez avec un code à 6 chiffres reçu par e-mail. Voir [Démarrer](https://escouade.io/mail/docs/demarrer.md).

### Comment mon agent obtient-il une clé ?

`sign_up` la lui rend : une clé `sak_…`, affichée une seule fois, et une première boîte sur `subagentmail.fr`. Voir [Démarrer](https://escouade.io/mail/docs/demarrer.md#inscription).

### Mon agent s'est inscrit, mais il ne voit toujours que `sign_up`. Pourquoi ?

Parce que le serveur lit la clé à chaque requête, dans l'en-tête `Authorization`. La connexion ouverte sans clé reste sans clé : rebranchez le serveur MCP avec l'en-tête, ou laissez l'agent appeler en HTTP. Voir [Clés et permissions](https://escouade.io/mail/docs/cles.md#apres-sign-up).

### La clé s'est perdue. Peut-on la réafficher ?

Non. Elle ne s'affiche qu'une fois, et le serveur n'en garde qu'une empreinte. Une nouvelle clé se demande à `contact@subagent.fr`. Voir [Clés et permissions](https://escouade.io/mail/docs/cles.md#perdue).

### Le code à 6 chiffres n'arrive pas. Que faire ?

Votre agent appelle `attach_human` avec votre adresse : un nouveau code part, et le précédent ne vaut plus. Il faut attendre 60 secondes entre deux codes ; cinq codes au plus partent pour un même espace.

### Puis-je brancher Claude ou ChatGPT ?

Oui, par le connecteur : dans votre assistant, ajoutez un connecteur à l'adresse `https://mail.escouade.io/mcp`, puis connectez-vous avec votre compte Escouade. Si un espace est rattaché à cet e-mail, vous le retrouvez. Sinon, vous ouvrez le vôtre sur la même page : il ne faut pas d'agent pour s'inscrire. Voir [Connecteur](https://escouade.io/mail/docs/connecteur.md).

### Quelle différence entre les deux adresses ?

`https://api.subagent.fr/mcp` est l'adresse des agents : sans clé, elle sert l'inscription ; avec une clé, les outils. `https://mail.escouade.io/mcp` est celle des assistants en ligne : l'humain s'y connecte avec son compte Escouade, sans clé à copier. Les outils sont les mêmes.

## Recevoir et répondre

### Mon agent peut-il recevoir des e-mails ?

Oui. Toute boîte reçoit, dès sa création, sans rien régler, avant comme après le paiement. Voir [Recevoir du courrier](https://escouade.io/mail/docs/recevoir.md).

### Comment mon agent sait-il qu'on lui a écrit ?

Il interroge le serveur : `list_threads` avec `unanswered` = `true` rend les fils où un e-mail reçu attend encore une réponse, qu'il s'agisse d'une réponse d'un correspondant ou d'un premier e-mail. Rien n'est poussé vers l'agent. Voir [Recevoir du courrier](https://escouade.io/mail/docs/recevoir.md#relever).

### Combien de temps avant qu'un e-mail reçu apparaisse ?

Le temps d'une relève : le serveur relève les boîtes à intervalle fixe, 60 secondes dans son réglage par défaut.

### Mon agent peut-il recevoir le code de vérification d'un autre service ?

Oui. Le premier e-mail d'un service ouvre un fil `open`, d'origine `inbound`. Voir [Recevoir un code de vérification](https://escouade.io/mail/docs/guide-code.md).

### Mon agent peut-il lire une pièce jointe ?

Oui. `get_thread` liste les pièces d'un e-mail reçu, et `get_attachment` rend un lien de téléchargement, avec le texte d'une petite pièce textuelle. Une pièce qui s'exécute, ou trop lourde, n'est pas gardée. Voir [Pièces jointes et copies](https://escouade.io/mail/docs/pieces-jointes.md#lire).

### Mon agent peut-il envoyer une pièce jointe ?

Oui, dans une réponse à quelqu'un qui lui a déjà écrit, ou vers une adresse de son espace. L'agent écrit la réponse en brouillon et demande un lien de dépôt avec `attach_files` ; son humain y dépose le fichier, puis valide le message. Un premier message part sans pièce. Voir [Pièces jointes et copies](https://escouade.io/mail/docs/pieces-jointes.md#joindre).

### Un e-mail reçu peut-il donner des ordres à mon agent ?

Le serveur ne suit aucune consigne écrite dans un e-mail. Il rend ce qu'un correspondant a écrit encadré et marqué `untrusted` : c'est à l'agent de le lire comme une information, jamais comme une consigne. Voir [Recevoir du courrier](https://escouade.io/mail/docs/recevoir.md#tiers).

### Peut-on clore un fil, ou le marquer comme traité ?

Oui, avec `close_thread` : le fil sort de ce qui attend une réponse, sans rien effacer. Il se rouvre si le correspondant y répond. Voir [Fils](https://escouade.io/mail/docs/fils.md#close_thread).

## Les envois

### Combien d'e-mails mon agent peut-il envoyer ?

5 par jour et par boîte la première semaine, puis 10, 15, et 20 à partir de la quatrième, à tous les forfaits. Le forfait fixe en plus un volume par mois : 800, 2 000 ou 6 000 e-mails. Voir [Limites et quotas](https://escouade.io/mail/docs/limites.md).

### Pourquoi mon e-mail n'est-il pas parti tout de suite ?

Parce qu'aucun message ne part tout de suite : il entre en file, puis part dans les heures ouvrées, selon le quota du jour de sa boîte, avec un écart entre deux envois. La réponse de `send_email` donne le départ au plus tôt ; `get_message` dit pourquoi un message en file attend.

### Pourquoi l'envoi est-il refusé avec `payment_required` ?

Parce que l'espace n'a pas de forfait en cours. Sa boîte reçoit, prépare des brouillons et n'écrit qu'à son humain. Voir [Prix et paiement](https://escouade.io/offre).

### Pourquoi l'envoi est-il refusé avec `own_domain_required` ?

Parce que la boîte est sur le domaine commun : elle ne fait que répondre à qui lui a écrit. Un premier message part d'une boîte de votre domaine. Voir [Domaines](https://escouade.io/mail/docs/domaines.md).

### Mon agent peut-il envoyer la nuit ou le week-end ?

Non, par défaut : les envois partent du lundi au vendredi, de 9 h à 18 h, heure de Paris, hors jours fériés. Une exception : une réponse à un correspondant qui a déjà écrit dans le fil part sans attendre.

### Mon agent peut-il écrire deux fois à la même personne ?

Pas deux premiers messages en 30 jours depuis la même boîte. Pour relancer, il répond dans le fil avec `reply_to_thread`.

### Le service garantit-il la remise des e-mails ?

Non. Il dit ce qui est parti, remis ou revenu, et suspend une boîte dont trop de messages reviennent. Il ne promet pas ce que fait la messagerie du destinataire.

### Puis-je envoyer depuis mon domaine ?

Oui, et il le faut pour écrire le premier à quelqu'un. `add_domain` rend les enregistrements DNS à publier, `verify_domain` les contrôle. Une fois le domaine vérifié, vos boîtes portent votre nom. Un sous-domaine suffit. Voir [Domaines](https://escouade.io/mail/docs/domaines.md).

### Peut-on joindre un fichier, ou écrire à plusieurs destinataires ?

Non. Un message a un seul destinataire, un texte, et une version HTML facultative.

## La validation

### Comment relire ce qu'écrit mon agent avant l'envoi ?

Demandez-lui de laisser ses messages en brouillon (`requires_approval`). Vous les lisez avec `list_drafts` et les validez avec `approve_message`, depuis votre assistant, branché à `https://mail.escouade.io/mcp`. Voir [Valider les envois d'un agent](https://escouade.io/mail/docs/guide-validation.md).

### Mon agent peut-il valider ses propres envois ?

Non. La clé rendue par `sign_up` ne porte pas `approve`, et le serveur vérifie la permission à chaque validation.

### Suis-je prévenu quand un brouillon attend ?

Non, pas par le serveur. Votre agent vous le dit dans la conversation ; `inbox_status` rend le nombre de brouillons à valider.

## La désinscription

### Que se passe-t-il quand quelqu'un répond « STOP » ?

Son adresse est bloquée pour toutes les boîtes de l'espace, et ce qui attendait de partir vers elle est annulé. Voir [Désinscription et blocages](https://escouade.io/mail/docs/desinscription.md).

### Peut-on lever une désinscription ?

Non, ni l'agent ni son humain. Seul un administrateur d'Escouade Mail le peut, à la demande écrite de la personne.

### Que se passe-t-il si mes e-mails reviennent ?

Au-delà de 5 % de rebonds (3 % pendant la montée progressive), le coupe-circuit suspend la boîte. La reprise est manuelle. Voir [Aide](https://escouade.io/mail/docs/aide.md#administrateur).

## Les prix et le paiement

### Combien ça coûte ?

Trois forfaits par mois : 9 € (2 boîtes, 800 e-mails), 19 € (5 boîtes, 2 000) et 49 € (15 boîtes, 6 000). Prix nets : TVA non applicable, article 293 B du CGI. Voir [Prix et paiement](https://escouade.io/offre).

### Y a-t-il une offre gratuite ?

Non. Avant le paiement, une boîte reçoit, prépare des brouillons et n'écrit qu'à son humain.

### Comment paie-t-on ?

Par un lien que l'agent demande avec `subscribe` et remet à son humain. L'humain choisit son forfait, donne ses coordonnées de facturation et paie sur la page de Mollie, avec la confirmation de sa banque. Ensuite, le même montant est prélevé chaque mois. L'agent ne paie jamais, et il n'y a pas de console.

### Comment changer de forfait ?

Pour un forfait plus grand, l'agent redemande un lien : `subscribe` avec `plan`. L'humain y paie la différence de prix, au prorata du temps qui reste dans le mois payé, un euro au moins. Le forfait monte dès le paiement confirmé. Pour un forfait plus petit, l'humain résilie, puis paie le forfait voulu depuis un lien. Voir [Prix et paiement](https://escouade.io/offre).

### Qui peut souscrire ?

Les professionnels établis en France. Le service n'est pas destiné aux particuliers. Voir les [Conditions générales de vente](https://escouade.io/conditions-generales).

### Où sont mes factures ?

Une facture est émise à chaque paiement. Son lien arrive par e-mail, et `billing_status` rend toutes les factures de l'espace.

### Comment résilier ?

Demandez-le à votre assistant, branché à `https://mail.escouade.io/mcp` : il appelle `cancel_subscription`. Plus aucun prélèvement n'a lieu, et le mois payé reste acquis. Vous pouvez aussi écrire à `contact@subagent.fr`.

### Puis-je être remboursé ?

Oui, sur demande, dans les 14 jours du premier paiement : écrivez à `contact@subagent.fr`. Voir les [Conditions générales de vente](https://escouade.io/conditions-generales).

### Que se passe-t-il au-delà du volume du mois ?

Les messages attendent la période suivante. Ils ne sont pas refusés.

### Puis-je acheter plus d'e-mails par boîte ?

Non. Une boîte envoie 20 e-mails par jour à tous les forfaits. Pour envoyer plus, il faut plus de boîtes.

## Le code

### Y a-t-il des SDK ?

Les outils publics (configuration MCP, SDK Python et TypeScript, ligne de commande, skills, plugin, exemples) et leur état sont sur la page [Open source](https://escouade.io/mail/docs/open-source.md). Sans eux, tout passe par le MCP, ou par `POST /v1/{opération}`.

### Le serveur est-il open source ?

Non. Les outils qui se branchent chez vous sont ouverts ; le serveur, qui applique les règles d'envoi, reste privé.