Suplementos do Outlook e EWS no Exchange

Encontre informações sobre suplementos do Outlook e como eles funcionam com o EWS no Exchange.

Os suplementos do Outlook fornecem uma interface única e um modelo de programação que usa padrões da Web para permitir que você crie uma experiência personalizada para seus usuários de email. Você pode criar aplicativos de email que exibem informações contextuais ou úteis em um quadro HTML5 hospedado no Outlook; por exemplo, um aplicativo de email pode mostrar um mapa do Bing com um endereço realçado quando uma mensagem de email contém um endereço. Ou quando um usuário está redigindo uma mensagem, um aplicativo de email pode mostrar informações adicionais sobre o destinatário e inserir uma saudação padrão no email ao toque de um botão.

A interface de aplicativos de email faz parte da API JavaScript para Office. Você pode usar a API para acessar informações no Exchange para habilitar seu aplicativo de email para:

• Reconheça entidades, como endereços, números de telefone, sugestões de tarefas ou sugestões de reuniões em um email.

• Abra e exiba Mensagens e Compromissos em uma exibição separada para que os usuários possam fazer referência cruzada de informações em uma ou mais mensagens.

• Faça solicitações EWS ao servidor Exchange que hospeda a caixa de correio do usuário. Um aplicativo de email pode, por exemplo, obter uma lista de pastas para que o usuário possa escolher uma para armazenar a mensagem ou mostrar todos os itens em uma conversa ou marcar uma mensagem de email como lixo eletrônico.

• Obtenha um token para identificar exclusivamente uma conta de email para habilitar o logon único em um serviço de terceiros.

• Obtenha um token que permita que um serviço de terceiros faça solicitações EWS em nome do usuário, por exemplo, para extrair os anexos de um item ou obter um item do servidor Exchange para processamento adicional.

Você pode usar aplicativos de email para personalizar a experiência do Outlook Web App para seus usuários; se, no entanto, você quiser personalizar a "aparência" do Outlook Web App, consulte estes artigos no TechNet:

• Criar um tema para o Outlook Web App

• Personalizar as páginas de entrada do Outlook Web App, de seleção de idioma e de erro

Sua organização pode instalar aplicativos de email em um servidor interno para limitar o acesso a usuários autorizados ou você e outros desenvolvedores de aplicativos de email podem colocar aplicativos de email na Office Store para venda ao público em geral. Qualquer pessoa que esteja executando o Outlook pode baixar, instalar e usar aplicativos de email do marketplace.

Se você quiser saber mais sobre como criar aplicativos de email, confira a documentação de suplementos do Outlook ou o exemplo de solicitação de EWS.

Suplementos do EWS e do Outlook

Você pode usar um subconjunto de operações do EWS no servidor Exchange que hospeda a conta que executa um aplicativo de email.

A função mailbox.makeEwsRequestAsync permite que você faça solicitações EWS do seu aplicativo de email de volta para o servidor que hospeda a caixa de correio do usuário. Você cria o envelope SOAP e a solicitação XML e a função makeEwsRequestAsync chama o EWS com um token de autenticação que identifica a caixa de correio e o aplicativo de email que está fazendo a solicitação. Para ajudar a proteger a caixa de correio do usuário, o servidor Exchange rejeitará todas as solicitações que não vêm do aplicativo de email ou de uma caixa de correio que não está hospedada no servidor.

Como qualquer outro aplicativo, um aplicativo de email precisa de permissões para funcionar. O administrador precisa:

• Conceder acesso EWS ao usuário de aplicativos de email.

• Definir "OAuthAuthentication" como verdadeiro no diretório EWS do servidor de acesso para cliente.

Você também precisa certificar-se de que seu aplicativo solicita a permissão de caixa de correio de leitura/gravação nos aplicativos para o modelo de permissão do Office.

Quando essas etapas forem concluídas, um subconjunto de operações EWS de pasta e item estará disponível para o aplicativo de email usar.

Tabela 1. Operações de pasta e item do EWS que os aplicativos de email podem usar

Tokens de retorno de chamada de serviço

Os tokens de retorno de chamada de serviço permitem que os aplicativos de email transmitam um token de acesso para um serviço de terceiros para que o serviço possa fazer solicitações EWS para o servidor Exchange que hospeda a caixa de correio. Por exemplo, um aplicativo de email pode passar um token de retorno de chamada de serviço para um serviço de terceiros, juntamente com uma lista de IDs de anexo para imagens anexadas a um email. Em seguida, o serviço pode usar as IDs de anexo e o token de retorno de chamada para fazer uma solicitação EWS ao servidor Exchange do usuário para obter as imagens anexadas. Os aplicativos de email também podem usar o token de retorno de chamada de serviço com uma lista de IDs de item para obter emails e itens de compromisso do servidor Exchange.

O token de retorno de chamada de serviço é um token opaco que o serviço de terceiros anexa à solicitação EWS em um cabeçalho de autenticação de portador. O token identifica o aplicativo de email e a caixa de correio para ajudar a proteger a solicitação do EWS. Para saber como usar tokens de retorno de chamada de serviço, consulte os suplementos do Outlook: obter anexos de um exemplo de servidor Exchange.

Confira também

• Controlar o acesso do aplicativo cliente ao EWS no Exchange

• Método Mailbox.makeEwsRequestAsync (JavaScript API para Office)

• Suplementos do Outlook

• Método Mailbox.getUserIdentityTokenAsync (JavaScript API para Office)

• Autenticar um suplemento do Outlook usando tokens de identidade do Exchange

• Noções básicas sobre permissões de suplemento do Outlook

• Set-WebServicesVirtualDirectory

• Suplementos do Outlook: faça uma solicitação EWS

• Suplementos do Outlook: use um token de identidade do cliente

• Suplementos do Outlook: obter anexos de um servidor Exchange