Información general sobre la API de contactos personales de Outlook

  • Artículo

Los contactos de Outlook le permiten almacenar los datos de sus contactos personales y forma parte del centro de mensajes de Outlook en Microsoft 365. En Outlook, puede administrar correos electrónicos, programar reuniones, buscar información sobre los usuarios de una organización, iniciar conversaciones en línea, compartir archivos y colaborar en grupos.

¿Por qué integrar con contactos personales de Outlook?

Complementar los escenarios de mensajes y calendarios para cientos de millones de clientes

Cientos de millones de consumidores y decenas de millones de clientes de organizaciones eligen Outlook como su cliente de correo electrónico. Los contactos ofrecen una función complementaria para mensajes y calendarios, ya que permiten a los clientes mantener un almacén integrado y fácil de usar de datos de contactos dentro de Outlook. Para los desarrolladores, usar las funciones enriquecidas de correo o calendario equivale a facilitar escenarios avanzados con los datos de contactos de los usuarios.

Automatizar la organización de contactos

La API de contactos le permite mantener organizados sus clientes, de forma muy similar a cómo lo hacen los usuarios de Outlook:

  • De forma similar a la experiencia del usuario, puede crear instancias de contactos y asignarlas a objetos de contactFolder.
  • La API de contactos le permite asignar categorías, contactos, eventos, mensajes, tareas y publicaciones de grupo de forma coherente para mejorar la organización y la detección. Además, puede definir una lista general de categorías de un usuario, lo que facilita otros escenarios creativos.
  • Puede establecer una marca en un contacto para su seguimiento. (La función de marcar está actualmente en versión preliminar en Microsoft Graph).

Compartir información de contacto

La API de contactos le permite obtener elementos de contactos del usuario que inició la sesión, o bien de los usuarios que compartieron sus contactos con el usuario que inició la sesión o los delegaron a este. Por ejemplo, si Sergio compartió una carpeta de contactos con Íker (o si Sergio delegó el acceso a Íker), los permisos delegados de Íker también le proporcionarían acceso de lectura en los contenidos y el calendario compartido de Sergio.

Usar la API de contactos en Microsoft Graph para mejorar el uso de los datos de todos los contactos

Puede usar operaciones CRUD típicas en un contacto de Outlook para crear y administrar contactos. Como parte de Microsoft Graph, también puede usar la API de contactos para examinar los contactos de Outlook de un usuario, así como las redes sociales, el directorio de la organización y los contactos de comunicaciones recientes, y devolver información sobre contactos de todos estos orígenes que sea más relevante para el usuario. Aproveche esta inteligencia adicional en escenarios del Selector de personas.

Aprovechar otras funciones y características compartidas en Microsoft Graph

  • La entidad de contacto admite una foto de contacto que se implementa como la misma entidad profilePhoto que una foto de usuario almacenada en Exchange Online o Microsoft Entra ID. Esto elimina la sobrecarga de convertir entre fotos de perfil de usuario y de contacto.
  • Para mantener sincronizado el almacén local de la aplicación, suscríbase a notificaciones de cambios y al seguimiento de cambios en contactos y carpetas de contactos.
  • Puede ampliar el almacenamiento de la aplicación en una instancia de contacto como una extensión abierta, o bien puede agregar datos personalizados fuertemente tipados al esquema de contactos como una extensión de esquema.

¿Dónde están los datos?

La API de Microsoft Graph es compatible con el acceso a los datos del buzón principal y los buzones compartidos de los usuarios. Los datos pueden ser contactos de calendario, correo o personales almacenados en un buzón en la nube en Exchange Online como parte de Microsoft 365.

La API no permite el acceso a buzones de archivo locales, ni en Exchange Online ni en Exchange Server.

Referencia de la API

¿Busca la referencia de la API para este servicio?

Pasos siguientes