Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu
Sur cette page

Désinscriptions et marques

Les désinscriptions sont conservées par domaine d'envoi, donc chaque marque a sa propre liste, sa propre page de désinscription et son propre hôte de liens.

Une désinscription signifie « plus d’e-mails marketing ». BillionSend l’enregistre pour le domaine d’envoi dont l’e-mail contenait le lien, si bien qu’une équipe avec plusieurs marques ne mélange jamais leurs listes. Quelqu’un qui quitte une marque continue de recevoir les e-mails des autres.

Les e-mails transactionnels (envoyés sans thématique et hors campagne) ne sont jamais touchés par une désinscription.

Trois portées

Portée Qui la définit Ce qu’elle arrête
Domaine Le destinataire, avec le lien de désinscription ou le bouton en un clic de son client de messagerie Les e-mails marketing du domaine qui a envoyé cet e-mail
Toute l’équipe Vous, en mettant unsubscribed d’un contact à true (API, tableau de bord ou import CSV) Les e-mails marketing de tous les domaines de votre équipe
Thématique Le destinataire, sur la page de désinscription Les e-mails envoyés avec cette thématique

La désinscription d’un destinataire ne modifie jamais l’indicateur unsubscribed du contact. Elle est enregistrée comme une entrée pour le domaine, identifiée par l’adresse e-mail, et elle survit donc à la suppression puis à la réimportation du contact.

Les campagnes et les envois par thématique ignorent un destinataire qui s’est désinscrit du domaine d’envoi, de toute l’équipe ou de la thématique. Un e-mail individuel arrêté de cette façon se termine en suppressed avec la raison domain_unsubscribed, contact_unsubscribed ou topic_unsubscribed.

Les désinscriptions ne sont pas des suppressions. La liste de suppression contient les adresses qui ont rebondi, qui ont fait une plainte ou que vous avez bloquées, et elle arrête tous les e-mails, y compris les transactionnels. Une désinscription n’arrête que les e-mails marketing.

La page de désinscription

Chaque campagne et chaque e-mail par thématique porte les en-têtes List-Unsubscribe en un clic (RFC 8058) et un lien vers une page de désinscription hébergée. Placez {{{UNSUBSCRIBE_URL}}} dans un corps de message et il devient le lien correspondant à chaque destinataire. La page s’ouvre dans la langue du navigateur du destinataire (quatorze langues, l’anglais par défaut). En plus de quitter tous les e-mails marketing du domaine, le destinataire peut activer et désactiver chaque thématique.

Un destinataire qui a cliqué par erreur peut appuyer sur Réabonner sur la page de confirmation. Cela n’annule que ce dont ce lien l’avait désinscrit. Un analyseur d’e-mails qui ouvre le lien ne réabonne jamais personne. Quand vous définissez vous-même unsubscribed: true, la page n’a pas de bouton Se réabonner.

Chaque domaine a son propre aspect

La page ressemble au domaine qui a envoyé l’e-mail. Chaque domaine peut définir :

  • un nom de marque, un logo et l’arrondi des coins du logo,
  • les couleurs de fond, de texte et d’accent,
  • le texte au-dessus du bouton et le texte affiché une fois le choix enregistré,
  • une URL de redirection à ouvrir après la désinscription, à la place du message de la page.

Dans le tableau de bord, ouvrez le domaine et utilisez l’onglet Marque, qui affiche un aperçu du résultat. Un champ laissé vide reprend les Valeurs par défaut de la marque de l’équipe (Paramètres), puis l’aspect sobre de BillionSend. La page n’affiche que ce qui appartient à ce domaine : elle ne nomme jamais un autre domaine de votre équipe, et elle ne liste que les thématiques liées à ce domaine et celles qui n’ont pas de domaine.

Avec l’API, envoyez les champs dans unsubscribe_page sur PATCH /domains/{id}. Un null efface un champ. Le logo se téléverse dans le tableau de bord et n’est qu’en lecture dans l’API.

curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "unsubscribe_page": {
      "brand_name": "Acme",
      "message": "Sorry to see you go. Unsubscribe from Acme emails?",
      "success_message": "You are unsubscribed from Acme.",
      "accent_color": "#0a7d5a",
      "logo_radius": "rounded"
    }
  }'

Un lien créé hors d’un e-mail, comme celui de POST /contacts/{id}/preferences-link, ouvre la page par défaut de l’équipe, et s’y désinscrire désinscrit le contact de tous les domaines.

Votre propre sous-domaine de désinscription

