Compartir a través de


Correo electrónico de grupos de Office 365

El conector de correo de grupos de Office 365 permite a los usuarios trabajar con datos ubicados en un buzón de grupo de Office 365. La funcionalidad de este conector funciona independientemente del buzón personal de un solo usuario y permite a los usuarios trabajar con cualquier grupo al que puedan acceder dentro de su organización. El conector funciona con La API de Microsoft Graph y usa la terminología especificada en una documentación de grupos de Office 365 en Graph API. Obtenga más información en la documentación del conector.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones Power Automate
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps
Power Apps Estándar Todas las regiones de Power Apps
Power Automate Estándar Todas las regiones Power Automate
Contacto
Nombre Microsoft
URL Compatibilidad con Microsoft LogicApps
Soporte técnico de Microsoft Power Automate
Soporte técnico de Microsoft Power Apps
Metadatos del conector
Publicador Microsoft
Website https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Categorías Productividad

Prerrequisitos

Para usar este conector, necesitará una cuenta de usuario que tenga acceso a grupos de Office 365 dentro de una organización.

También se recomienda revisar la documentación de Microsoft Graph API para grupos de Microsoft 365 para comprender cómo se estructuran los datos dentro de la API. Hay terminología clave que se debe revisar antes de usar este conector, como "conversación", "subproceso" y "publicación".

Problemas conocidos y limitaciones

Para solucionar el error "No se encontró el objeto especificado en el almacén", puede hacer lo siguiente:

  • Compruebe los permisos de la cuenta.
  • Intente eliminar la conexión actual de Correo de grupos de Office 365 y cree una nueva.

Acceso a grupos "públicos" sin pertenencia

Un usuario autenticado puede acceder a los datos de grupo de los grupos de los que son miembros y cualquier grupo "público" dentro de su organización. En la experiencia del conector, al seleccionar un grupo, el conector ofrece una lista desplegable dinámica de Grupos entre las que seleccionar. Para obtener una experiencia más limpia, esta lista desplegable se rellena automáticamente solo con los grupos de los que es miembro el usuario autenticado.

Para acceder a grupos "públicos" dentro de la organización que no se rellenan en la lista desplegable, deberá proporcionar el identificador de grupo en la lista desplegable del conector desplazando hasta la parte inferior y seleccionando Especificar un valor personalizado.

Para buscar un identificador de grupo dentro de la organización, siga estos pasos:

  1. Vaya al Explorador de Microsoft Graph y autentíquese con el usuario en la parte superior izquierda.

  2. En la sección Consultas de ejemplo , seleccione Grupos y, a continuación, GET todos los grupos de mi organización.

  3. En la versión preliminar de respuesta, busque el grupo dentro de la organización que está buscando. Proporcione el valor de la id propiedad como valor personalizado en la experiencia desplegable del conector.

  4. Asegúrese de que la visibilidad del grupo esté establecida en Pública o, de lo contrario, el usuario no podrá acceder a los datos dentro del grupo.

  5. Si no encuentra el grupo, es posible que tenga que buscar en la siguiente página de resultados, a la que se puede acceder copiando el vínculo y @odata.nextLink ejecutándolo como una consulta en la parte superior de la página.

Desencadenadores de correo

Si hay un montón de correos electrónicos enviados al mismo tiempo, el desencadenador podría perder algunos correos electrónicos. Esto se debe a limitaciones subyacentes del sistema con retrasos en el procesamiento de correo electrónico que hacen que los correos electrónicos se vuelvan "visibles" tarde (después de que el conector haya procesado el lote que contiene el correo electrónico en tiempo de ejecución).

Información de desuso

La operación "Reenviar una publicación" ha quedado temporalmente en desuso debido a la falta de compatibilidad con el control de filtración de correo electrónico para este conector. Estamos trabajando para proporcionar soporte técnico y actualizaremos la operación cuando se complete.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos
Frecuencia de sondeos de desencadenador 1 60 segundos

Acciones

Creación de un subproceso de conversación

Cree un nuevo subproceso en la conversación especificada.

Crear una nueva conversación en un grupo

Cree una nueva conversación en este grupo.

Eliminar un subproceso de conversación

Elimina el subproceso de conversación especificado.

Enumerar las conversaciones de un grupo

Obtenga todas las conversaciones de este grupo.

Enumerar las publicaciones de un subproceso de conversación

Obtenga todas las publicaciones del subproceso de conversación especificado.

Enumerar los datos adjuntos de una publicación

Recupere una lista de datos adjuntos que pertenecen a una publicación.

