Journal des modifications : API e-mail

Le bouton Retry d’un e-mail retenu fonctionne désormais, et Relancer un e-mail accepte les e-mails au statut held. Corrigez d’abord la raison pour laquelle l’e-mail a été retenu, par exemple un score de spam élevé ou des crédits manquants, puis relancez-le.

Une relance crée un nouvel e-mail avec un nouvel ID et coûte des crédits comme tout autre envoi. Les e-mails de plus de 30 jours, ou dont le contenu a été supprimé par la conservation des données, ne peuvent pas être relancés. Consultez Relancer et transférer.

Emailit compare les adresses de Reply-To et de From, sans tenir compte des noms d’affichage ni de la casse. Lorsqu’elles sont identiques, il supprime Reply-To avant de signer le message. Les réponses parviennent toujours à l’adresse From.

Lorsque les adresses diffèrent, Reply-To est conservé tel quel. Consultez En-têtes d’e-mail.

• L’API et le SMTP comparent le domaine From sans tenir compte de la casse : ada@Acme.com envoie donc depuis le domaine vérifié acme.com.
• Modifier le sous-domaine de suivi ou de réception d’un domaine dans le tableau de bord, ou avec tracking_key et inbound_key dans Mettre à jour un domaine, enregistre désormais la nouvelle valeur. Publiez l’enregistrement DNS correspondant au nouveau nom et vérifiez-le.

• Les clés API créées avant l’introduction du préfixe secret_ sont de nouveau acceptées sur /v2.
• Récupérer un e-mail renvoie l’objet e-mail complet, y compris object, from et to.
• Les réponses des domaines renvoient track_loads et track_clicks sous la forme 0 ou 1, comme documenté.

Une requête d’envoi avec tracking activé échouait auparavant avec 422 lorsque le domaine d’envoi n’avait pas de CNAME de suivi vérifié. Emailit accepte désormais l’e-mail et l’envoie sans réécrire les liens ni ajouter le pixel d’ouverture.

Pour suivre les ouvertures et les clics, publiez l’enregistrement CNAME de suivi de votre domaine et vérifiez-le. Consultez Domaine de suivi personnalisé.

Les échecs temporaires étaient enregistrés sur la livraison, mais l’e-mail conservait son statut précédent. L’e-mail lui-même passe désormais à attempted pendant qu’Emailit réessaie : la liste des e-mails et l’API indiquent ainsi quels e-mails sont retardés.

Les statuts ultérieurs, comme delivered, et les statuts définitifs ne sont pas écrasés. Consultez Statuts des e-mails.

• Compose, sur la page Emails ou dans Quick Actions sur le tableau de bord, envoie un e-mail ponctuel depuis un domaine vérifié, par exemple pour tester votre configuration. Sous Advanced, vous pouvez attribuer l’envoi à une clé API. Compose autorise 3 e-mails par minute et 10 par heure par espace de travail. Consultez Compose.
• Cancel delivery retire de la file d’attente un e-mail accepté, programmé ou en échec temporaire. L’annulation se fait au mieux : un e-mail déjà en cours de remise au serveur du destinataire peut tout de même être livré. Consultez Annuler un e-mail.

Sélectionnez Forward sur la page de détail d’un e-mail, ou appelez Transférer un e-mail avec une adresse to. Par défaut, le destinataire reçoit une simple copie. Activez les en-têtes d’origine et ajoutez un commentaire si vous voulez donner du contexte.

Un transfert est un nouvel e-mail : il coûte des crédits et compte dans vos limites d’envoi. Vous pouvez transférer 3 e-mails par heure et par espace de travail. Consultez Relancer et transférer.

La règle du mode bac à sable s’applique désormais à l’API, au SMTP, à Compose, aux relances, aux automatisations et aux campagnes. Un envoi à toute autre personne renvoie 403 avec le code unverified_workspace_recipient depuis l’API et 550 depuis SMTP, et les envois de campagne sont bloqués. Les espaces de travail qui ont l’accès production ne sont pas concernés.

Pour lever la restriction, vérifiez un domaine et demandez l’accès production.

Les clés d’envoi uniquement pouvaient auparavant lister et récupérer des e-mails et appeler certains autres endpoints de lecture. Elles sont désormais limitées à Envoyer un e-mail et aux actions sur un e-mail existant : reprogrammer, annuler, relancer et transférer. Les autres endpoints rejettent les clés d’envoi.

Si votre intégration lit aussi des e-mails, des domaines ou d’autres ressources, utilisez une clé à accès complet pour ces appels. Consultez Clés API.

• Lister les e-mails : GET /v2/emails
• Récupérer le MIME brut : GET /v2/emails/:id/raw
• Récupérer le corps : GET /v2/emails/:id/body
• Récupérer les métadonnées : GET /v2/emails/:id/meta
• Lister les pièces jointes : GET /v2/emails/:id/attachments

Ces endpoints nécessitent une clé à accès complet. Le contenu reste disponible jusqu’à ce que la durée de conservation des données de votre forfait le supprime.

Les e-mails et les livraisons existants ont été migrés vers les nouveaux noms. Les événements et les requêtes de webhook créés avant le changement conservent les valeurs avec lesquelles ils ont été envoyés. Pour la liste actuelle, consultez Statuts des e-mails.

Créez vos modèles avec l’éditeur HTML, l’éditeur de texte enrichi ou l’éditeur glisser-déposer Dragit. Les modèles qui partagent un alias sont les versions d’un même modèle, et seule la version publiée est utilisée quand vous envoyez par alias.

Gérez les modèles avec l’API des modèles, et envoyez-en un en transmettant template et variables à Envoyer un e-mail. Consultez Modèles.

Retry duplique l’e-mail d’origine, attribue un nouvel ID à la copie et l’envoie par le circuit d’envoi normal. La copie est facturée comme tout nouvel e-mail. Pour relancer un e-mail depuis votre code, appelez Relancer un e-mail.

• Envoyer un e-mail : chaque destinataire reçoit son propre ID d’e-mail. Programmez l’envoi avec une date ISO 8601, un horodatage Unix ou du langage naturel comme « tomorrow at 9am », et évitez les doublons avec l’en-tête Idempotency-Key.
• Récupérer un e-mail : statut, en-têtes, contenu, paramètres de suivi et métadonnées.
• Mettre à jour un e-mail programmé : modifiez l’heure d’envoi jusqu’à 3 minutes avant l’échéance.
• Annuler un e-mail : arrêtez un e-mail programmé ou en file d’attente.

Chaque réponse d’envoi inclut les en-têtes ratelimit-*. Consultez Limites de débit.

Les requêtes qui dépassent la limite sont rejetées au lieu d’être mises en file d’attente : configurez donc votre client pour qu’il envoie au maximum 2 e-mails par seconde ou qu’il relance les envois rejetés. Le changement a été déployé progressivement sur les espaces de travail.

Consultez Limites de débit.