Administra el estado de entrega con la extensión Correo electrónico activador
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando se agrega un documento a la colección, la extensión lo retira para procesar el envío de correos electrónicos. La extensión crea y actualiza un campo delivery en el documento cuando procesa el correo electrónico.
Procesamiento de entrega de correo electrónico
El campo delivery se puede propagar con los siguientes campos:
- state: Es uno de los siguientes valores
PENDING, PROCESSING, SUCCESS o ERROR.
- startTime: Es la marca de tiempo del momento en que comenzó el procesamiento del correo electrónico.
- endTime: Es la marca de tiempo del momento en que se completó el procesamiento de correo electrónico (es decir, que finalizó en un estado
SUCCESS o ERROR).
- error: Si se produjo un error de entrega de correo electrónico, se propagará un mensaje de error aquí.
- attempts: Es la cantidad de intentos de entrega de este correo electrónico.
- leaseExpireTime: En caso de una espera o un tiempo de espera, el tiempo en el que un estado
PROCESSING se debe considerar un error.
- info: Después de la entrega exitosa del correo electrónico (al menos a una dirección), este campo se propagará con los siguientes campos:
- messageId: Es el ID del mensaje del correo electrónico entregado.
- accepted: Es el array de las direcciones de correo electrónico a las que se envió correctamente el correo electrónico.
- rejected: Es el array de direcciones de correo electrónico a las que no se pudo entregar el correo electrónico.
- pending: Es el array de direcciones de correo electrónico que SMTP rechazó de manera temporal.
- response: Es la última respuesta del servidor SMTP.
Por lo general, un correo electrónico irá de PENDING a PROCESSING, ya sea a SUCCESS o a ERROR. Una vez que se encuentren en el estado SUCCESS o ERROR, los cambios adicionales en el documento no activarán la extensión para enviar otro correo electrónico. Para volver a enviar un correo electrónico con actualizaciones de documentos, puedes cambiar state a PENDING o RETRY.
Reintentos manuales
Hay instancias en las que la entrega de correo electrónico falla de manera recuperable, o el documento se puede corregir de forma manual para una entrega adecuada con modificaciones menores. Aunque los reintentos no son automáticos, puedes cambiar de forma manual state en el campo delivery a RETRY para que la extensión vuelva a intentar la entrega del correo electrónico (y aumente la cantidad de attempts)
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-12 (UTC)
[null,null,["Última actualización: 2025-08-12 (UTC)"],[],[],null,["# Manage delivery status with the Trigger Email extension\n\n\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-------------------------\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--------------\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`)."]]
