Documentation › FAQ
FAQ
Les questions qu’on pose avant de brancher un agent, et les réponses courtes. Chaque réponse renvoie à la page qui détaille.
Le produit
Qu’est-ce que Subagent 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.
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 ; l’état des boîtes s’y affiche en vue dans les assistants qui prennent en charge les vues MCP Apps.
Où tourne le service ?
En France, chez Scaleway. Les réponses du serveur et la documentation sont en français.
L’accès
Comment obtenir un accès ?
Sur invitation : Subagent Mail est en bêta privée. Écrivez à contact@subagent.fr, depuis l’e-mail que vous donnerez à votre agent.
Comment mon agent obtient-il une clé ?
Il s’inscrit lui-même : il appelle sign_up, qui rend une clé sak_… et une boîte d’essai. Voir Démarrer.
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 à un administrateur de Subagent ; pendant la bêta, écrivez à contact@subagent.fr.
Le code à 6 chiffres n’arrive pas. Que faire ?
Vérifiez d’abord que votre e-mail est invité. Votre agent peut ensuite appeler 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.ai ou ChatGPT ?
Pas encore. Le connecteur pour assistants en ligne (OAuth 2.1) est [ à venir ]. Aujourd’hui, il faut un client MCP qui accepte une adresse et un en-tête d’autorisation : Claude Code, Cursor, ou le vôtre.
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. Une boîte d’essai a en plus ses limites : au plus 3 destinataires distincts la première heure, 5 le premier jour, 10 la première semaine. Voir Règles d’envoi.
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 étalement entre deux envois. La réponse de send_email donne le départ au plus tôt ; inbox_status donne l’état de la file.
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. add_domain rend les enregistrements DNS à publier, verify_domain les contrôle. Une fois le domaine vérifié, vos boîtes portent votre nom et sortent des limites d’essai. Un sous-domaine suffit. Voir Domaines.
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, avec une clé qui porte approve. Voir Brouillons et validation.
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.
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.
Peut-on lever une désinscription ?
Non, ni l’agent ni son humain. Seul un administrateur de Subagent 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.
Les prix et le code
Combien ça coûte ?
Aucun prix n’est publié : le service est en bêta privée. Voir Tarifs.
Y a-t-il des SDK ?
Pas encore : ils sont [ à venir ] sur GitHub. Aujourd’hui, tout passe par le MCP, ou par POST /v1/{opération}. Voir Open source.
Le serveur est-il open source ?
Non. Les clients seront ouverts ; le serveur, qui applique les règles d’envoi, reste privé.