Compartilhar via

Email de Grupos do Office 365

O conector do Office 365 Groups Mail permite que os usuários trabalhem com dados localizados em uma caixa de correio do Grupo do Office 365. A funcionalidade nesse conector funciona independentemente da caixa de correio pessoal de um único usuário e permite que os usuários trabalhem com qualquer Grupo que possam acessar dentro de sua organização. O conector funciona fora da API do Microsoft Graph e usa a terminologia especificada em uma documentação dos Grupos do Office 365 na API do Graph. Saiba mais na documentação do conector.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Standard Todas as regiões Power Automate
Aplicativos Lógicos Standard Todas as regiões de Aplicativos Lógicos
Power Apps Standard Todas as regiões Power Apps
Power Automate Standard Todas as regiões Power Automate
Contato
Nome Microsoft
URL Suporte do Microsoft LogicApps
Suporte do Microsoft Power Automate
Suporte do Microsoft Power Apps
Metadados do conector
Publicador Microsoft
Site https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Categorias Produtividade

Pré-requisitos

Para usar esse conector, você precisará de uma conta de usuário que tenha acesso aos Grupos do Office 365 em uma organização.

Também recomendamos que você examine a Documentação da API do Microsoft Graph para Grupos do Microsoft 365 para entender como os dados são estruturados dentro da API. Há uma terminologia chave que deve ser revisada antes de usar esse conector, como "conversa", "thread" e "post".

Problemas e limitações conhecidos

Para solucionar problemas do erro "O objeto especificado não foi encontrado no repositório", você pode fazer o seguinte:

  • Verifique as permissões para a conta.
  • Tente excluir a conexão atual do Office 365 Groups Mail e crie uma nova.

Acessando grupos "públicos" sem associação

Um usuário autenticado pode acessar dados de grupo de grupos dos quais ele é membro e qualquer grupo "público" dentro de sua organização. Na experiência do conector, ao selecionar um Grupo, o conector oferece uma lista suspensa dinâmica de Grupos para selecionar. Para uma experiência mais limpa, essa lista suspensa é preenchida automaticamente somente com os Grupos dos quais o usuário autenticado é membro.

Para acessar grupos "públicos" em sua organização que não são preenchidos na lista suspensa, você precisará fornecer a ID do Grupo na lista suspensa do conector rolando até a parte inferior e selecionando Inserir um valor personalizado.

Para localizar uma ID de Grupo em sua organização, siga estas etapas:

  1. Navegue até o Microsoft Graph Explorer e autentique-se com o usuário no canto superior esquerdo.

  2. Na seção Exemplo de consultas , selecione Grupos e , em seguida, OBTENHA todos os grupos em minha organização.

  3. Na visualização resposta, localize o Grupo em sua organização que você está procurando. Forneça o valor na id propriedade como o valor personalizado na experiência suspensa do conector.

  4. Verifique se a visibilidade do grupo está definida como Pública ou se o usuário não poderá acessar os dados dentro do Grupo.

  5. Se você não conseguir encontrar o Grupo, talvez seja necessário examinar a próxima página de resultados, que pode ser acessada copiando o link @odata.nextLink e executando-o como uma consulta na parte superior da página.

Gatilhos de email

Se houver muitos emails enviados ao mesmo tempo, alguns emails poderão ser perdidos pelo gatilho. Isso ocorre devido a limitações subjacentes do sistema com atrasos de processamento de email que fazem com que os emails fiquem "visíveis" com atraso (depois que o conector processa o lote que contém o email atrasado).

Informações de substituição

A operação "Encaminhar uma postagem" foi temporariamente preterida devido à falta de suporte de controle de exfiltração de email para esse conector. Estamos trabalhando no fornecimento de suporte e atualizaremos a operação quando for concluída.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos
Frequência das pesquisas de gatilho 1 60 segundos

Ações

Criar um thread de conversa

Crie um novo thread na conversa especificada.
Criar uma nova conversa em um grupo

Crie uma nova conversa neste grupo.
Encaminhar uma postagem (versão prévia)

