Vue d’ensemble
E-mails entrants
Recevez des e-mails à n’importe quelle adresse d’un sous-domaine de votre domaine vérifié, recevez un webhook email.received et récupérez le message complet via l’API.
Les e-mails entrants permettent à votre application de recevoir des messages, et pas seulement d’en envoyer. Vous faites pointer vers Emailit un enregistrement MX pour un sous-domaine comme inbound.acme.com, et chaque message envoyé à n’importe quelle adresse de ce sous-domaine est stocké dans votre espace de travail et signalé par un webhook. Utilisez-les pour traiter les réponses, gérer des boîtes de support, extraire des documents des e-mails ou transférer des e-mails à une équipe.
Fonctionnement
- Vous publiez un enregistrement MX. L’enregistrement de
inbound.<your domain>pointe versinbound.emailitmail.comavec la priorité 10. Les enregistrements MX de votre domaine racine restent chez votre fournisseur de messagerie : votre messagerie habituelle continue de fonctionner. - Quelqu’un écrit à une adresse de ce sous-domaine. Toutes les parties locales sont acceptées, par exemple
support@inbound.acme.comoureply+4821@inbound.acme.com. Aucune boîte aux lettres n’est à créer. - Emailit accepte et stocke le message. Il est enregistré comme un e-mail de type
inboundau statutreceived, et coûte 1 créditCréditL’unité de facturation d’Emailit. Chaque action coûte un nombre fixe de crédits, par exemple 1 pour un e-mail via l’API ou SMTP et 2 pour un e-mail de campagne.. - Emailit crée un événement
email.received. Les webhooks qui y sont abonnés reçoivent un petit payload avec l’ID de l’e-mail,from,to,subjectetcreated_at. Le corps et les pièces jointes ne figurent pas dans le webhook. - Votre application récupère le contenu. Appelez Récupérer un e-mail avec l’ID pour obtenir le corps texte et HTML analysé, les en-têtes et les pièces jointes, ou Récupérer le MIME brut pour le message d’origine.
- Une automatisation peut aussi agir sur le message. Le déclencheur Email received des automatisations peut transférer le message ou démarrer d’autres étapes.
Les messages reçus apparaissent aussi dans le tableau de bord sous Email APIEmails, dans l’onglet Incoming, où vous pouvez ouvrir chacun d’eux pour voir ses en-têtes, son contenu et ses pièces jointes.
Ce que vous pouvez faire
Limites et comportement
| Élément | Comportement |
|---|---|
| Domaine | Le domaine doit être un domaine d’envoiDomaine d’envoiUn domaine qui vous appartient et que vous vérifiez avec des enregistrements DNS, pour qu’Emailit puisse envoyer des e-mails depuis ce domaine avec SPF, DKIM et un return-path personnalisé. vérifié de votre espace de travail (enregistrements SPF, DKIM et return-path à OK). |
| Adresses | N’importe quelle adresse sur <inbound subdomain>.<your domain>. Le sous-domaine par défaut est inbound ; vous pouvez le modifier via l’API. Les adresses du domaine racine ne sont pas acceptées. |
| Taille du message | Jusqu’à 40 Mo par message, la même limite que pour l’envoi SMTP. |
| Coût | 1 crédit par message reçu. Si l’espace de travail n’a plus de crédits, Emailit répond 452 Insufficient credits to receive inbound email et le serveur expéditeur réessaie plus tard. |
| Payload du webhook | email.received ne contient que l’ID et les champs d’enveloppe. Récupérez le corps, les en-têtes et les pièces jointes via l’API. |
| Filtrage anti-spam | Emailit n’évalue ni ne filtre les messages entrants pour détecter le spam. Appliquez vos propres contrôles avant d’agir sur leur contenu. |
| Statistiques | Les messages entrants ne sont pas comptés dans les statistiques, qui portent sur les e-mails sortants. |
Il n’existe pas d’interface de routage pour les e-mails entrants : pas de boîtes aux lettres par adresse, de règles ni de paramètres catch-all dans le tableau de bord. Routez les messages dans votre propre code en lisant l’adresse to du webhook, ou utilisez l’automatisation Forward received email pour tout envoyer, ou seulement un sous-ensemble filtré, vers une autre boîte de réception.
Conservation
Les messages entrants suivent la conservation des données de votre espace de travail. Le contenu des messages (corps, en-têtes et pièces jointes) est conservé moins longtemps que l’enregistrement du message : récupérez et stockez ce dont vous avez besoin dès l’arrivée du webhook. Une fois le contenu purgé, l’API renvoie l’e-mail sans son corps ni ses pièces jointes.
| Pay as you go | Pro | Business | Custom | |
|---|---|---|---|---|
| Conservation du contenu des messages | 7 jours | 30 jours | 30 jours | Flexible |
| Conservation de l’activité des messages | 30 jours | 365 jours | 365 jours | Flexible |