# Fonctionnement d’Emailit

> Le modèle d’Emailit en une page. Espaces de travail, domaines et clés API, les façons d’envoyer et de recevoir, la vie d’un e-mail, les crédits et le mode bac à sable.

Cette page présente les principaux éléments d’Emailit et la façon dont ils s’articulent. Lisez-la une fois avant de développer quoi que ce soit. Le reste de la documentation suppose que vous connaissez ces termes.

## Comptes et espaces de travail

Votre **compte**, c’est vous : une adresse e-mail, un mot de passe et, si vous le souhaitez, l’authentification à deux facteurs ou des clés d’accès. Tout ce que vous envoyez se trouve dans un espace de travail. Un compte peut appartenir à plusieurs espaces de travail, et vous passez de l’un à l’autre avec le sélecteur d’espace de travail en haut de la barre latérale. Une configuration courante consiste à avoir un espace de travail par produit ou par environnement, par exemple `Acme` et `Acme Staging`.

Chaque espace de travail a ses propres ressources :

| Ressource | Description |
| --- | --- |
| Domaines d’envoi | Les domaines que vous vérifiez avec des enregistrements DNS pour qu’Emailit puisse envoyer en leur nom. Chaque adresse d’expéditeur doit se trouver sur un domaine d’envoi vérifié. |
| Clés API | Des secrets qui commencent par `secret_`. Elles authentifient l’API REST, le serveur MCP et le relais SMTP. Une clé est soit **Full Access**, soit **Sending Only**. |
| Membres | Les personnes qui peuvent ouvrir l’espace de travail, en tant qu’**Admin** ou **Member**. Les administrateurs gèrent aussi les paramètres, les clés API, les membres et la facturation. |
| Facturation | Un forfait, un solde de crédits, des paramètres de recharge automatique et des factures. |
| Données | E-mails, événements, logs, contacts, listes de contacts, modèles, webhooks et adresses bloquées. |

Les clés API, les domaines, les contacts et les crédits appartiennent à un seul espace de travail. Une clé API ne fonctionne jamais dans un autre espace de travail.

## Plusieurs façons d’envoyer, une façon de recevoir

| Canal | Utilisation | Comment |
| --- | --- | --- |
| API REST | Les e-mails transactionnels envoyés depuis votre code : inscriptions, réinitialisations de mot de passe, reçus | `POST https://api.emailit.com/v2/emails` avec une clé API, ou un [SDK](/fr/docs/sdks/) |
| Relais SMTP | Les applications, frameworks et outils qui parlent déjà SMTP | Hôte `smtp.emailit.com`, nom d’utilisateur `emailit`, votre clé API comme mot de passe |
| Campagnes et automatisations | Newsletters, annonces et séquences d’accueil envoyées à vos contacts | Créées dans le tableau de bord sous **Email Marketing** |
| Réception | Recevoir des e-mails sur votre domaine, pour les réponses ou le support | Un enregistrement MX sur `inbound.<your domain>`. Chaque message déclenche `email.received`. |

Tous les canaux utilisent les mêmes domaines vérifiés et la même liste d’adresses bloquées. L’API et le relais SMTP partagent aussi les clés API, les logs de requêtes et un même ensemble de limites d’envoi. Pour choisir entre les deux, consultez [API ou SMTP](/fr/docs/get-started/api-or-smtp/).

## La vie d’un e-mail

Chaque e-mail suit le même parcours, quelle que soit la façon dont vous l’envoyez :