Enumerar los subprocesos de conversación de una conversación

Obtenga todos los subprocesos de una conversación de grupo.

Enumerar los subprocesos de un grupo

Obtiene todos los subprocesos de un grupo.

Enviar una solicitud HTTP

Construya una solicitud de API rest de Microsoft Graph para invocar. Aprende más: https://docs.microsoft.com/en-us/graph/use-the-api

Iniciar una nueva conversación de grupo mediante la creación de un subproceso

Inicie una nueva conversación de grupo creando primero un subproceso.

Obtener un subproceso de conversación

Obtiene un subproceso específico que pertenece a un grupo.

Obtener una conversación de grupo

Recupera las propiedades de una conversación determinada.

Obtener una publicación de subproceso

Recupera una publicación en un subproceso especificado.

Reenviar una publicación [EN DESUSO]

Esta acción ha quedado en desuso. Use Forward a post en su lugar.

Reenvíe una publicación a un destinatario.

Reenvío de una publicación (versión preliminar)

Reenvíe una publicación a un destinatario.

Responder a un subproceso de conversación

Responder a un subproceso en una conversación de grupo y agregarle una nueva publicación.

Responder a una publicación

Responda a una publicación y agregue una nueva entrada al subproceso especificado en una conversación de grupo.

Creación de un subproceso de conversación

Cree un nuevo subproceso en la conversación especificada.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Id. de la conversación
conversationId True string

Escriba el identificador de conversación.

Nuevo tema
topic True string

Tema de la nueva conversación.

Content
content True html

Contenido de la nueva conversación.

Categorías
categories array of string

Las categorías asociadas a la publicación.

Dirección
Address email

Dirección de correo electrónico.

Nombre de datos adjuntos
Name True string

Nombre de los datos adjuntos.

Contenido adjunto
ContentBytes True byte

Contenido de los datos adjuntos.

Devoluciones

Crear una nueva conversación en un grupo

Cree una nueva conversación en este grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Nuevo tema
topic True string

Tema de la nueva conversación.

Content
content True html

Contenido de la nueva conversación.

Categorías
categories array of string

Las categorías asociadas a la publicación.

Dirección
Address email

Dirección de correo electrónico.

Nombre de datos adjuntos
Name True string

Nombre de los datos adjuntos.

Contenido adjunto
ContentBytes True byte

Contenido de los datos adjuntos.

Devoluciones

Respuesta de con los detalles de la conversación creada.

Objeto de conversación creado
CreateConversationResponse

Eliminar un subproceso de conversación

Elimina el subproceso de conversación especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Enumerar las conversaciones de un grupo

Obtenga todas las conversaciones de este grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of Conversation

Enumerar las publicaciones de un subproceso de conversación

Obtenga todas las publicaciones del subproceso de conversación especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of Post

Matriz que contiene las entradas en el subproceso especificado.

Enumerar los datos adjuntos de una publicación

Recupere una lista de datos adjuntos que pertenecen a una publicación.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Id. de publicación
postId True string

Escriba el identificador de publicación.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of Attachment

Matriz que contiene los datos adjuntos de la publicación.

Enumerar los subprocesos de conversación de una conversación

Obtenga todos los subprocesos de una conversación de grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Id. de la conversación
conversationId True string

Escriba el identificador de conversación.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ConversationThread

Enumerar los subprocesos de un grupo

Obtiene todos los subprocesos de un grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ConversationThread

Enviar una solicitud HTTP

Construya una solicitud de API rest de Microsoft Graph para invocar. Aprende más: https://docs.microsoft.com/en-us/graph/use-the-api

Parámetros

Nombre Clave Requerido Tipo Description
URI
Uri True string

URI completo o relativo. Ejemplo: https://graph.microsoft.com/{version}/{resource}.

Método
Method True string

El método HTTP (el valor predeterminado es GET).

Body
Body binary

Contenido del cuerpo de la solicitud.

Tipo de contenido
ContentType string

Encabezado de tipo de contenido para el cuerpo (el valor predeterminado es application/json).

CustomHeader1
CustomHeader1 string

Encabezado personalizado 1. Especifique en formato: header-name: header-value

CustomHeader2
CustomHeader2 string

Encabezado personalizado 2. Especifique en formato: header-name: header-value

CustomHeader3
CustomHeader3 string

Encabezado personalizado 3. Especifique en formato: header-name: header-value

CustomHeader4
CustomHeader4 string

Encabezado personalizado 4. Especifique en formato: header-name: header-value