Encaminhe uma postagem para um destinatário.
Encaminhar uma postagem [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Encaminhar uma postagem .

Encaminhe uma postagem para um destinatário.
Enviar uma solicitação HTTP

Construa uma solicitação de API REST do Microsoft Graph para invocar. Saiba mais: https://docs.microsoft.com/en-us/graph/use-the-api
Excluir um thread de conversa

Exclui o thread de conversa especificado.
Iniciar uma nova conversa em grupo criando um thread

Inicie uma nova conversa em grupo criando primeiro um thread.
Listar as conversas de um grupo

Obtenha todas as conversas neste grupo.
Listar as postagens de um thread de conversa

Obtenha todas as postagens do thread de conversa especificado.
Listar os anexos de uma postagem

Recupere uma lista de anexos que pertencem a uma postagem.
Listar os threads de conversa de uma conversa

Obtenha todos os threads em uma conversa em grupo.
Listar os threads de um grupo

Obtenha todos os threads de um grupo.
Obter um thread de conversa

Obtenha um thread específico que pertence a um grupo.
Obter uma conversa em grupo

Recupera as propriedades de uma conversa específica.
Obter uma postagem de thread

Recupera uma postagem em um thread especificado.
Responder a um thread de conversa

Responda a um thread em uma conversa em grupo e adicione uma nova postagem a ela.
Responder a uma postagem

Responda a uma postagem e adicione uma nova postagem ao thread especificado em uma conversa em grupo.

Criar um thread de conversa

ID da operação:
CreateConversationThread

Crie um novo thread na conversa especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
ID da conversa
 conversationId True string

Insira a ID da conversa.
Novo tópico
 topic True string

Tópico da nova conversa.
Content
 content True html

Conteúdo da nova conversa.
Categorias
 categories array of string

As categorias associadas à postagem.
Endereço
 Address email

Endereço de email.
Nome do anexo
 Name True string

Nome do anexo.
Conteúdo do anexo
 ContentBytes True byte

Conteúdo do anexo.

Retornos

Corpo
NewConversationThreadResponse

Criar uma nova conversa em um grupo

ID da operação:
CreateConversation

Crie uma nova conversa neste grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Novo tópico
 topic True string

Tópico da nova conversa.
Content
 content True html

Conteúdo da nova conversa.
Categorias
 categories array of string

As categorias associadas à postagem.
Endereço
 Address email

Endereço de email.
Nome do anexo
 Name True string

Nome do anexo.
Conteúdo do anexo
 ContentBytes True byte

Conteúdo do anexo.

Retornos

A resposta dos detalhes da conversa criada.

Objeto de conversa criado
CreateConversationResponse

Encaminhar uma postagem (versão prévia)

ID da operação:
ForwardPost_V2

Encaminhe uma postagem para um destinatário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Email de grupo
 groupMail True string

Escolha um grupo na lista suspensa ou insira o endereço de email do grupo.
ID da conversa
 conversationId True string

Insira a ID da conversa.
Thread ID
 threadId True string

Insira a ID do thread de conversa.
ID da postagem
 postId True string

Insira a ID da postagem.
Comment
 Comment html

Comente para encaminhar com a postagem.
Endereço
 Address email

Endereço de email.

Encaminhar uma postagem [PRETERIDO]

ID da operação:
ForwardPost

Esta ação foi preterida. Em vez disso, use Encaminhar uma postagem .

Encaminhe uma postagem para um destinatário.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.
ID da postagem
 postId True string

Insira a ID da postagem.
Comment
 comment string

Comente para encaminhar com a postagem.
Endereço
 Address email

Endereço de email.

Enviar uma solicitação HTTP

ID da operação:
HttpRequest

Construa uma solicitação de API REST do Microsoft Graph para invocar. Saiba mais: https://docs.microsoft.com/en-us/graph/use-the-api

Parâmetros

Nome Chave Obrigatório Tipo Description
URI
 Uri True string

O URI completo ou relativo. Exemplo: https://graph.microsoft.com/{version}/{resource}.
Método
 Method True string

O método HTTP (o padrão é GET).
Corpo
 Body binary

O conteúdo do corpo da solicitação.
Tipo de conteúdo
 ContentType string

O cabeçalho de tipo de conteúdo para o corpo (o padrão é application/json).
CustomHeader1
 CustomHeader1 string

Cabeçalho personalizado 1. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader2
 CustomHeader2 string

Cabeçalho personalizado 2. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader3
 CustomHeader3 string

Cabeçalho personalizado 3. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader4
 CustomHeader4 string

Cabeçalho personalizado 4. Especificar no formato: cabeçalho-nome: cabeçalho-valor
CustomHeader5
 CustomHeader5 string

Cabeçalho personalizado 5. Especificar no formato: cabeçalho-nome: cabeçalho-valor

Retornos

response
ObjectWithoutType

Excluir um thread de conversa

ID da operação:
DeleteConversationThread

Exclui o thread de conversa especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.

Iniciar uma nova conversa em grupo criando um thread

ID da operação:
CreateGroupThread

Inicie uma nova conversa em grupo criando primeiro um thread.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Novo tópico
 topic True string

Tópico da nova conversa.
Content
 content True html

Conteúdo da nova conversa.
Categorias
 categories array of string

As categorias associadas à postagem.
Endereço
 Address email

Endereço de email.
Nome do anexo
 Name True string

Nome do anexo.
Conteúdo do anexo
 ContentBytes True byte

Conteúdo do anexo.

Retornos

Corpo
NewConversationThreadResponse

Listar as conversas de um grupo

ID da operação:
ListConversations

Obtenha todas as conversas neste grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.

Retornos

Nome Caminho Tipo Description
value
 value array of Conversation

Listar as postagens de um thread de conversa

ID da operação:
ListThreadPosts

Obtenha todas as postagens do thread de conversa especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.

Retornos

Nome Caminho Tipo Description
value
 value array of Post

Matriz que contém as postagens no thread especificado.

Listar os anexos de uma postagem

ID da operação:
GetAttachments

Recupere uma lista de anexos que pertencem a uma postagem.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.
ID da postagem
 postId True string

Insira a ID da postagem.

Retornos

Nome Caminho Tipo Description
value
 value array of Attachment

Matriz que contém os anexos da postagem.

Listar os threads de conversa de uma conversa

ID da operação:
ListConversationThreads

Obtenha todos os threads em uma conversa em grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
ID da conversa
 conversationId True string

Insira a ID da conversa.

Retornos

Nome Caminho Tipo Description
value
 value array of ConversationThread

Listar os threads de um grupo

ID da operação:
ListGroupThreads

Obtenha todos os threads de um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.

Retornos

Nome Caminho Tipo Description
value
 value array of ConversationThread

Obter um thread de conversa

ID da operação:
GetConversationThread

Obtenha um thread específico que pertence a um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.

Retornos

Objeto thread de conversa.

Corpo
ConversationThread

Obter uma conversa em grupo

ID da operação:
GetGroupConversation

Recupera as propriedades de uma conversa específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
ID da conversa
 conversationId True string

Insira a ID da conversa.

Retornos

Objeto conversation.

Corpo
Conversation

Obter uma postagem de thread

ID da operação:
GetThreadPost

Recupera uma postagem em um thread especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.
ID da postagem
 postId True string

Insira a ID da postagem.

Retornos

Representa um item post individual em uma entidade conversationThread.

Corpo
Post

Responder a um thread de conversa

ID da operação:
ReplyToAThread

Responda a um thread em uma conversa em grupo e adicione uma nova postagem a ela.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.
Content
 content True html

Conteúdo da nova conversa.
Categorias
 categories array of string

As categorias associadas à postagem.
Endereço
 Address email

Endereço de email.
Nome do anexo
 Name True string

Nome do anexo.
Conteúdo do anexo
 ContentBytes True byte

Conteúdo do anexo.

Responder a uma postagem

ID da operação:
ReplyPost

Responda a uma postagem e adicione uma nova postagem ao thread especificado em uma conversa em grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.
Thread ID
 threadId True string

Insira a ID do thread de conversa.
ID da postagem
 postId True string

Insira a ID da postagem.
Content
 content True html

Conteúdo da nova conversa.
Categorias
 categories array of string

As categorias associadas à postagem.
Endereço
 Address email

Endereço de email.
Nome do anexo
 Name True string

Nome do anexo.
Conteúdo do anexo
 ContentBytes True byte

Conteúdo do anexo.

Gatilhos

Quando um novo email chega a um grupo

Quando um novo email chega a um grupo.

Quando um novo email chega a um grupo

ID da operação:
OnNewEmailInGroup

Quando um novo email chega a um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 groupId True string

Escolha um grupo na lista suspensa ou insira a ID do grupo.

Retornos

Nome Caminho Tipo Description
value
 value array of ConversationTriggerResponse

Resposta do gatilho.

Definições

Conversa

Objeto conversation.

Nome Caminho Tipo Description
ID da conversa
 id string

O identificador exclusivo das conversas.
Tópico da conversa
 topic string

O tópico da conversa.
Tem anexos?
 hasAttachments boolean

Indica se alguma das postagens nessa Conversa tem pelo menos um anexo.
Carimbo de data/hora entregue pela última vez
 lastDeliveredDateTime date-time

O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.
Matriz de remetentes exclusivos
 uniqueSenders array of string

Todos os usuários que enviaram uma mensagem para esta Conversa.
Preview
 preview string

Um breve resumo do corpo da postagem mais recente nesta Conversa.

ConversationThread

Objeto thread de conversa.

Nome Caminho Tipo Description
ID do thread de conversa
 id string

O identificador exclusivo do thread de conversa.
Tópico da conversa
 topic string

O tópico da conversa.
Tem anexos?
 hasAttachments boolean

Indica se alguma das postagens nessa Conversa tem pelo menos um anexo.
Carimbo de data/hora entregue pela última vez
 lastDeliveredDateTime date-time

O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.
Matriz de remetentes exclusivos
 uniqueSenders array of string

Todos os usuários que enviaram uma mensagem para esta Conversa.
Preview
 preview string

Um breve resumo do corpo da postagem mais recente nesta Conversa.
Está bloqueado?
 isLocked boolean

Indica se o thread está bloqueado.
toRecipients
 toRecipients array of EmailAddress

Os destinatários de Para: para o thread.
ccRecipients
 ccRecipients array of EmailAddress

Os destinatários cc: para o thread.

Postar

Representa um item post individual em uma entidade conversationThread.

Nome Caminho Tipo Description
ID da postagem
 id string

O identificador exclusivo da postagem.
Carimbo de data/hora criado da postagem
 createdDateTime date-time
Carimbo de data/hora da última modificação da postagem
 lastModifiedDateTime date-time
Alterar Chave
 changeKey string

Identifica a versão da postagem.
ID da conversa
 conversationId string

ID exclusiva da conversa à qual a postagem pertence.
ID do thread de conversa
 conversationThreadId string

ID exclusiva do thread de conversa ao qual a postagem pertence.
Categorias
 categories array of string

As categorias associadas à postagem.
Carimbo de data/hora recebido
 receivedDateTime date-time

Carimbo de data/hora pós-recebido.
Tem anexos?
 hasAttachments boolean

Indica se a postagem tem pelo menos um anexo.
Novos participantes
 newParticipants array of EmailAddress

Participantes da conversa que foram adicionados ao thread como parte desta postagem.
body
 body ItemBody

Representa as propriedades do corpo de um item, como uma mensagem, um evento ou uma postagem de grupo.
from
 from EmailAddress
remetente
 sender EmailAddress
attachments
 attachments array of Attachment

Anexo

Nome Caminho Tipo Description
ID do anexo
 id string

ID do anexo.
Nome do anexo
 name string

Nome do anexo.
Tipo de conteúdo de anexo
 contentType string

Tipo de conteúdo de anexo.
Tamanho do anexo
 size integer

Tamanho do anexo.
Bytes de conteúdo de anexo
 contentBytes byte

Conteúdo do anexo.

Endereço de Email

Nome Caminho Tipo Description
Nome do utilizador
 emailAddress.name string
Endereço de email do usuário
 emailAddress.address email

ItemBody

Representa as propriedades do corpo de um item, como uma mensagem, um evento ou uma postagem de grupo.

Nome Caminho Tipo Description
Tipo de conteúdo do corpo
 contentType string

Tipo de conteúdo do corpo.
Conteúdo do corpo
 content string

Conteúdo do corpo.

CreateConversationResponse

A resposta dos detalhes da conversa criada.

Nome Caminho Tipo Description
ID da conversa
 id string

Nova ID da Conversa.
Threads de conversa
 threads array of object

Thread de conversa criado.
Thread ID
 threads.id string

A nova ID do thread.

NewConversationThreadResponse

Nome Caminho Tipo Description
ID do thread de conversa
 id string

Nova ID do thread de conversa.

ConversationTriggerResponse

Quando um novo email chega, a resposta do gatilho é recebida.

Nome Caminho Tipo Description
ID da conversa
 id string

O identificador exclusivo da conversa.
Carimbo de data/hora entregue pela última vez
 lastDeliveredDateTime date-time

O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.
threads
 threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Objeto thread de conversa.

Nome Caminho Tipo Description
ID do thread de conversa
 id string

O identificador exclusivo do thread de conversa.
postagens
 posts array of PostTriggerResponse

PostTriggerResponse

Representa um item post individual em uma entidade conversationThread.

Nome Caminho Tipo Description
ID da postagem
 id string

O identificador exclusivo da postagem.
Carimbo de data/hora da última modificação da postagem
 lastModifiedDateTime date-time
Alterar Chave
 changeKey string

Identifica a versão da postagem.

ObjectWithoutType