L<accent>API Mailbox</accent> pour les agents qui répondent eux-mêmes à leurs e-mails.
Une vraie boîte de réception que votre code contrôle. Les e-mails arrivent sous forme de fils de discussion ; votre agent les lit et y répond via l'API. Pas d'IMAP, pas de parsing MIME.
# Claim an address on inbox.ai
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{
"domain": "inbox.ai",
"local_part": "goldcrest",
"display_name": "Goldcrest Support"
}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "goldcrest@inbox.ai",
"receive_policy": "open",
"state": "active"
}
# Mail arrives; your webhook fires
POST /your-webhook-endpoint
{ "type": "email_mailbox.message_received", "data": { "thread_id": "thr_…", … } }
Réclamez, composez et répondez dans le langage que vous utilisez déjà.
Les SDK, le CLI et le serveur MCP hébergé parlent tous la même boucle.
Chaque surface exécute les mêmes quatre appels : réclamer une adresse, attendre un webhook, lire le nouveau contenu et répondre. Choisissez votre runtime ; le contrat est identique.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// Claim an address on inbox.ai
const mailbox = await bird.mailbox.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.mailbox.compose(mailbox.id, {
to: ["alice@example.com"],
subject: "Your request has been received",
text: "We'll get back to you within one business day.",
});
Réclamer, recevoir, lire, répondre.
La boucle complète tient en quatre appels.
L'adresse est à vous dès le premier appel, et sur inbox.ai elle est réservée de manière permanente à votre organisation. Pas de polling : l'étape 02 est le réveil, par webhook. Les exemples sont en REST pur ; les SDK, le CLI et le serveur MCP hébergé exécutent la même boucle.
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{"domain": "inbox.ai", "receive_policy": "open"}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
"state": "active"
}
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{"domain": "inbox.ai", "receive_policy": "open"}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
"state": "active"
}
Vous décidez ce qui entre.
Rien ne disparaît.
Une politique de réception et des règles par expéditeur s'appliquent à l'expéditeur de l'enveloppe ; un blocage l'emporte toujours sur une autorisation. Les messages bloqués par une règle d'expéditeur sont stockés silencieusement — vous pouvez toujours les lire, et ils ne déclenchent aucun webhook. (La politique `drop` supprime entièrement le message et ne le stocke pas.)
Le modèle lit le message.
Not the old replies.
Chaque message expose les en-têtes, le HTML, la source brute et les pièces jointes. Le champ qui intéresse réellement votre agent est extracted_text : le nouveau contenu, sans les citations. Le contexte vit dans le fil, pas dans quarante lignes de citation.
Ce que vous pouvez faire avec Mailboxes.
Quatre tâches qu'une boîte de réception accomplit dès le premier jour.
Une boîte de réception de support gérée par l'agent.
Chaque conversation est un fil ; l'agent répond dans le fil et signale les messages incertains avec un label qu'un humain surveille.
Tout ce qu'il y a dans la boîte.
Toute la surface en un coup d'œil.
API Inbox.
Créez une adresse en un seul appel : générée sur inbox.ai, un identifiant personnalisé ou votre propre domaine.
MCP & SDKs.
Un serveur MCP hébergé pour les agents ; des SDKs et le CLI pour tout le reste.
Fils & libellés.
Un fil par conversation ; des libellés façon Gmail avec une grammaire PATCH unique.
extracted_text.
Le nouveau contenu, sans les citations, prêt à transmettre au modèle.
Pièces jointes.
En-têtes, HTML, source brute et pièces jointes, le tout via l'API.
Événements.
La famille de webhooks email_mailbox.* : message_received, thread_created, message_sent, message_delivered, message_failed.
Règles de réception.
Une politique et des autorisations/blocages par expéditeur, vérifiés par rapport à l'expéditeur de l'enveloppe.
Filtres de fils.
Filtrez les fils de chaque boîte par libellé, participant, objet ou état de lecture via l'API.
Clés à portée limitée.
mailbox lit et écrit les conversations ; mailbox_management administre.
Envois tenant compte des suppressions.
Les réponses se déclarent marketing ou transactionnelles ; la liste de suppression est appliquée par catégorie.
Un e-mail arrive.
Votre agent se réveille.
Des webhooks pour une livraison durable. Seuls les e-mails atteignant la boîte de réception déclenchent les webhooks — le spam et les e-mails bloqués sont stockés silencieusement.
POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json
{
"type": "email_mailbox.message_received",
"timestamp": "2026-07-23T14:11:02Z",
"data": {
"thread_id": "thr_01krdh2p8qz3m9wv6xf0abcnde",
"message_id": "rem_01krdh3v7t2j5nqx8fw4mzp6bc"
}
}
email_mailbox.message_receivedL'e-mail entrant a atteint la boîte de réception.email_mailbox.thread_createdUne nouvelle conversation a été ouverte.email_mailbox.message_sentUne réponse ou un envoi a quitté la boîte de réception.email_mailbox.message_deliveredLe serveur destinataire l'a accepté.email_mailbox.message_failedLa livraison a échoué ; le statut est reporté sur le message.
Tarifs
Les boîtes de réception sont incluses dans votre plan Email
Il n'y a pas d'abonnement séparé pour les boîtes de réception. Chaque plan email inclut des boîtes avec des adresses @inbox.ai générées ; les plans payants ajoutent des identifiants personnalisés.
Gratuit
$0
Startup
à partir de 15 $/mois
Growth
à partir de 80 $/mois
Enterprise
Sur mesure
Boîtes de réception (tout domaine)
5
à partir de 50
à partir de 100
Sur mesure
Identifiants @inbox.ai personnalisés
—
à partir de 10
à partir de 25
Sur mesure
Adresses @inbox.ai générées
Illimité dans la limite de vos boîtes mail, gratuit sur tous les plans
Identifiants sur votre propre domaine
N'importe quel identifiant, aucun quota utilisé
Conservation des fils de discussion
30 jours sur tous les plans
Fenêtre de restauration après suppression
Les boîtes mail supprimées bénéficient d'une fenêtre de restauration de 30 jours. Les adresses Inbox.ai restent définitivement réservées à votre organisation ; les adresses sur domaine personnalisé peuvent être réattribuées par le même espace de travail après 30 jours.
Les quotas augmentent avec le volume d'e-mails de votre plan. Un passage à un plan inférieur ne désactive jamais une boîte mail : les identifiants déjà revendiqués continuent de fonctionner, vous ne pouvez simplement pas en revendiquer de nouveaux tant que vous dépassez le quota.