Zarządzanie stanem dostarczenia za pomocą rozszerzenia e-maila aktywującego
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Gdy dokument zostanie dodany do kolekcji, rozszerzenie pobierze go do przetworzenia i wysłania e-mailem. Podczas przetwarzania e-maila rozszerzenie tworzy i aktualizuje pole delivery w dokumencie.
Przetwarzanie dostarczania poczty e-mail
Pole delivery może zawierać te pola:
state: jeden z tych stanów: PENDING, PROCESSING, SUCCESS lub ERROR.
endTime: sygnatura czasowa zakończenia przetwarzania e-maila (czyli zakończenia w stanie SUCCESS lub ERROR).
error:jeśli wystąpił błąd dostarczania e-maila, pojawi się tu komunikat o błędzie.
attempts: liczba prób dostarczenia tego e-maila.
leaseExpireTime: w przypadku zawieszenia lub przekroczenia limitu czasu czas, w którym stan PROCESSING powinien być uznawany za błąd.
info: po pomyślnym dostarczeniu e-maila (na co najmniej 1 adres) to pole zostanie wypełnione tymi polami:
messageId: identyfikator dostarczonego e-maila.
accepted:tablica adresów e-mail, na które e-mail został dostarczony.
rejected:tablica adresów e-mail, na które nie udało się dostarczyć e-maila.
pending:tablica adresów e-mail, które zostały tymczasowo odrzucone przez SMTP.
response: ostatnia odpowiedź z serwera SMTP.
E-mail zwykle przechodzi z PENDING do PROCESSING, a następnie do SUCCESS lub ERROR. Gdy dokument jest w stanie SUCCESS lub ERROR, dodatkowe zmiany w dokumencie nie spowodują wysłania kolejnego e-maila przez rozszerzenie. Aby ponownie wysłać e-maila z aktualizacjami dokumentu, możesz zmienić state na PENDING lub RETRY.
Ręczne ponawianie
W niektórych przypadkach dostarczenie e-maila nie powiedzie się w sposób, który można naprawić, lub dokument można ręcznie poprawić, aby dostarczyć go prawidłowo, wprowadzając niewielkie zmiany. Ponowne próby nie są automatyczne, ale możesz ręcznie zmienić wartość w polu delivery na RETRY, aby rozszerzenie ponownie spróbowało dostarczyć e-maila (i zwiększyło liczbę attempts).state
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["\u003cbr /\u003e\n\nWhen a document is added to the collection, the extension picks it up for email\ndelivery processing. The extension creates and updates a `delivery` field in the\ndocument as it processes the email.\n\nEmail delivery processing\n\nThe `delivery` field can be populated with the following fields:\n\n- **state:** One of `PENDING`, `PROCESSING`, `SUCCESS`, or `ERROR`.\n- **startTime:** Timestamp when email processing began.\n- **endTime:** Timestamp when email processing completed (that is, ended in either a `SUCCESS` or `ERROR` state).\n- **error:** If there was an email delivery error, an error message will be populated here.\n- **attempts:** Number of delivery attempts for this email.\n- **leaseExpireTime:** In case of a hang or timeout, the time at which a `PROCESSING` state should be considered an error.\n- **info:** After successful email delivery (to at least one address), this field will be populated with the following fields:\n - **messageId:** The message ID of the delivered email.\n - **accepted:** Array of email addresses to which the email was successfully delivered.\n - **rejected:** Array of email addresses to which the email could not be delivered.\n - **pending:** Array of email addresses that were temporarily rejected by SMTP.\n - **response:** The last response from the SMTP server.\n\nAn email will typically go from `PENDING` to `PROCESSING` to either `SUCCESS` or\n`ERROR`. Once in the `SUCCESS` or `ERROR` state, additional changes to the\ndocument will not trigger the extension to send another email. To resend an\nemail with document updates, you can change the `state` to `PENDING` or `RETRY`.\n\nManual retries\n\nThere are instances in which email delivery fails in a recoverable fashion or\nthe document can be manually corrected for proper delivery with minor\nmodifications. While retries are not automatic, you can manually change the\n`state` in the `delivery` field to `RETRY` so that the extension attempts email\ndelivery again (and increments the number of `attempts`)."]]
