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_…", … } }
Des équipes qui créent des logiciels de classe mondiale nous font confiance au quotidien
Découvrir plus de témoignages clientsRé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.email.mailboxes.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.email.mailboxes.messages.create(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.
Appliquez votre politique de réception.
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.
Pas les anciennes réponses.
Les messages exposent les en-têtes, le texte extrait et les pièces jointes pendant leur période de rétention. Les corps originaux et le MIME brut reçu disposent d'une fenêtre distincte de 30 jours. Le champ que votre agent recherche réellement est extracted_text : le nouveau contenu, débarrassé des citations. Le contexte se trouve dans le fil de discussion, 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.
Consultez les pièces jointes conservées via l'API. Les corps originaux et le MIME brut reçu disposent d'une fenêtre distincte de 30 jours.
É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.
Questions sur les boîtes mail des agents
En quoi un agent mailbox diffère-t-il de l'e-mail entrant ?
Puis-je utiliser mon propre domaine ?
Combien de temps le contenu d'une boîte aux lettres est-il disponible ?
Un agent peut-il écouter sans interroger le serveur ?
Choisir la bonne intégration email
Utilisez une boîte mail lorsque votre application a besoin d'une adresse, de conversations stockées et de réponses.
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
Gratuit
Startup
Forfait payant
Growth
Forfait payant
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
Conservation du texte et des pièces jointes
30 jours
30 jours
90 à 365 jours
Sur mesure
Stockage de boîte mail partagé
1,25 Go
à partir de 12,5 Go
à partir de 25 Go
Sur mesure
Comment le stockage est partagé
Une allocation unique à l'échelle de l'organisation est partagée entre toutes les boîtes mail actives et restaurables.
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é
Ce qu'un niveau supérieur conserve
Un niveau supérieur conserve les en-têtes de message, le texte extrait et les pièces jointes plus longtemps. Les corps originaux, le MIME brut reçu et le transfert sont limités à 30 jours sur tous les plans. Vous pouvez toujours lire le texte extrait et répondre avec un nouveau contenu après cette période.
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.
Mettez-le en pratique.
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Parlez à notre équipe e-mail
Donnez à votre agent un workflow e-mail.
Discutez de la façon dont votre application ou agent IA reçoit les messages, suit les fils de conversation et envoie des réponses. Nous vous aiderons à planifier l'intégration.
Créez votre compte, choisissez une adresse et recevez votre premier message.