Fonctionnement d’Emailit

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 travailEspace de travailUn conteneur pour tout ce que vous envoyez : domaines, clés API, e-mails, contacts, modèles, membres et facturation. Un compte peut appartenir à plusieurs espaces 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 :

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

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.

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 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 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 en JSON signé, par lots de 100 événements au maximum par requête.

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.

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.

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 pour que les e-mails de production ne s’arrêtent jamais. Pour les forfaits et les prix, consultez Crédits et la page des tarifs.

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.

Chaque espace de travail a aussi des limites d’envoi, 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, suit le même modèle. La barre latérale comporte ces sections, de haut en bas :

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