CustomHeader5
CustomHeader5 string

Encabezado personalizado 5. Especifique en formato: header-name: header-value

Devoluciones

Iniciar una nueva conversación de grupo mediante la creación de un subproceso

Inicie una nueva conversación de grupo creando primero un subproceso.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Nuevo tema
topic True string

Tema de la nueva conversación.

Content
content True html

Contenido de la nueva conversación.

Categorías
categories array of string

Las categorías asociadas a la publicación.

Dirección
Address email

Dirección de correo electrónico.

Nombre de datos adjuntos
Name True string

Nombre de los datos adjuntos.

Contenido adjunto
ContentBytes True byte

Contenido de los datos adjuntos.

Devoluciones

Obtener un subproceso de conversación

Obtiene un subproceso específico que pertenece a un grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Devoluciones

Objeto de subproceso de conversación.

Obtener una conversación de grupo

Recupera las propiedades de una conversación determinada.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Id. de la conversación
conversationId True string

Escriba el identificador de conversación.

Devoluciones

Objeto Conversation.

Obtener una publicación de subproceso

Recupera una publicación en un subproceso especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Id. de publicación
postId True string

Escriba el identificador de publicación.

Devoluciones

Representa un elemento Post individual dentro de una entidad conversationThread.

Body
Post

Reenviar una publicación [EN DESUSO]

Esta acción ha quedado en desuso. Use Forward a post en su lugar.

Reenvíe una publicación a un destinatario.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Id. de publicación
postId True string

Escriba el identificador de publicación.

Comentario
comment string

Comentario para reenviar con la publicación.

Dirección
Address email

Dirección de correo electrónico.

Reenvío de una publicación (versión preliminar)

Reenvíe una publicación a un destinatario.

Parámetros

Nombre Clave Requerido Tipo Description
Correo de grupo
groupMail True string

Elija un grupo en la lista desplegable o escriba la dirección de correo del grupo.

Id. de la conversación
conversationId True string

Escriba el identificador de conversación.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Id. de publicación
postId True string

Escriba el identificador de publicación.

Comentario
Comment html

Comentario para reenviar con la publicación.

Dirección
Address email

Dirección de correo electrónico.

Responder a un subproceso de conversación

Responder a un subproceso en una conversación de grupo y agregarle una nueva publicación.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Content
content True html

Contenido de la nueva conversación.

Categorías
categories array of string

Las categorías asociadas a la publicación.

Dirección
Address email

Dirección de correo electrónico.

Nombre de datos adjuntos
Name True string

Nombre de los datos adjuntos.

Contenido adjunto
ContentBytes True byte

Contenido de los datos adjuntos.

Responder a una publicación

Responda a una publicación y agregue una nueva entrada al subproceso especificado en una conversación de grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Identificador de subproceso
threadId True string

Escriba el identificador del subproceso de conversación.

Id. de publicación
postId True string

Escriba el identificador de publicación.

Content
content True html

Contenido de la nueva conversación.

Categorías
categories array of string

Las categorías asociadas a la publicación.

Dirección
Address email

Dirección de correo electrónico.

Nombre de datos adjuntos
Name True string

Nombre de los datos adjuntos.

Contenido adjunto
ContentBytes True byte

Contenido de los datos adjuntos.

Desencadenadores

Cuando llega un nuevo correo electrónico a un grupo

Cuando llega un nuevo correo electrónico a un grupo.

Cuando llega un nuevo correo electrónico a un grupo

Cuando llega un nuevo correo electrónico a un grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de grupo
groupId True string

Elija un grupo en la lista desplegable o escriba el identificador de grupo.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
value array of ConversationTriggerResponse

Respuesta del desencadenador.

Definiciones

Conversación

Objeto Conversation.

Nombre Ruta de acceso Tipo Description
Id. de la conversación
id string

Identificador único de las conversaciones.

Tema de conversación
topic string

Tema de la conversación.

¿Tiene datos adjuntos?
hasAttachments boolean

Indica si alguna de las publicaciones de esta conversación tiene al menos un dato adjunto.

Última marca de tiempo entregada
lastDeliveredDateTime date-time

El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC.

Matriz de remitentes únicos
uniqueSenders array of string

Todos los usuarios que enviaron un mensaje a esta conversación.

Preview
preview string

Un breve resumen del cuerpo de la última publicación de esta conversación.

ConversationThread

Objeto de subproceso de conversación.

Nombre Ruta de acceso Tipo Description
Identificador de subproceso de conversación
id string

