Organizar mensajes de OutlookOrganize Outlook messages

Outlook permite a los clientes organizar sus mensajes como prefieran, tanto si quieren dejar todos sus mensajes en la carpeta Bandeja de entrada como si prefieren organizar sus mensajes en una estructura de carpetas tipo árbol dentro de la Bandeja de entrada para adaptarse a sus necesidades específicas.Outlook lets customers organize their messages the way they like it, be it leaving all messages in the same Inbox folder, or organizing messages in a tree-like folder structure under the Inbox to fit their specific needs. Puede filtrar, buscar u ordenar fácilmente los mensajes de todo el buzón del usuario o de carpetas específicas.You can conveniently filter, search, or sort messages in the user's entire mailbox or in specific folders.

Obtener acceso a carpetas de correoAccessing mail folders

Con programación, las carpetas de mensajes se representan con el recurso mailFolder, y la bandeja de entrada es una de las carpetas en el directorio raíz de la estructura de carpetas.Programmatically, message folders are represented by the mailFolder resource, and the Inbox is one of the folders at the root of the folder structure.

Cada mailFolder se identifica por su id. de carpeta y tiene una propiedad que permite la escritura displayName.Each mailFolder is identified by its folder ID, and has a writable displayName property. Outlook crea otras carpetas para los clientes de forma predeterminada.Outlook creates a few other folders for customers by default. Puede hacer referencia a estas carpetas predeterminadas por los id. de carpeta, o bien por los nombres conocidos.You can reference these default folders by their folder IDs, or by their well-known names. Para obtener una lista de los nombres de carpetas conocidos disponibles, vea Tipo de recurso mailFolder.For a list of available well-known folder names, see mailFolder resource type.

Para una carpeta personalizada que no sea predeterminada, si conoce la ruta de la carpeta, puede obtener acceso a la carpeta si primero usa el acceso directo /users/{id}/mailfolders para obtener acceso al nivel raíz y obtener todas las carpetas de nivel superior:For a custom, non-default folder, if you know its folder path, you can access the folder by first using the /users/{id}/mailfolders shortcut to get to the root level and get all the top level folders:

GET https://graph.microsoft.com/v1.0/users/{id}/mailFolders

Después, especifique el id. de carpeta ({folder_id}) al navegar a cada nivel del árbol de carpetas:Then, specify the appropriate folder ID ({folder_id}) as you navigate each level of the folder tree:

GET https://graph.microsoft.com/v1.0/users/{id}/mailFolders/{folder_id}/childfolders

Repita este procedimiento hasta que llegue a la carpeta personalizada en el árbol.Repeat until you finally get to the custom folder in the tree.

Crear y organizar el árbol de carpetasCreating and organizing the folder tree

Puede crear carpetas de correo dentro de la bandeja de entrada, o bien como carpetas secundarias dentro de otras carpetas.You can create mail folders under the Inbox, or as child folders of other folders. Al crear, copiar o mover una carpeta y su contenido, Outlook actualiza las propiedades parentFolderId y childFolderCount de solo lectura de las carpetas correspondientes.When you create, copy, or move a folder and its contents, Outlook updates the read-only parentFolderId and childFolderCount properties of the involved folders. Cuando se copia o mueve el contenido de una carpeta a otra carpeta, de forma predeterminada, los id. de entrada individuales de los contenidos también cambiarán.When the contents of a folder are copied or moved to another folder, by default, the individual entry IDs of the contents also change.

En el nivel de los contenidos, totalItemCount y unreadItemCount indican respectivamente el número de elementos y el número de elementos no leídos de una carpeta de correo.At the contents level, totalItemCount and unreadItemCount respectively tell you the number of items and number of unread items in a mail folder. En el nivel de las carpetas secundarias, puede mostrar una lista de las carpetas secundarias dentro de la bandeja de entrada o de cualquier otra carpeta.At the child folders level, you can list the child folders under the Inbox or any other folder. La propiedad childFolderCount representa el número de carpetas secundarias inmediatas.The childFolderCount property represents the number of immediate child folders.

Tenga en cuenta que las carpetas de correo de Outlook pueden contener mensajes y elementos que no sean mensajes, como eventos y contactos.Be aware that Outlook mail folders can contain messages and non-message items such as events and contacts. En general, las carpetas de Outlook pueden contener elementos heterogéneos.In general, Outlook folders can contain heterogeneous items.

Usar reglas para automatizar la copia o movimiento de mensajesUsing rules to automate copying or moving messages

Outlook permite a los clientes configurar reglas para automatizar acciones específicas en mensajes entrantes cuando se cumplan condiciones predeterminadas.Outlook lets customers set up rules to automate specific actions on incoming messages when some pre-determined conditions are met. Puede crear una regla para la bandeja de entrada, como messageRule para copiar o mover un mensaje en una carpeta específica cuando se cumplan condiciones específicas.You can create a rule for the Inbox as a messageRule to copy or move a message to a specific folder upon certain conditions. Las condiciones son messageRulePredicates.Conditions are messageRulePredicates. Algunos ejemplos pueden ser texto que aparezca en el cuerpo o el asunto del mensaje, que el mensaje se envíe desde direcciones de correo electrónico específicas, que el mensaje esté marcado como importante, etc.They can include the message subject or body containing certain text,the message sent from certain email addresses, or the message marked important, and so on.

