Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail

Glossary

View as .md

The terms of this documentation, and those of the server. The server answers in French: when it uses its own word in its responses, that word is given, such as “réchauffage” for the warm-up and “créneau d’envoi” for working hours.

Who

TermMeaning
AgentThe AI program that connects to the server with a key, writes, reads and replies.
HumanThe person the agent works for. They receive the 6-digit code, pay for the plan and approve drafts. In the tools: human_email.
CorrespondentThe person or service an inbox writes to, or who writes to it. In a thread: counterpart.
SubagentEscouade Mail’s former name, until 19 October 2026. The server still writes it in its messages (“un administrateur de Subagent”), its API address, its keys and its packages.
Escouade Mail administratorThe person who runs the service. They do what no tool does: see Help.

Access

TermMeaning
SpaceThe inboxes, threads, keys, domains, block list and plan of a single customer. The key enforces it: an agent does not step outside its own. In the object returned by inbox_status, the space is the tenant field.
Verified spaceA space whose human has given the 6-digit code. Before that, its inboxes receive and do not send.
KeyWhat an agent presents on every call: sak_…. It designates a space and carries permissions. See Keys and permissions.
PermissionWhat a key opens: send, read, approve, manage_inboxes.
6-digit codeThe code the human receives by e-mail and the agent passes to verify. It is valid for 24 hours.
ConnectorThe address https://mail.escouade.io/mcp, through which a human’s online assistant connects to their space, with no key to copy. See Connector.
Sign-in codeThe 6-digit code the human receives when connecting their assistant through the connector. It is valid for 10 minutes, and is entered on the Escouade Mail page. The same e-mail carries a button, which spares it in the browser where the sign-in was started.

Mail

TermMeaning
InboxAn e-mail address driven by an agent: inb_…. It receives from the moment it is created. See Inboxes.
First inboxThe inbox opened by sign_up on the shared domain.
Shared domainsubagentmail.fr, shared by every space. Once the plan is paid, its inboxes only reply to whoever wrote to them.
DomainA domain name registered by a space to create its inboxes on: dom_…. See Domains.
ThreadThe conversation between an inbox and a correspondent: thr_…. See Threads.
MessageAn e-mail, incoming or outgoing, within a thread: msg_…. See Messages.
First messageThe message that opens a thread with a recipient. It is written with send_email.
ReplyA message written in an existing thread, with reply_to_thread.
Follow-upA reply in a thread where the correspondent has not written yet.
ConversationA thread where the correspondent has written. A reply leaves there without waiting for working hours, with no unsubscribe footer.
DraftA message with the status draft: it waits for a human’s approval. See Drafts and approval.
ApprovalA human’s gesture that moves a draft to the queue: approve_message. It needs the approve permission.
QueueAn inbox’s messages with the status queued: they will leave when the sending rules allow it.
LogThe sequence of a message’s events: creation, approval, departure, delivery, bounce. get_message returns it.
Content received from a third partyWhat a correspondent wrote. The server frames it and marks it untrusted. See Receiving mail.

Sending rules

TermServer’s wordMeaning
Gradual warm-upréchauffageAn inbox’s number of e-mails per day rises in steps: 5, 10, 15, 20, one step per week.
SteppalierThe number of e-mails per day for the current week.
Daily quotaquota du jourWhat an inbox can send during the day: the smaller of the step and its maximum quota.
Working hourscréneau d’envoiThe days and hours when a message leaves. By default Monday to Friday, 9 am to 6 pm, Paris time, public holidays excluded.
Gap between two sendsétalementThe delay the server leaves between two sends from the same inbox.
DuplicatedoublonA second first message from the same inbox to the same recipient, within 30 days. It is refused.
Earliest departuredépart au plus tôtThe estimate of when a queued message will leave: estimated_send_at.
Message held backen fileA message waiting for its departure. It is not an error.
RefusalrefusA request the server does not carry out. It carries a code, a message and a lead. See Errors.
LeadhintThe sentence of a refusal that says what to do.

Plan and payment

TermMeaning
PlanWhat the space pays each month: a number of inboxes and a volume of e-mails. Three plans: €9, €19 and €49. See Pricing and payment. “Step” never means a plan: it is the warm-up’s word.
Month’s volumeThe number of e-mails a space can send per one-month period. Beyond it, a message waits for the next period.
PeriodThe paid month: it starts at payment. billing_status returns its start and its end.
Payment linkThe link subscribe returns, and the agent hands to its human. It is valid for 72 hours.
Monthly direct debitThe plan’s payment, every month, after the first payment. cancel_subscription stops it.
Test sendA message written with test: it only goes to the space’s human, or to another of its inboxes. It leaves even without a plan.

Stops

TermMeaning
UnsubscribeA person’s request to receive no more e-mail: through the one-click link, or through a “STOP” reply. See Unsubscribes and blocks.
Block listThe addresses and domains a space no longer writes to. In the tools: suppression.
BounceAn e-mail that came back: the recipient’s server refused it.
Dead addressAn address that does not exist: a hard bounce showed it. It is blocked. In the block list: hard_bounce.
ComplaintA recipient reporting a message as spam.
Circuit breakerThe rule that suspends an inbox when too many of its e-mails come back or are reported.
Suspended inboxAn inbox the circuit breaker has stopped: it receives, it no longer sends.

Technical

TermMeaning
MCPThe protocol through which an agent calls the server’s tools. See MCP server.
ToolA server operation: send_email, list_threads… See the reference.
Structured objectA tool’s result as data: structuredContent over MCP, the response body over HTTP.
Readable textA tool’s result as sentences in French.
ViewWhat an assistant displays with the result of some tools. See Views.
IdempotencyWhat lets you retry a send without creating a second message: idempotency_key.
CursorA list’s next_cursor value, to pass back in cursor for the next page.
WebhookA signed HTTP call the server sends when an event happens. See Webhooks.
This page in Markdown: /en/mail/docs/glossaire.md All the docs for an agent: /en/mail/docs/llms.txt Legal notice · Terms · Privacy · Service status