1. **Accepté.** L’API ou le relais SMTP contrôle la requête : une clé API valide, une adresse d’expéditeur sur un domaine vérifié, les règles du mode bac à sable, les limites d’envoi et les crédits. Chaque destinataire devient un e-mail distinct, avec son propre ID `em_` et le statut `accepted`, ou `scheduled` si vous avez défini une heure d’envoi. L’API émet `email.accepted` ou `email.scheduled`.
2. **Mis en file d’attente et contrôlé.** Un processus de livraison prend l’e-mail en charge et le contrôle de nouveau. Un destinataire présent dans votre [liste d’adresses bloquées](/fr/docs/suppressions/) fait passer l’e-mail à `suppressed`. Un domaine en pause, un espace de travail suspendu ou un solde de crédits vide le fait passer à `held`.
3. **Signé et évalué.** Emailit signe le message avec DKIM pour votre domaine et définit le return-path sur `emailit.<your domain>`. Si le suivi est activé, il réécrit les liens et ajoute un pixel d’ouverture. Il effectue ensuite un contrôle anti-spam. Un message dont le score atteint 7 ou plus passe à `held`, et les règles déclenchées apparaissent sous **Spam Checks** sur la page de l’e-mail.
4. **Tentatives de livraison.** Emailit se connecte au serveur de messagerie du destinataire. Un refus définitif (réponse 5xx) fait passer l’e-mail à `bounced`. Un échec temporaire (réponse 4xx ou timeout) le fait passer à `attempted`, et Emailit réessaie jusqu’à 7 fois sur environ 21 heures avant d’abandonner et de le marquer `bounced`.
5. **Livré.** Le serveur destinataire a accepté le message : l’e-mail passe à `delivered`. Un rapport de rebond qui arrive plus tard peut encore le faire passer à `bounced`, et une plainte pour spam transmise par le fournisseur de messagerie le fait passer à `complained`. Les adresses qui ont rebondi ou porté plainte peuvent être ajoutées automatiquement à votre liste d’adresses bloquées.
6. **Ouvert et cliqué.** Si le domaine dispose d’un [sous-domaine de suivi](/fr/docs/tracking/) vérifié, les ouvertures font passer l’e-mail à `loaded` et les clics à `clicked`.

Chaque changement de statut est enregistré sous forme d’**événement**. Les événements apparaissent sur la page de l’e-mail et dans **Email API → Events**. Ils sont aussi envoyés à vos [webhooks](/fr/docs/webhooks/) en JSON signé, par lots de 100 événements au maximum par requête.

| Groupe | Statuts |
| --- | --- |
| En cours | `accepted`, `scheduled`, `attempted` |
| Arrivés | `delivered`, `loaded`, `clicked`, `received` (entrant) |
| Arrêtés | `bounced`, `failed`, `rejected`, `suppressed`, `complained`, `canceled`, `held` |

Vous pouvez annuler un e-mail tant qu’il est `scheduled`, `accepted` ou `attempted`. Vous pouvez relancer un e-mail `held`, `bounced`, `failed` ou `suppressed` après en avoir corrigé la cause. Pour la signification de chaque statut, consultez [Statuts des e-mails](/fr/docs/logs/email-statuses/).

## Crédits

Emailit facture en crédits. Chaque espace de travail dispose d’un solde composé des crédits inclus chaque mois dans son forfait et des crédits que vous achetez. Les crédits inclus sont utilisés en premier. Les crédits achetés n’expirent jamais.

| Action | Crédits |
| --- | --- |
| E-mail envoyé via l’API ou SMTP (par destinataire) | 1 |
| E-mail entrant reçu | 1 |
| E-mail de campagne (par destinataire) | 2 |
| Exécution d’automatisation | 3 |
| Vérification d’e-mail (par adresse) | 5 |

Si le solde ne couvre pas un envoi, l’API renvoie `402` et rien n’est envoyé. Les e-mails qui atteignent la file de livraison sans crédits suffisants passent à `held`, et vous pouvez les relancer après avoir ajouté des crédits. Activez la [recharge automatique](/fr/docs/billing/auto-refill/) pour que les e-mails de production ne s’arrêtent jamais. Pour les forfaits et les prix, consultez [Crédits](/fr/docs/billing/credits/) et la [page des tarifs](/pricing/).

## Mode bac à sable et accès production

Chaque nouvel espace de travail démarre en **mode bac à sable**. Dans ce mode, vous ne pouvez envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail, et les campagnes sont bloquées. Tout envoi à quelqu’un d’autre échoue : l’API renvoie `403 unverified_workspace_recipient` et le relais SMTP répond `550`.