Identificador único del subproceso de conversación.

Tema de conversación
topic string

Tema de la conversación.

¿Tiene datos adjuntos?
hasAttachments boolean

Indica si alguna de las publicaciones de esta conversación tiene al menos un dato adjunto.

Última marca de tiempo entregada
lastDeliveredDateTime date-time

El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC.

Matriz de remitentes únicos
uniqueSenders array of string

Todos los usuarios que enviaron un mensaje a esta conversación.

Preview
preview string

Un breve resumen del cuerpo de la última publicación de esta conversación.

¿Está bloqueado?
isLocked boolean

Indica si el subproceso está bloqueado.

toRecipients
toRecipients array of EmailAddress

Para: destinatarios del subproceso.

ccRecipients
ccRecipients array of EmailAddress

Destinatarios cc: para el subproceso.

Publicar

Representa un elemento Post individual dentro de una entidad conversationThread.

Nombre Ruta de acceso Tipo Description
Id. de publicación
id string

Identificador único de la publicación.

Marca de tiempo creada de la publicación
createdDateTime date-time
Marca de tiempo de última modificación de la publicación
lastModifiedDateTime date-time
Cambiar clave
changeKey string

Identifica la versión de la publicación.

Id. de la conversación
conversationId string

Identificador único de la conversación a la que pertenece la publicación.

Identificador de subproceso de conversación
conversationThreadId string

Identificador único del subproceso de conversación al que pertenece la publicación.

Categorías
categories array of string

Las categorías asociadas a la publicación.

Marca de tiempo recibida
receivedDateTime date-time

Marca de tiempo recibida después.

¿Tiene datos adjuntos?
hasAttachments boolean

Indica si la publicación tiene al menos un dato adjunto.

Nuevos participantes
newParticipants array of EmailAddress

Participantes de conversación que se agregaron al subproceso como parte de esta publicación.

body
body ItemBody

Representa las propiedades del cuerpo de un elemento, como un mensaje, un evento o una publicación de grupo.

desde
from EmailAddress
sender
sender EmailAddress
attachments
attachments array of Attachment

Datos adjuntos

Nombre Ruta de acceso Tipo Description
Id. de datos adjuntos
id string

Identificador de los datos adjuntos.

Nombre de datos adjuntos
name string

Nombre del archivo adjunto.

Tipo de contenido adjunto
contentType string

Tipo de contenido de datos adjuntos.

Tamaño de datos adjuntos
size integer

Tamaño de los datos adjuntos.

Bytes de contenido de datos adjuntos
contentBytes byte

Contenido de los datos adjuntos.

Dirección de correo electrónico

Nombre Ruta de acceso Tipo Description
Nombre del usuario
emailAddress.name string
Dirección de correo electrónico del usuario
emailAddress.address email

ItemBody

Representa las propiedades del cuerpo de un elemento, como un mensaje, un evento o una publicación de grupo.

Nombre Ruta de acceso Tipo Description
Tipo de contenido del cuerpo
contentType string

Tipo de contenido del cuerpo.

Contenido del cuerpo
content string

Contenido del cuerpo.

CreateConversationResponse

Respuesta de con los detalles de la conversación creada.

Nombre Ruta de acceso Tipo Description
Id. de la conversación
id string

Nuevo identificador de conversación.

Subprocesos de conversación
threads array of object

Se ha creado el subproceso de conversación.

Identificador de subproceso
threads.id string

Nuevo identificador de subproceso.

NewConversationThreadResponse

Nombre Ruta de acceso Tipo Description
Identificador de subproceso de conversación
id string

Nuevo identificador de subproceso de conversación.

ConversationTriggerResponse

Cuando llega un nuevo correo electrónico, se desencadena la respuesta del desencadenador.

Nombre Ruta de acceso Tipo Description
Id. de la conversación
id string

Identificador único de conversación.

Última marca de tiempo entregada
lastDeliveredDateTime date-time

El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC.

threads
threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Objeto de subproceso de conversación.

Nombre Ruta de acceso Tipo Description
Identificador de subproceso de conversación
id string

Identificador único del subproceso de conversación.

entradas
posts array of PostTriggerResponse

PostTriggerResponse

Representa un elemento Post individual dentro de una entidad conversationThread.

Nombre Ruta de acceso Tipo Description
Id. de publicación
id string

Identificador único de la publicación.

Marca de tiempo de última modificación de la publicación
lastModifiedDateTime date-time
Cambiar clave
changeKey string

Identifica la versión de la publicación.

ObjectWithoutType