Guide pratique
Gérer les adresses bloquées
Consultez, filtrez, ajoutez, importez, exportez et supprimez des blocages dans le tableau de bord ou via l’API, configurez le blocage automatique et renvoyez les e-mails bloqués.
Ce guide couvre toutes les tâches liées à la liste d’adresses bloquées : retrouver des entrées, en ajouter une par une ou depuis un fichier CSV, exporter la liste, retirer des entrées et régler le blocage automatique. Pour le fonctionnement des blocages, consultez Adresses bloquées.
Avant de commencer
- Tout membre de l’espace de travail peut gérer la liste dans le tableau de bord. La modification des paramètres de blocage automatique nécessite le rôle Admin.
- Pour l’API, utilisez une clé API Full Access.
Consulter et filtrer la liste
Accédez à Email APISuppressions. Le tableau liste l’Email, la Reason et la date Created at de chaque blocage, du plus récent au plus ancien.
- Search recherche dans l’adresse e-mail et le motif.
- Filters ajoute des règles sur Email, Reason, Type ou Created at, comme Type equals complaint. Appuyez sur Entrée ou sélectionnez Apply.
- Display options > Edit columns affiche la colonne Type.
- Sélectionnez un en-tête de colonne pour trier selon cette colonne.
Appelez Lister les blocages. Vous pouvez filtrer sur email, reason, type, created_at et keep_until :
curl -G https://api.emailit.com/v2/suppressions \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
--data-urlencode "type.exact=complaint" \
--data-urlencode "limit=100"Pour consulter une adresse précise, appelez Récupérer un blocage avec son ID sup_ ou l’adresse e-mail. Pour tous les opérateurs, consultez Filtrage et tri.
Ajouter un blocage
-
Ouvrez la liste. Accédez à Email APISuppressions et sélectionnez Add suppression.
-
Saisissez les informations. Saisissez l’Email et, si vous le souhaitez, une Reason que vous reconnaîtrez plus tard.
-
Sélectionnez Create. L’adresse est ajoutée avec le type
recipient, qui bloque tous les envois vers elle.
Pour ajouter un autre type, ou un blocage qui expire, utilisez l’API ou un import CSV.
Appelez Créer un blocage :
curl https://api.emailit.com/v2/suppressions \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "ada@example.com",
"type": "unsubscribe",
"reason": "Opted out by phone",
"keep_until": "2027-01-01T00:00:00Z"
}'| Champ | Obligatoire | Description |
|---|---|---|
email |
Oui | L’adresse à bloquer. |
type |
Non | recipient (par défaut), bounce, complaint ou unsubscribe. |
reason |
Non | Texte libre. |
keep_until |
Non | Date d’expiration du blocage : ISO 8601, horodatage Unix ou anglais courant comme in 30 days. Omettez-le pour bloquer l’adresse sans limite de durée. |
Une même adresse ne peut être ajoutée qu’une fois par type. Un doublon renvoie 409 Suppression already exists for this email and type.
Importer un fichier CSV
Utilisez un import pour transférer une liste d’adresses bloquées depuis un autre fournisseur ou pour ajouter de nombreuses adresses à la fois.
-
Préparez le fichier. Utilisez un fichier
.csvavec les colonnesemail,typeetreason:email,type,reason ada@example.com,bounce,Hard bounce at previous provider grace@example.com,unsubscribe,Unsubscribed in 2025 alan@example.com,,Requested removalemailest obligatoire.typeetreasonsont facultatifs.- Un
typevide ou inconnu devientrecipient. - La ligne d’en-tête est facultative. Sans elle, Emailit lit les colonnes dans l’ordre
email,type,reason. - Le fichier doit peser moins de 8 Mo et ne pas dépasser 10 000 lignes.
-
Importez-le. Sur Email APISuppressions, sélectionnez Import, puis choisissez le fichier ou faites-le glisser sur Select a file or drag it here.
-
Vérifiez le résultat. Emailit ajoute les nouvelles entrées et ignore les adresses qui ont déjà un blocage du même type. Les lignes dont l’adresse e-mail est invalide sont ignorées.
Au-delà de 10 000 adresses, découpez le fichier. Pour importer depuis votre code, appelez Créer un blocage pour chaque adresse.
Exporter la liste
-
Affinez la sélection. Si vous le souhaitez, recherchez ou filtrez la liste dans Email APISuppressions. L’export ne contient que ce qui est affiché.
-
Exportez. Sélectionnez Export, puis Export dans la fenêtre contextuelle. Emailit télécharge
suppressions.csv.
Le fichier comporte les colonnes email, type, reason et created_at, et contient jusqu’à 10 000 lignes.
Supprimer des blocages
Supprimer un blocage permet à Emailit d’envoyer de nouveau à l’adresse. Assurez-vous que l’adresse est valide et que la personne veut recevoir vos e-mails, sinon le prochain envoi risque de rebondir ou de susciter une plainte.
- Un seul : sélectionnez l’icône de corbeille sur sa ligne et confirmez.
- Plusieurs : sélectionnez les lignes avec les cases à cocher, sélectionnez Delete suppressions et confirmez.
Appelez Supprimer un blocage avec l’ID sup_ ou l’adresse e-mail :
curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
-X DELETE \
-H "Authorization: Bearer $EMAILIT_API_KEY"Si une adresse a des blocages de plusieurs types, utilisez l’ID sup_ pour supprimer le bon.
Pour modifier un blocage plutôt que de le supprimer, par exemple pour ajouter une date d’expiration, appelez Mettre à jour un blocage avec type, reason ou keep_until. Définissez keep_until sur null pour retirer la date d’expiration.
Configurer le blocage automatique
Emailit ajoute automatiquement à la liste les adresses qui rebondissent ou font l’objet d’une plainte. Sur Pro et Business, les administrateurs peuvent modifier ce comportement.
-
Ouvrez les paramètres. Accédez à WorkspaceSettings et sélectionnez l’onglet Suppressions.
-
Activez-le ou désactivez-le. Utilisez Enable automatic suppression.
-
Choisissez ce qu’il faut bloquer. Dans Suppress on, choisissez Bounces and Complaints (par défaut), Bounces only ou Complaints only.
Sur les forfaits Pay as you go et Custom, le blocage automatique est toujours activé pour les rebonds et les plaintes. Les commandes affichent un badge Pro et ne peuvent pas être modifiées. Les membres qui ne sont pas administrateurs peuvent consulter les paramètres, mais pas les modifier. Pour savoir précisément quand Emailit bloque une adresse, consultez Rebonds et plaintes.
Relancer les e-mails bloqués
Un message arrêté par un blocage reste suppressed, même après la suppression du blocage. Pour l’envoyer :
-
Supprimez le blocage de l’adresse, comme décrit ci-dessus. Sinon, la relance est bloquée elle aussi.
-
Relancez l’e-mail. Ouvrez-le dans Email APIEmails et sélectionnez Retry, ou appelez Relancer un e-mail.
Une relance crée un nouvel e-mail avec le même contenu et un nouvel ID, et coûte des crédits comme tout autre envoi. Vous pouvez relancer des e-mails datant de 30 jours au plus, tant que leur contenu est encore dans votre durée de conservation des données.