Pour envoyer à de vrais destinataires, vérifiez au moins un domaine d’envoi. Un administrateur demande ensuite l’accès production depuis la bannière du mode bac à sable ou depuis **Workspace → Settings → Requests**. La demande porte sur ce que vous envoyez, votre volume prévu et la façon dont les personnes donnent leur accord. L’équipe Emailit l’examine et répond dans le fil de la demande. Consultez [Accès production](/fr/docs/workspaces/production-access/).

Chaque espace de travail a aussi des [limites d’envoi](/fr/docs/limits/), partagées entre l’API et SMTP. Les nouveaux espaces de travail peuvent envoyer 2 e-mails par seconde et 5 000 e-mails par jour. Les espaces de travail Pro et Business bénéficient de hausses automatiques selon leur santé d’envoi, et tout espace de travail peut en demander davantage depuis la carte **Sending Limits** de la page d’accueil du tableau de bord.

## Le tableau de bord

Le tableau de bord, sur [dash.emailit.com](https://dash.emailit.com), suit le même modèle. La barre latérale comporte ces sections, de haut en bas :

| Section | Page | Rôle |
| --- | --- | --- |
| Dashboard | | Liste de configuration, actions rapides, crédits, volume quotidien, santé d’envoi et limites d’envoi |
| Email Marketing | Overview | Croissance des contacts et activité marketing récente |
| | Audiences | Listes nommées d’abonnés auxquelles les campagnes sont envoyées |
| | Contacts | Toutes les personnes de l’espace de travail, avec champs personnalisés, import et export |
| | Campaigns | Créer, tester et programmer des campagnes, et consulter leurs rapports |
| | Templates | Designs réutilisables pour l’API, les automatisations et les campagnes |
| | Forms | Formulaires d’inscription (accès anticipé) |
| | Automations | Workflows déclenchés par les contacts, les dates et les événements e-mail (bêta) |
| Email API | Emails | Tous les e-mails sortants et entrants, avec leur statut, leur contenu et leurs tentatives de livraison |
| | Analytics | Envois, rebonds, plaintes, ouvertures et clics dans le temps |
| | Domains | Ajouter des domaines, publier les enregistrements DNS, contrôler la vérification et le suivi |
| | DMARC reports | Qui envoie des e-mails au nom de votre domaine (à partir du forfait Pro) |
| | Events | Le flux d’événements de l’espace de travail que reçoivent les webhooks |
| | Logs | Chaque requête API et SMTP, avec les codes de statut et les corps |
| | API Keys | Créer, renommer, régénérer et supprimer des clés, et consulter les paramètres SMTP |
| | Webhooks | Endpoints, sélection des événements et chaque tentative de livraison |
| | Suppressions | Les adresses auxquelles Emailit n’enverra pas, avec import et export CSV |
| Email Verification | Emails | Contrôler une adresse avant d’envoyer |
| | Lists | Contrôler jusqu’à 10 000 adresses d’un coup |
| Workspace | Billing | Forfait, crédits, recharge automatique, options et factures |
| | Settings | Nom, membres, champs personnalisés, conservation des données, paramètres de blocage et demandes |

Les paramètres de votre compte (profil, mot de passe, authentification à deux facteurs et clés d’accès) et votre lien de parrainage se trouvent dans le menu du compte, en bas de la barre latérale.

## Étapes suivantes

  - [Démarrage rapide API](/fr/docs/quickstart/api/): Ajoutez un domaine, créez une clé et envoyez votre premier e-mail.
  - [Démarrage rapide SMTP](/fr/docs/quickstart/smtp/): Connectez n’importe quelle application ou n’importe quel framework via SMTP.
  - [API ou SMTP](/fr/docs/get-started/api-or-smtp/): Comparez les deux façons d’envoyer des e-mails transactionnels.
  - [Liste de contrôle avant la mise en production](/fr/docs/get-started/go-live/): Tout ce qu’il faut faire avant d’envoyer à de vrais destinataires.

---
Source: https://emailit.com/fr/docs/get-started/how-emailit-works/