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 par e-mail. L'extension crée et met à jour un champ delivery dans le document lorsqu'elle traite l'e-mail.

Traitement de la distribution des e-mails

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

  • state : l'une des valeurs PENDING, PROCESSING, SUCCESS ou ERROR.
  • startTime : code temporel indiquant le début du traitement de l'e-mail.
  • endTime : code temporel indiquant la fin du traitement de l'e-mail (c'est-à-dire l'état SUCCESS ou ERROR).
  • error : si une erreur de distribution d'e-mail s'est produite, un message d'erreur s'affiche ici.
  • attempts : nombre de tentatives de distribution pour 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'e-mail envoyé (à au moins une adresse), ce champ est renseigné avec les champs suivants :
    • messageId : ID du message de l'e-mail remis.
    • accepted : tableau des adresses e-mail auxquelles l'e-mail a bien été envoyé.
    • rejected : tableau des adresses e-mail auxquelles l'e-mail n'a pas pu être envoyé.
    • pending : tableau des adresses e-mail qui ont été temporairement refusées par SMTP.
    • response : dernière réponse du serveur SMTP.

Un e-mail est généralement envoyé de PENDING à PROCESSING, puis à SUCCESS ou ERROR. Une fois l'état SUCCESS ou ERROR atteint, 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 contenant des mises à jour de documents, vous pouvez remplacer state par PENDING ou RETRY.

Nouvelles tentatives manuelles

Dans certains cas, l'envoi d'e-mails échoue de manière récupérable ou le document peut être corrigé manuellement pour être envoyé correctement avec des modifications mineures. Les nouvelles tentatives ne sont pas automatiques, mais vous pouvez modifier manuellement la valeur state dans le champ delivery pour la remplacer par RETRY. L'extension tentera alors d'envoyer l'e-mail à nouveau (et incrémentera le nombre de attempts).