Automatizar a criação, o envio e o processamento de mensagensAutomate creating, sending, and processing messages

Emails são representados pelo recurso de mensagem no Microsoft Graph.Emails are represented by the message resource in Microsoft Graph.

Por padrão, as mensagens são identificadas por uma ID de entrada exclusiva na propriedade id.By default, messages are identified by a unique entry ID in the id property. Quando uma mensagem é criada e salva incialmente como um rascunho ou enviada, o provedor de armazenamento atribui a mensagem a uma ID de entrada.When a message is initially created and saved as a draft or sent, the store provider assigns the message an entry ID. Por padrão, essa ID muda quando a mensagem é copiada ou movida para outra pasta, armazenada ou um arquivo .PST.By default, that ID changes when the message is copied or moved to another folder, store, or .PST file. Faça referência à mensagem usando sua ID atual para o processá-la.You reference the message by its current ID for further processing.

Criar e enviar mensagensCreating and sending mail

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.In Outlook, you can create and send an email in the same sendMail action, or you can create a draft, subsequently add content and send the draft.

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).Similarly, when responding to an email, you can create and send the response in the same action (reply, reply-all, or forward). Ou você pode criar um rascunho da resposta (responder, responder a todos, ou encaminhar), adicionar conteúdoe então enviar o rascunho mais tarde.Or, you can create a draft for the response (reply, reply-all, or forward), add content, and then send the draft at a later time.

Para distinguir entre um rascunho e uma mensagem enviada por programação, verifique a propriedade isDraft.To distinguish between a draft and a sent message programmatically, check the isDraft property.

Por padrão, as mensagens de rascunho são salvas na pasta Drafts As mensagens enviadas são salvas na pasta Sent Items.By default, draft messages are saved in the Drafts folder, sent messages are saved in the Sent Items folder. Para sua conveniência, é possível identificar a pasta Rascunhos e a pasta Itens enviados por seus nomes de pasta correspondentes já bem conhecidos.For convenience, you can identify the Drafts folder and SentItems folder by their corresponding well-known folder names.

Definindo as propriedades from e senderSetting the from and sender properties

Quando uma mensagem está sendo redigida, na maioria dos casos, o Outlook configura as propriedades from e sender para o mesmo usuário conectado.When a message is being composed, in most cases, Outlook sets the from and sender properties to the same signed-in user. Você pode atualizar essas propriedades nas seguintes situações:You can update these properties in the following scenarios:

  • A propriedade from poderá ser alterada se o administrador do Exchange tiver atribuído direitos sendAs da caixa de correio a alguns outros usuários. O administrador pode fazer isso selecionando as 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 Add-ADPermission do Windows PowerShell. Em seguida, você pode definir programaticamente a propriedade from como um desses usuários com direitos sendAs para essa caixa de correio.The from property can be changed if the Exchange administrator has assigned sendAs rights of the mailbox to some other users. The administrator can do this by selecting Mailbox Permissions of the mailbox owner in the Azure portal, or by using the Exchange Admin Center or a Windows PowerShell Add-ADPermission cmdlet. Then, you can programmatically set the from property to one of these users who have sendAs rights for that mailbox.
  • 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.The sender property can be changed if the mailbox owner has delegated one or more users to be able to send messages from that mailbox. O proprietário da caixa de correio pode delegar no Outlook.The mailbox owner can delegate in 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.When a delegate sends a message on behalf of the mailbox owner, Outlook sets the sender property to the delegate’s account, and the from property remains as the mailbox owner. Você pode definir programaticamente a propriedade sender para um usuário com permissões de representante para essa caixa de correio.Programmatically, you can set the sender property to a user who has got delegate permissions for that mailbox.

Usar as Dicas de Email para verificar o status do destinatário e economizar tempo (prévia)Using MailTips to check recipient status and save time (preview)

Use as Dicas de Email para tomar decisões inteligentes antes de enviar um email.Use MailTips to make smart decisions before sending an 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.MailTips can tell you information such as the recipient's mailbox is restricted to specific senders, or approval is required for emailing the recipient.

Ler mensagens com controle sobre o formato de corpo retornadoReading messages with control over the body format returned

Você pode ler uma mensagem em uma caixa de correio fazendo referência a sua ID:You can read a message in a mailbox by referencing its 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:For example, to read messages in the signed-in user's Drafts folder:

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.The body of an Outlook message can be either HTML or text, with HTML as the default message body type returned in a GET response.

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:When getting a message, you can specify the following request header to return the body and uniqueBody properties in text format:

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:You can specify the following header, or, just skip the header, to get the message body in HTML format:

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

Quando você especifica um cabeçalho, uma resposta bem-sucedida inclui o cabeçalho Preference-Applied correspondente:When you specify either header, a successful response would include the corresponding Preference-Applied header:

  • Para solicitações de formato de texto: Preference-Applied: outlook.body-content-type="text"For text format requests: Preference-Applied: outlook.body-content-type="text"
  • Para solicitações de formato HTML: Preference-Applied: outlook.body-content-type="html"For HTML format requests: 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.If the body is HTML, by default, Outlook removes any potentially unsafe HTML (for example, JavaScript) embedded in the body property before returning the body content in a REST response.

Para obter o conteúdo HTML completo original, inclua o seguinte cabeçalho da solicitação HTTP:To get the entire, original HTML content, include the following HTTP request header:

Prefer: outlook.allow-unsafe-html

Integração com o gesto social "@" (prévia)</span><span class="sxs-lookup">Integrating with '@' social gesture (preview)

As menções com @ são notificações para alertar os usuários quando eles são mencionados nas mensagens.@-mentions are notifications to alert users if they are mentioned in messages. O recurso mention permite que os aplicativos configurem e acessem gestos sociais online comuns, como o prefixo "@", em emails.</span><span class="sxs-lookup">The mention resource enables apps to set and get the common online social gesture, the '@' prefix, in emails. Você pode:You can:

Outras funcionalidades compartilhadasOther shared capabilities

Aproveite as seguintes funcionalidades comuns que são compartilhadas entre entidades do Microsoft Graph:Take advantage of the following common capabilities that are shared among Microsoft Graph entities:

Próximas etapasNext steps

Saiba mais sobre:Find out more about: