Visão geral da API de contatos pessoais do Outlook

  • Artigo

Os contatos do Outlook permitem que você armazene dados de contatos pessoais e fazem parte de um hub de mensagens do Outlook no Microsoft 365. Pelo Outlook, você pode gerenciar emails, agendar reuniões, saber mais sobre os usuários de uma organização, iniciar conversas online, compartilhar arquivos e colaborar em grupos.

Por que se integrar aos contatos pessoais do Outlook?

Complemente os cenários de envio de mensagens e criação de calendário para centenas de milhões de clientes

Centenas de milhões de clientes e dezenas de milhões de clientes organizacionais escolhem o Outlook como serviço de email. Os contatos oferecem uma função complementar para mensagens e calendários ao permitirem que os clientes mantenham um armazenamento conveniente e integrado dos dados dos contatos no Outlook. Para os desenvolvedores, poder aproveitar a funcionalidade avançada de email ou de calendário significa ter acesso a cenários mais amplos com os dados dos contatos do usuário.

Automatizar a organização dos contatos

A API de contatos permite manter os seus clientes organizados, muito parecido com o que os clientes fazem por conta própria no Outlook:

  • De forma parecida com a experiência do cliente, você pode criar instâncias de contact e atribuí-las aos objetos de contactFolder.
  • A API de contatos permite atribuir contatos de categorias, bem como eventos, mensagens, tarefas e postagens de grupo de maneira consistente para aprimorar a organização e a descoberta. Além disso, você pode definir a lista mestra de categorias de um usuário, que possibilita outros cenários de criação.
  • Você pode definir um sinalizador em um contact para fins de acompanhamento. (No momento, a sinalização está no modo de visualização no Microsoft Graph).

Compartilhar informações de contato

A API de contatos permite que você obtenha os itens de contato do usuário conectado ou dos usuários que compartilharam ou delegaram seus contatos ao usuário conectado. Por exemplo, se Henrique tiver compartilhado uma pasta de contato com Paulo ou tiver delegado acesso a Paulo, as permissões delegadas de Paulo também concederão acesso de leitura ao calendário e ao conteúdo que Henrique compartilhou.

Utilize a API de pessoas no Microsoft Graph para fazer melhor uso de todos os dados de pessoas

Você pode usar as operações CRUD típicas de um contact do Outlook para criar e gerenciar contatos. Como parte do Microsoft Graph, você também pode usar a API de pessoas, que analisa os contatos do Outlook e as redes sociais de um usuário, o diretório da organização e as pessoas envolvidas em comunicações recentes e retornar informações sobre pessoas de todas essas fontes que são mais relevantes para o usuário. Utilize essa inteligência adicional em cenários do seletor de pessoas.

Utilizar outros recursos compartilhados e conveniências no Microsoft Graph

  • A entidade de contato dá suporte a uma foto de contato que é implementada como a mesma entidade profilePhoto que uma foto de usuário armazenada em Exchange Online ou Microsoft Entra ID. Isso elimina a sobrecarga na conversão entre as fotos de perfil de usuário e de contato.
  • Mantenha a loja de aplicativos local sincronizada inscrevendo-se em alterar notificações e controlar as alterações nos contatos e pastas de contato.
  • Você pode ampliar o armazenamento de aplicativos em uma instância de contato como uma extensão aberta ou adicionar dados personalizados fortemente tipados ao esquema de contatos como uma extensão de esquema.

Onde estão os dados?

A API do Microsoft Graph é compatível com o acesso aos dados nas caixas de correio principais e em caixas de correio compartilhadas do usuário. Os dados podem ser contatos de calendário, email ou pessoais armazenados em uma caixa de correio na nuvem em Exchange Online como parte do Microsoft 365.

A API não é compatível com o acesso às caixas de correio de arquivo morto no local, não no Exchange Online, nem no Exchange Server.

Referência da API

Está procurando a referência de API para esse serviço?

Próximas etapas