Automatizar la creación, el envío y el procesamiento de mensajes
Los correos electrónicos se representan mediante el recurso message en Microsoft Graph.
De forma predeterminada, los mensajes se identifican por un identificador de entrada único en la propiedad id. Cuando se crea y se guarda inicialmente como borrador un mensaje o se envía, el proveedor de almacén asigna al mensaje un id. de entrada. De manera predeterminada, ese id. cambia cuando el mensaje se copia o se mueve a otra carpeta, almacén o archivo .PST. Se hace referencia el mensaje con su Id. actual para un procesamiento adicional.
Crear y enviar correos electrónicos
En Outlook, puede crear y enviar un correo electrónico en la misma acción sendMail, o bien puede crear un borrador, posteriormente agregar contenido y enviar el borrador.
De forma similar, cuando responde a un correo electrónico, puede crear y enviar la respuesta en la misma acción (reply, reply-all o forward). O bien, puede crear un borrador de la respuesta (reply, reply-all or forward), agregar contenido y enviar el borrador más tarde.
Para distinguir un borrador de un mensaje enviado mediante programación, consulte la propiedad isDraft.
De forma predeterminada, los borradores se guardan en la carpeta Drafts y los mensajes enviados en la carpeta Sent Items. Para mayor comodidad, puede identificar las carpetas Borradores y Elementos enviados por sus nombres de carpeta conocidos correspondientes.
Configurar las propiedades from y sender
Cuando se redacta un mensaje, en la mayoría de los casos, Outlook establece las propiedades from y sender para el mismo usuario que haya iniciado sesión. Puede actualizar estas propiedades en las siguientes situaciones:
- La propiedad from se puede cambiar si el administrador de Exchange ha asignado derechos sendAs del buzón a otros usuarios. El administrador puede hacerlo seleccionando Permisos de buzón del propietario del buzón en el Azure Portal, o bien mediante el Centro de Administración de Exchange o un cmdlet de Windows PowerShell Add-ADPermission. A continuación, puede establecer mediante programación la propiedad from en uno de estos usuarios que tienen derechos sendAs para ese buzón.
- La propiedad sender se puede cambiar si el propietario del buzón ha delegado uno o más usuarios para que puedan enviar mensajes desde ese buzón. El propietario del buzón puede delegar en Outlook. Cuando un delegado envía un mensaje en nombre del propietario del buzón, Outlook establece la propiedad sender en la cuenta del delegado y la propiedad from sigue siendo el propietario del buzón. Mediante programación, puede configurar la propiedad sender para un usuario que tiene permisos de delegado en ese buzón.
Usar Sugerencias de correo electrónico para comprobar el estado del destinatario y ahorrar tiempo (versión preliminar)
Use Sugerencias de correo electrónico para tomar decisiones inteligentes antes de enviar un correo electrónico. Las Sugerencias de correo electrónico pueden proporcionarle información, como que el buzón del destinatario está limitado a determinados remitentes o si se necesita aprobación para enviar un correo electrónico al destinatario.
Se devolvió la lectura de mensajes con control del formato de cuerpo
También puede leer un mensaje en un buzón haciendo referencia a su Id.:
GET /me/messages/AAMkADhMGAAA=
Puede recibir mensajes en una carpeta específica. Por ejemplo, para leer mensajes en la carpeta de borradores del usuario que haya iniciado sesión:
GET /me/mailfolders('Drafts')
El cuerpo del mensaje de Outlook puede ser un HTML o un texto, con HTML como el tipo de cuerpo del mensaje predeterminado que se devuelve en una respuesta GET.
Al recibir un mensaje, puede especificar el siguiente encabezado de solicitud para devolver las propiedades body y uniqueBody en el formato del texto:
Prefer: outlook.body-content-type="text"
Puede especificar el siguiente encabezado o, simplemente, omitir el encabezado, para obtener el cuerpo del mensaje en formato HTML:
Prefer: outlook.body-content-type="html"
Al especificar cualquier encabezado, una respuesta correcta incluirá el encabezado Preference-Applied correspondiente:
- Para las solicitudes de formato de texto:
Preference-Applied: outlook.body-content-type="text" - Para las solicitudes de formato HTML:
Preference-Applied: outlook.body-content-type="html"
Si el cuerpo se muestra en HTML, de forma predeterminada, Outlook quita cualquier código HTML potencialmente peligroso (por ejemplo, JavaScript) insertado en la propiedad body antes de devolver el contenido del cuerpo en una respuesta REST.
Para obtener todo el contenido HTML original, incluya el siguiente encabezado de solicitud HTTP:
Prefer: outlook.allow-unsafe-html
Integrar con el gesto de redes sociales "@" (vista previa)
Las @menciones son notificaciones para avisar a los usuarios si se les menciona en los mensajes. El recurso mention permite a las aplicaciones configurar y obtener el gesto de redes sociales en línea común, el prefijo "@", en los mensajes de correo electrónico. Puede:
- Crear @menciones al crear un mensaje
- Obtener todos los mensajes del buzón de un usuario que contiene una @mención al usuario
- Obtener todas las @menciones en un mensaje
Otras funcionalidades compartidas
Aproveche las ventajas de las siguientes funciones comunes que se comparten entre las entidades de Microsoft Graph:
- Suscríbase a las notificaciones de cambios en los mensajes cuando se produce uno o varios tipos de cambios, como la creación o actualización del mensaje.
- Hacer un seguimiento de los cambios incrementales en los mensajes de una carpeta
- Cree extensiones abiertas o extensiones de esquema para agregar datos personalizados a una instancia de mensaje.
- Cree propiedades extendidas en una instancia de mensaje para almacenar datos personalizados de las propiedades MAPI de Outlook cuando estas propiedades aún no están expuestas en los metadatos de la API de Microsoft Graph.