Automatizar a criação, o envio e o processamento de mensagens

Emails são representados pelo recurso de mensagem no Microsoft Graph.

Por padrão, as mensagens são identificadas por uma ID de entrada exclusiva na propriedade id. Quando uma mensagem é criada e salva incialmente como um rascunho ou enviada, o provedor de armazenamento atribui a mensagem a uma ID de entrada. Por padrão, essa ID muda quando a mensagem é copiada ou movida para outra pasta, armazenada ou um arquivo .PST. Faça referência à mensagem usando sua ID atual para o processá-la.

Criar e enviar emails

No Outlook, você pode criar e enviar um email na mesma ação sendMail ou pode criar um rascunho, posteriormente adicionar conteúdo e enviar o rascunho.

Da mesma forma, quando responder a um email, você pode criar e enviar a resposta da mesma ação (responder, responder a todos ou encaminhar). Ou você pode criar um rascunho da resposta (responder, responder a todos, ou encaminhar), adicionar conteúdoe então enviar o rascunho mais tarde.

Para distinguir entre um rascunho e uma mensagem enviada por programação, verifique a propriedade isDraft.

Por padrão, as mensagens de rascunho são salvas na pasta Drafts As mensagens enviadas são salvas na pasta Sent Items. Para sua conveniência, é possível identificar a pasta Rascunhos e a pasta Itens enviados por seus nomes de pasta correspondentes já bem conhecidos.

Definindo as propriedades de e do remetente

Quando uma mensagem está sendo redigida, na maioria dos casos, o Outlook configura as propriedades from e sender para o mesmo usuário conectado. Você pode atualizar essas propriedades nas seguintes situações:

• A propriedade from poderá ser alterada se o administrador do Exchange tiver atribuído sendAs direitos da caixa de correio para alguns outros usuários. O administrador pode fazer isso selecionando permissões de caixa de correio do proprietário da caixa de correio no portal do Azure ou usando o Centro de Administração do Exchange ou um cmdlet Windows PowerShell Add-ADPermission. Em seguida, você pode definir programaticamente a de propriedade para um desses usuários que têm direitos sendAs para essa caixa de correio.
• A propriedade sender poderá ser alterada se o proprietário da caixa de correio tiver delegado o envio de mensagens dessa caixa de correio para um ou mais usuários. O proprietário da caixa de correio pode delegar no Outlook. Quando um representante envia uma mensagem em nome do proprietário da caixa de correio, o Outlook define a propriedade sender como a conta desse representante, enquanto a propriedade from continua a do proprietário da caixa de correio. Você pode definir programaticamente a propriedade sender para um usuário com permissões de representante para essa caixa de correio.

Usar as Dicas de Email para verificar o status do destinatário e economizar tempo (visualização)

Use as Dicas de Email para tomar decisões inteligentes antes de enviar um email. As Dicas de Email podem lhe dar informações, como saber que a caixa de correio do destinatário é restrita para remetentes específicos, ou que aprovação é necessária para enviar emails ao destinatário.

Ler mensagens com controle sobre o formato de corpo retornado

Você pode ler uma mensagem em uma caixa de correio fazendo referência a sua ID:

GET /me/messages/AAMkADhMGAAA=

Ou, pode receber as mensagens em uma pasta específica. Por exemplo, para ler mensagens na pasta Rascunhos do usuário conectado:

GET /me/mailfolders('Drafts')

O corpo de uma mensagem do Outlook pode ser HTML ou texto, com HTML sendo retornado como o tipo de corpo da mensagem padrão na resposta GET.

Quando receber uma mensagem, você poderá especificar o cabeçalho da solicitação a seguir para retornar as propriedades body e uniqueBody no formato de texto:

Prefer: outlook.body-content-type="text"

Você pode especificar o cabeçalho a seguir ou, apenas ignorar o cabeçalho, para obter o corpo da mensagem no formato HTML:

Prefer: outlook.body-content-type="html"

Quando você especifica um cabeçalho, uma resposta bem-sucedida inclui o cabeçalho Preference-Applied correspondente:

• Para solicitações de formato de texto: Preference-Applied: outlook.body-content-type="text"
• Para solicitações de formato HTML: Preference-Applied: outlook.body-content-type="html"

Se o corpo for HTML, por padrão, o Outlook remove qualquer HTML potencialmente não seguro (por exemplo, JavaScript) inserido na propriedade body antes de retornar o conteúdo do corpo em uma resposta REST.

Para obter o conteúdo HTML completo original, inclua o seguinte cabeçalho da solicitação HTTP:

Prefer: outlook.allow-unsafe-html

Integrar com o gesto social "@" (visualização)

As menções com @ são notificações para alertar os usuários quando eles são mencionados nas mensagens. O recurso mention permite que os aplicativos configurem e acessem gestos sociais online comuns, como o prefixo "@", em emails. Você pode:

• Criar menções com @ quando criar uma mensagem
• Obter todas as mensagens na caixa de correio do usuário que contenham uma menção com @ do usuário
• Obter todas as menções com @ que sejam mensagens

Outras funcionalidades compartilhadas

Aproveite as seguintes funcionalidades comuns que são compartilhadas entre entidades do Microsoft Graph:

• Assine as notificações de alteração em mensagens quando ocorrem um ou mais tipos de alterações, como a criação de mensagens ou atualização.
• Acompanhar as alterações incrementais nas mensagens em uma pasta.
• Crie extensões abertas ou extensões de esquema para adicionar dados personalizados a uma instância de mensagem.
• Crie propriedades estendidas em uma instância da mensagem para armazenar dados personalizados para as propriedades MAPI do Outlook, quando essas propriedades ainda não estão expostas nos metadados da API do Microsoft Graph.

Próximas etapas

• Por que integrar com o email do Outlook
• Obter conteúdo MIME (visualização)
• Receber mensagens compartilhadas
• Enviar mensagens do Outlook de outro usuário
• Obter identificadores imutáveis para recursos do Outlook
• Como usar a API de email e seus casos de uso do Microsoft Graph versão 1.0.