---
title: Relais SMTP
description: "Utilisez le relais SMTP de BillionSend depuis n'importe quel client SMTP ou module d'envoi de framework : hôte, ports, TLS, limites et chaque code de réponse."
ai:
  exclude: true
---

Le relais SMTP reçoit les e-mails de n'importe quel client SMTP ou module d'envoi de framework et les envoie comme `POST /emails` : mêmes vérifications de l'expéditeur, mêmes suppressions, mêmes limites de forfait et mêmes événements.

## Se connecter

| Paramètre | Valeur |
| --- | --- |
| Hôte | `smtp.billionsend.com` |
| Port, STARTTLS | `587` |
| Port, TLS implicite | `465` |
| Nom d'utilisateur | `billionsend` |
| Mot de passe | Une [clé d'API](/docs/fr/api-reference/basics) (`bs_...`), par exemple un identifiant SMTP de la page **SMTP** (voir [Clés API](/docs/fr/api-keys)) |

TLS est obligatoire sur les deux ports. Une clé réservée à l'envoi, ou limitée à un domaine ou à une boîte de réception, conserve ces limites en SMTP.

```bash
curl --ssl-reqd smtp://smtp.billionsend.com:587 \
  --user "billionsend:$BILLIONSEND_API_KEY" \
  --mail-from hello@mail.example.com \
  --mail-rcpt success@simulator.amazonses.com \
  -T message.eml
```

## Ce que le relais vérifie

- L'adresse `From` doit appartenir à un [domaine vérifié](/docs/fr/concepts/domains) de l'équipe de la clé.
- Un `Subject` non vide et un corps HTML ou texte sont obligatoires.
- Un message peut faire jusqu'à 40 MiB et compter jusqu'à 50 destinataires.
- Les pièces jointes suivent les mêmes règles que l'API : les programmes et les types de fichiers déguisés sont refusés.
- Les en-têtes suivent la même liste d'autorisation que `POST /emails` (noms `X-*`, chaînage des fils, priorité, `List-Unsubscribe`). BillionSend écrit lui-même tous les autres en-têtes.
- Trois échecs de connexion ferment la connexion. Une session dure 15 minutes au plus, et une même adresse IP peut garder 10 connexions au plus.

## Limites de débit et nouvelles tentatives

Les messages comptent dans la même limite par minute que les requêtes d'API de la clé. Au-delà, le relais répond `451 4.7.1` avec le nombre de secondes à attendre. Les clients SMTP réessaient d'eux-mêmes.

Si un client n'a jamais vu le `250` final et renvoie le même message avec le même `Message-ID`, il reçoit de nouveau la première réponse au lieu d'un second e-mail.

## Erreurs

| Réponse | Signification |
| --- | --- |
| `530` / `535` | Identifiants manquants ou incorrects |
| `550` | Expéditeur non autorisé pour cette clé, destinataire qui ne peut pas recevoir d'e-mails, tous les destinataires sur la liste de suppression, ou équipe suspendue |
| `552` | Message ou pièce jointe trop volumineux |
| `553` | Objet manquant ou adresse mal formée |
| `554` | Message refusé, par exemple domaine d'expéditeur non vérifié ou en-tête non autorisé |
| `451` | Temporaire : limite par minute dépassée (`4.7.1`, avec le nombre de secondes à attendre) ou envoi suspendu le temps que vos taux se rétablissent. Réessayez. |
| `452` | Plus de 50 destinataires (envoyez les autres dans un second message), ou un quota est épuisé : la file d'attente quotidienne est pleine, le volume mensuel est atteint (il se libère au renouvellement de la période), la file de préchauffage d'un nouveau domaine est pleine, ou la limite d'envoi quotidienne de la boîte de réception est atteinte |
