Gérer l'état de distribution avec l'extension Trigger Email (Adresse e-mail de déclenchement)

Lorsqu'un document est ajouté à la collection, l'extension le récupère pour le traitement de l'envoi d'e-mails. L'extension crée et met à jour un champ delivery dans le document pendant le traitement de l'e-mail.

Traitement de la distribution des e-mails

Le champ delivery peut être renseigné avec les champs suivants:

  • state:PENDING, PROCESSING, SUCCESS ou ERROR.
  • startTime:code temporel du début du traitement des e-mails.
  • endTime:code temporel indiquant la fin du traitement de l'e-mail (c'est-à-dire qu'il a pris fin dans un état SUCCESS ou ERROR).
  • error:si une erreur s'est produite lors de l'envoi de l'e-mail, un message d'erreur s'affiche ici.
  • attempts:nombre de tentatives de distribution de cet e-mail.
  • leaseExpireTime:en cas de blocage ou de délai avant expiration, heure à laquelle un état PROCESSING doit être considéré comme une erreur.
  • info:une fois l'envoi de l'e-mail réussi (à au moins une adresse), les champs suivants sont renseignés dans ce champ :
    • messageId:ID du message de l'e-mail envoyé.
    • accepted:tableau d'adresses e-mail auxquelles l'e-mail a bien été envoyé.
    • rejected:tableau d'adresses e-mail auxquelles l'e-mail n'a pas pu être distribué.
    • pending:tableau d'adresses e-mail temporairement rejetées par le SMTP.
    • response:dernière réponse du serveur SMTP.

Un e-mail passe généralement de PENDING à PROCESSING, puis à SUCCESS ou à ERROR. Une fois dans l'état SUCCESS ou ERROR, les modifications supplémentaires apportées au document ne déclenchent pas l'envoi d'un autre e-mail par l'extension. Pour renvoyer un e-mail avec des mises à jour de document, vous pouvez remplacer state par PENDING ou RETRY.

Nouvelles tentatives manuelles

Il arrive que la diffusion d'e-mails échoue de manière récupérable ou que le document puisse être corrigé manuellement pour une diffusion correcte avec des modifications mineures. Bien que les nouvelles tentatives ne soient pas automatiques, vous pouvez remplacer manuellement state dans le champ delivery par RETRY pour que l'extension tente de nouveau d'envoyer l'e-mail (et augmente le nombre de attempts).