Par défaut, les liens s’ouvrent sur un hôte BillionSend. Pour les ouvrir sur votre propre domaine, donnez au domaine un sous-domaine de désinscription dans son onglet Liens, ou avec unsubscribe_subdomain sur POST /domains ou PATCH /domains/{id} (un libellé comme unsubscribe pour unsubscribe.yourdomain.com ; null l’efface). Il fonctionne comme le sous-domaine de suivi, voir Domaines.

  1. Ajoutez le CNAME que l’onglet DNS du domaine affiche, pointant vers cname.billiondns.com, en DNS uniquement (nuage gris sur Cloudflare).
  2. Le certificat est émis automatiquement dès que le CNAME se résout, en général en quelques minutes. unsubscribe_status passe de pending à active, et unsubscribe_error en donne la raison quand ce n’est pas le cas.
  3. Les nouveaux e-mails utilisent alors votre hôte dans le lien et dans l’en-tête List-Unsubscribe. Tant qu’il n’est pas actif, et après un résultat failed (72 heures sans activation), l’hôte partagé est utilisé.

Un lien déjà envoyé garde l’hôte avec lequel il est parti, il cesse donc de fonctionner si vous supprimez ensuite le CNAME. Un sous-domaine à vous n’ouvre que les liens de son propre domaine ; tout autre lien répond 404.

Vous pouvez utiliser un même libellé pour le suivi et la désinscription, mais des noms séparés sont plus sûrs : les bloqueurs de publicités bloquent les hôtes de suivi, et un nom partagé entraînerait le lien de désinscription avec eux.

Lire et modifier les désinscriptions

GET /contacts/{id} renvoie unsubscribed (l’indicateur pour toute l’équipe) et unsubscribed_domains. Dans le tableau de bord, la page d’un contact liste les deux et vous permet de retirer la désinscription d’un domaine. L’onglet Désinscriptions sous Contacts liste chaque entrée.

# List, newest first. domain_id narrows to one domain.
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..."

# Record an opt-out from one domain (leave domain_id out for every domain)
curl -X POST "https://api.billionsend.com/unsubscribes" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'

# Remove one record
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
  -H "Authorization: Bearer bs_..."

Une entrée dont domain_id et domain valent tous deux null désinscrit l’adresse de tous les domaines. Le POST est idempotent : une entrée existante est renvoyée telle quelle. Les mêmes appels existent sous la forme des outils MCP list_unsubscribes, add_unsubscribe et delete_unsubscribe.

Ce qui lève quoi :

  • PATCH /contacts/{id} avec unsubscribed: false ne lève que la désinscription pour toute l’équipe. Les désinscriptions de domaines précis restent.
  • DELETE /unsubscribes/{id} retire cette entrée-là.

Si vous supprimez un domaine puis le recréez sous le même nom, les désinscriptions de ses destinataires s’appliquent de nouveau.

Qui peut les modifier

Les propriétaires, les administrateurs, les membres marketing et les clés API à accès complet peuvent enregistrer des désinscriptions. Seuls les propriétaires et les administrateurs peuvent en annuler une. Voir Rôles d’équipe.

Une clé API limitée à un domaine ne gère que les désinscriptions de ce domaine : les autres domaines renvoient 403 restricted_api_key.

Importer une liste depuis un CSV

Pour reprendre une liste de désinscriptions d’un autre fournisseur, ouvrez Contacts → Désinscriptions dans le tableau de bord et choisissez Importer un CSV.

email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
  • email est obligatoire. domain est facultatif. La ligne d’en-tête l’est aussi.
  • domain est l’un de vos domaines et limite la désinscription aux e-mails qui en partent. * signifie tous les domaines. Une cellule vide utilise le Domaine par défaut que vous choisissez dans la boîte de dialogue.
  • Une ligne avec un domaine inconnu ou une adresse invalide est ignorée.

La boîte de dialogue indique combien de désinscriptions ont été ajoutées, combien existaient déjà et pourquoi des lignes ont été ignorées. Importer deux fois le même fichier ne pose aucun problème.

Événements

La désinscription d’un destinataire déclenche contact.unsubscribed avec source valant hosted_page ou one_click, plus domain_id et domain_name (tous deux null pour une désinscription de toute l’équipe). L’annuler déclenche contact.resubscribed. Voir Webhooks.

Limites

Free Starter, Pro, Scale
Aspect de la page de désinscription (logo, couleurs, police, arrondi du logo) Aspect par défaut Votre propre aspect par domaine
Sous-domaine de désinscription propre Non (hôte partagé) Oui
« Powered by BillionSend » sur la page Affiché Masqué

Sur Free, définir un sous-domaine renvoie 403 plan_limit_reached. Vous pouvez enregistrer l’aspect d’une page, mais les destinataires voient l’aspect par défaut jusqu’à ce que vous changiez de forfait. Après un retour à un forfait inférieur, les aspects enregistrés sont conservés et s’appliquent de nouveau quand vous repassez à un forfait payant, et les sous-domaines déjà définis continuent de fonctionner.

Cette page vous a-t-elle été utile ?