# E-mail transactionnel

> Envoyez depuis votre propre domaine vérifié par DKIM, avec un historique des envois.

Source: https://gheima.ma/fr/docs/managed-email

L’e-mail transactionnel géré permet à votre app d’envoyer depuis votre propre domaine (reçus, vérifications, réinitialisations de mot de passe) sans serveur mail. Gheima génère une clé DKIM par domaine. Vous publiez sa clé publique dans le DNS, et nous signons le courrier sortant avec elle pour qu’il s’authentifie comme venant de votre domaine.

### Vérifier un domaine

1. **Ajouter le domaine** — Ouvrez E-mail, cliquez sur « Ajouter un domaine » et saisissez le domaine, par exemple mail.example.com.
2. **Publier les DNS** — Ajoutez l’enregistrement DKIM TXT et l’enregistrement SPF chez votre fournisseur DNS.
3. **Vérifier** — Cliquez sur « Vérifier ». Dès que l’enregistrement DKIM est visible, le domaine passe à « Vérifié ».

### Envoyer

```bash
curl https://api.gheima.ma/v1/email/send \
  -H "Authorization: Bearer $GHEIMA_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"domainId":"…","from":"hi@mail.example.com","to":"user@dest.com","subject":"Welcome","html":"<b>Hi</b>"}'
```

L’adresse from doit être sur le domaine vérifié. Envoyez le corps en html, en text, ou les deux.

> Note: L’envoi est asynchrone. Le journal garde l’expéditeur, le destinataire, l’objet et le statut de chaque message. Nous ne conservons pas le corps du message.

> Result: Votre app envoie des e-mails signés DKIM depuis votre domaine, avec un journal d’envoi et sans serveur mail à gérer.

---

All docs: https://gheima.ma/fr/docs.md