Dirigir solo los mensajes importantes a la Bandeja de entrada PrioritariosDirecting only the messages you care for to the Focused Inbox

La Bandeja de entrada Prioritarios permite a los clientes entrenar Outlook para mostrar solo los mensajes entrantes de remitentes que consideren importantes en la pestaña Prioritarios, y el resto de los mensajes en la pestaña Otros correos. Inicialmente, el sistema de clasificación de Outlook organiza los mensajes de la bandeja de entrada de una forma predeterminada.Focused Inbox lets customers train Outlook to show only the incoming messages from senders you care for in the Focused tab, and the rest in the Other tab. Initially, Outlook's classification system organizes Inbox messages in a default way. Puede corregir y entrenar el sistema con el tiempo a través de la interfaz de usuario o con programación.Over time, you can correct and train the system through the user interface or programmatically. Cuanto más use la Bandeja de entrada Prioritarios, mejor podrá el sistema de clasificación deducir qué mensajes entrantes quiere ver en la pestaña Prioritarios.The more you use the Focused Inbox, the better the classification system can infer which incoming message you want to see in the Focused tab.

Con programación, puede actualizar la propiedad inferenceClassification de un mensaje para indicar si quiere ver el mensaje en la pestaña Prioritarios o en la pestaña Otros correos. Esta es una designación de un solo uso para un mensaje específico.Programmatically, you can update the inferenceClassification property of a message to indicate whether you want to see the message in the Focused or Other tab. This is a one-off designation for a specific message. Si, por otra parte, quiere ver mensajes de un remitente específico siempre en la pestaña Prioritarios o en la pestaña Otros correos, puede configurar una instrucción para Outlook.If, on the other hand, you want to see messages from a specific sender always in the Focused tab or Other tab, you can set an instruction for Outlook. Cada instrucción es una instancia de inferenceClassificationOverride donde se especifica que el nombre del remitente y la designación de mensajes de ese remitente siempre sea focused o other.Each instruction is an inferenceClassificationOverride instance specifying the sender's name and your designation for messages from that sender to be always focused or other. Las instrucciones de cada usuario para la Bandeja de entrada Prioritarios del usuario se almacenan como una colección de instancias de inferenceClassificationOverride en el objeto user.Each user's instructions for the user's Focused Inbox are stored as a collection of inferenceClassificationOverride instances on the user object.

Mantener actualizados los mensajes y las carpetas de correo en las aplicacionesKeeping messages and mail folders up to date in apps

Con frecuencia, las aplicaciones tienen que sincronizarse y mantener actualizados los datos de correo de un usuario en el almacén local de la aplicación.Apps often have to synchronize and keep a user's mail data up-to-date in the app local store. Microsoft Graph le permite suscribirse a notificaciones de cambios para recibir notificaciones cuando se produzcan cambios en los datos, y consultar los cambios actuales en cuanto se produzcan.Microsoft Graph lets you subscribe to change notifications to get notified when data changes, and query for actual changes as soon as they happen.

Las notificaciones se entregan con webhooks de forma asincrónica cuando se producen los cambios, lo que evita que las aplicaciones se sobrecarguen al tener que sondear frecuentemente.Notifications are delivered via webhooks asynchronously when the changes happen, saving apps the overhead to poll frequently. Puede suscribirse a notificaciones de cambios de adiciones, actualizaciones o eliminaciones en los datos de correo de un usuario.You can subscribe to change notifications about additions, updates, or deletions to a user's mail data. Por ejemplo, puede crear una suscripción a mensajes en una carpeta específica (por ejemplo, /me/mailFolders('{folderId'}')) o en el nivel raíz (por ejemplo, /me/messages).For example, you can create a subscription to messages in a specific folder (i.e., /me/mailFolders('{folderId'}')), or at the root level (i.e., /me/messages). La suscripción especifica un elemento notificationUrl, donde Microsoft Graph notificará a la aplicación cuando se produzcan los tipos de cambios solicitados.The subscription specifies a notificationUrl where Microsoft Graph notifies the app when the requested types of changes happen.

Para sincronizar inicialmente un buzón de usuario, primero realice una consulta delta en las carpetas de correo, empezando en el nivel raíz, para sincronizar todas las carpetas de correo, seguido de una consulta delta de los mensajes en cada carpeta para sincronizar los mensajes individuales.To initially synchronize a user's mailbox, first do delta query for mail folders starting at the root level to synchronize all mail folders, followed by delta query for messages in each folder to synchronize individual messages.

Para encontrar las entidades exactas que se cambiaron sin tener que leer todo el recurso con cada notificación, puede usar una consulta delta para realizar un seguimiento de los cambios que más le interesen y sincronizar el almacén local con esos cambios.To find the exact entities that have been changed without reading the entire resource with every notification, you can use delta query to track those changes that matter to you, and synchronize your local store with those changes. Puede realizar un seguimiento de los cambios en los mensajes de una carpeta específica.You can track changes to messages in a specific folder. También puede realizar un seguimiento de los cambios en las carpetas de correo en el nivel raíz (por ejemplo, /me/mailfolders).You can also track changes to mail folders at the root level (i.e., /me/mailfolders).

Pasos siguientesNext steps

Obtenga más información sobre:Find out more about: