Complementos de Outlook y EWS en ExchangeOutlook add-ins and EWS in Exchange

Encuentre información sobre los complementos de Outlook y cómo funcionan con EWS en Exchange.Find information about Outlook add-ins and how they work with EWS in Exchange.

Los complementos de Outlook proporcionan una interfaz única y un modelo de programación que usa estándares web para permitirle crear una experiencia personalizada para los usuarios de correo electrónico.Outlook add-ins provide a single interface and programming model that uses web standards to enable you to create a custom experience for your email users. Puede crear aplicaciones de correo que muestren información contextual o útil en un marco de HTML5 hospedado en Outlook; por ejemplo, una aplicación de correo puede mostrar un mapa de Bing con una dirección resaltada cuando un mensaje de correo electrónico contiene una dirección.You can create mail apps that display contextual or helpful information in an HTML5 frame hosted in Outlook; for example, a mail app can show a Bing map with an address highlighted when an email message contains an address. O bien, cuando un usuario redacta un mensaje, una aplicación de correo puede mostrar información adicional sobre el destinatario e insertar un saludo estándar en el correo electrónico con sólo pulsar un botón.Or when a user is composing a message, a mail app can show additional information about the recipient, and insert a standard greeting into the email at the touch of a button.

Nota

En este artículo, "Outlook" hace referencia al cliente enriquecido de Outlook, Outlook RT, Outlook Web App y OWA para dispositivos."Outlook" in this article refers to the Outlook rich client, Outlook RT, Outlook Web App, and OWA for Devices.

La interfaz de aplicaciones de correo forma parte de la API de JavaScript para Office.The mail apps interface is part of the JavaScript API for Office. Puede usar la API para obtener acceso a la información de Exchange para habilitar su aplicación de correo para:You can use the API to access information in Exchange to enable your mail app to:

  • Reconocer entidades, como direcciones, números de teléfono, sugerencias de tareas o sugerencias de reunión en un correo electrónico.Recognize entities, like addresses, phone numbers, task suggestions, or meeting suggestions in an email.

  • Abrir y mostrar mensajes y citas existentes en una vista independiente para que los usuarios puedan hacer referencias cruzadas de la información en uno o más mensajes.Open and display existing messages and appointments in a separate view so that users can cross-reference information in one or more messages.

  • Realizar solicitudes EWS al servidor Exchange que hospeda el buzón del usuario.Make EWS requests to the Exchange server that hosts the user's mailbox. Una aplicación de correo puede, por ejemplo, obtener una lista de carpetas para que el usuario pueda elegir una para almacenar el mensaje o Mostrar todos los elementos de una conversación, o marcar un mensaje de correo electrónico como correo no deseado.A mail app can, for example, get a list of folders so that the user can choose one to store the message, or show all the items in a conversation, or mark an email message as junk.

  • Obtenga un token para identificar de forma única una cuenta de correo electrónico para habilitar el inicio de sesión único en un servicio de terceros.Get a token to uniquely identify an email account to enable single sign on on a third-party service.

  • Obtenga un token que habilita a un servicio de terceros para realizar solicitudes EWS en nombre del usuario, por ejemplo, para extraer los datos adjuntos de un elemento o para obtener un elemento del servidor Exchange para su procesamiento posterior.Get a token that enables a third-party service to make EWS requests on behalf of the user, for example, to extract the attachments from an item, or to get an item from the Exchange server for further processing.

Puede usar aplicaciones de correo para personalizar la experiencia de Outlook Web App para los usuarios; sin embargo, si desea personalizar la "apariencia" de Outlook Web App, consulte estos artículos en TechNet:You can use mail apps to customize the Outlook Web App experience for your users; if, however, you want to customize the "look and feel" of Outlook Web App, see these articles on TechNet:

Su organización puede instalar aplicaciones de correo en un servidor interno para limitar el acceso a los usuarios autorizados, o usted y otros desarrolladores de aplicaciones de correo pueden poner aplicaciones de correo en la tienda Office para su venta al público en general.Your organization can install mail apps on an internal server to limit access to authorized users, or you and other mail app developers can put mail apps on the Office Store for sale to the general public. Cualquier usuario que ejecute Outlook puede descargar, instalar y usar aplicaciones de correo desde el catálogo de soluciones.Anyone who is running Outlook can download, install, and use mail apps from the marketplace.

Si desea obtener más información sobre la creación de aplicaciones de correo, consulte la documentación de complementos de Outlook o el ejemplo realizar una solicitud EWS .If you want to learn more about creating mail apps, check out the Outlook add-ins documentation or the Make an EWS request sample.

EWS y complementos de OutlookEWS and Outlook add-ins

Puede usar un subconjunto de operaciones de EWS en el servidor de Exchange que hospeda la cuenta que ejecuta una aplicación de correo.You can use a subset of EWS operations on the Exchange server that hosts the account that runs a mail app.

La función Mailbox. makeEwsRequestAsync permite realizar solicitudes EWS desde la aplicación de correo de vuelta al servidor que hospeda el buzón del usuario.The mailbox.makeEwsRequestAsync function enables you to make EWS requests from your mail app back to the server that hosts the user's mailbox. Cree el envoltorio SOAP y la solicitud XML, y la función makeEwsRequestAsync llama a EWS con un token de autenticación que identifica el buzón y la aplicación de correo que realiza la solicitud.You create the SOAP envelope and XML request, and the makeEwsRequestAsync function calls EWS with an authentication token that identifies the mailbox and mail app that is making the request. Para ayudar a proteger el buzón del usuario, el servidor Exchange rechazará todas las solicitudes que no provengan de la aplicación de correo o de un buzón que no esté hospedado en el servidor.To help secure the user's mailbox, the Exchange server will reject any requests that do not come from the mail app or from a mailbox that is not hosted on the server.

Como cualquier otra aplicación, una aplicación de correo necesita permisos para funcionar.Like any other application, a mail app needs permissions to work. El administrador debe:Your administrator needs to:

También debe asegurarse de que la aplicación solicita el permiso buzón de lectura y escritura en el modelo de permisosde aplicaciones para Office.You also need to make sure that your app requests the read/write mailbox permission in the apps for Office permission model.

Una vez completados estos pasos, se puede usar un subconjunto de las operaciones de EWS de elementos y carpetas para que la aplicación de correo la use.When these steps are complete, a subset of folder and item EWS operations are available for the mail app to use.

Tabla 1. Operaciones de elementos y carpetas de EWS que las aplicaciones de correo pueden usarTable 1. EWS folder and item operations that mail apps can use

Operaciones de carpetaFolder operations Operaciones de elementosItem operations
Operación CreateFolderCreateFolder operation
Operación FindFolderFindFolder operation
Operación GetFolderGetFolder operation
Operación UpdateFolderUpdateFolder operation
Operación CopyItemCopyItem operation
Operación CreateItemCreateItem operation
Operación FindItemFindItem operation
Operación FindConversationFindConversation operation
Operación GetConversationItemsGetConversationItems operation
Operación GetItemGetItem operation
Operación MarkAsJunkMarkAsJunk operation
Operación MoveItemMoveItem operation
Operación SendItemSendItem operation
Operación UpdateItemUpdateItem operation

Tokens de devolución de llamada de servicioService callback tokens

Los tokens de devolución de llamada de servicio permiten a las aplicaciones de correo pasar un token de acceso a un servicio de terceros para que el servicio pueda realizar solicitudes EWS al servidor Exchange que hospeda el buzón.Service callback tokens enable mail apps to pass an access token to a third-party service so that the service can make EWS requests to the Exchange server that hosts the mailbox. Por ejemplo, una aplicación de correo puede pasar un token de devolución de llamada de servicio a un servicio de terceros junto con una lista de identificadores de datos adjuntos para imágenes adjuntas a un correo electrónico.For example, a mail app can pass a service callback token to a third-party service along with a list of attachment IDs for pictures attached to an email. A continuación, el servicio puede usar los identificadores de datos adjuntos y el token de devolución de llamada para realizar una solicitud de EWS al servidor de Exchange del usuario para obtener las imágenes adjuntas.The service can then use the attachment IDs and the callback token to make an EWS request to the user's Exchange server to get the attached pictures. Las aplicaciones de correo también pueden usar el token de devolución de llamada de servicio con una lista de identificadores de elemento para obtener los elementos de correo electrónico y citas del servidor Exchange.Mail apps can also use the service callback token with a list of item IDs to get email and appointment items from the Exchange server.

El token de devolución de llamada de servicio es un token opaco que el servicio de terceros se adjunta a la solicitud de EWS en un encabezado de autenticación de portador.The service callback token is an opaque token that the third-party service attaches to the EWS request in a bearer authentication header. El token identifica la aplicación de correo y el buzón para ayudar a proteger la solicitud de EWS.The token identifies the mail app and the mailbox to help secure the EWS request. Para obtener información sobre cómo usar los tokens de devolución de llamada de servicio, vea la muestra de Complementos de Outlook: obtener datos adjuntos de un servidor de Exchange .To learn how to use service callback tokens, see the Outlook add-ins: Get attachments from an Exchange server sample.

Vea tambiénSee also