Correio de Grupos do Office 365
O conector de Email de Grupos do Office 365 permite que os usuários trabalhem com dados localizados em uma caixa de correio do Grupo do Office 365. A funcionalidade neste 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 de Grupos do Office 365 dentro da API do Graph. Saiba mais na documentação do conector.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automate |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps |
| Aplicações Power | Standard | Todas as regiões do Power Apps |
| Automatize o poder | Standard | Todas as regiões do Power Automate |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | 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 dentro de uma organização.
Também recomendamos que você revise a documentação da API do Microsoft Graph para grupos do Microsoft 365 para entender como os dados são estruturados na API. Há uma terminologia chave que deve ser revisada antes de usar esse conector, como "conversa", "thread" e "post".
Problemas conhecidos e limitações
Para solucionar o erro "O objeto especificado não foi encontrado no armazenamento", você pode fazer o seguinte:
- Verifique as permissões para a conta.
- Tente excluir a conexão atual do Email dos Grupos do Office 365 e crie uma nova.
Acesso a Grupos "Públicos" sem associação
Um usuário autenticado pode acessar os dados do Grupo dos Grupos dos quais é membro e de 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 apenas com os Grupos dos quais o usuário autenticado é membro.
Para acessar os Grupos "Públicos" em sua organização que não estã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 um ID de grupo na sua organização, siga estes passos:
Navegue até Microsoft Graph Explorer e autentique-se com seu usuário no canto superior esquerdo.
Na seção Consultas de exemplo , selecione Grupos e, em seguida, OBTER todos os grupos na minha organização.
Na Pré-visualização de Resposta, localize o Grupo na sua organização que está a procurar. Forneça o valor na
idpropriedade como o valor personalizado na experiência suspensa do conector.Certifique-se de que a visibilidade do Grupo está definida como Público, caso contrário o utilizador não poderá aceder aos dados dentro do Grupo.
Se não conseguir encontrar o Grupo, talvez seja necessário procurar na próxima página de resultados, que pode ser acessada copiando o link e
@odata.nextLinkexecutando-o como uma consulta na parte superior da página.
Gatilhos de email
Se houver muitos e-mails enviados ao mesmo tempo, alguns e-mails podem ser perdidos pelo gatilho. Isso ocorre devido a limitações subjacentes do sistema com atrasos no processamento de e-mails que fazem com que os e-mails se tornem "visíveis" tarde (depois que o conector processou o lote que contém o e-mail atrasado).
Informações sobre a descontinuação
A operação "Encaminhar uma postagem" foi temporariamente descontinuada devido à falta de suporte de controle de exfiltração de e-mail para este conector. Estamos trabalhando para fornecer suporte e atualizaremos a operação quando concluída.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
| Frequência das sondagens de desencadeamento | 1 | 60 segundos |
Ações
| Criar um tópico de conversação |
Crie um novo thread na conversa especificada. |
| Criar uma nova conversação num grupo |
Crie uma nova conversa neste grupo. |
| Encaminhar um post [DEPRECATED] |
Esta ação foi preterida. Por favor, use Encaminhar uma postagem em vez disso.
|
| Encaminhar uma publicação (Visualização) |
Encaminhar 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 tópico de conversa |
Exclui o thread de conversa especificado. |
| Iniciar uma nova conversa de grupo criando um thread |
Inicie uma nova conversa em grupo criando primeiro um tópico. |
| Listar as conversas de um grupo |
Obtenha todas as conversas neste grupo. |
| Listar as postagens de um tópico de conversa |
Obtenha todas as postagens do tópico de conversa especificado. |
| Listar os anexos de uma postagem |
Recupere uma lista de anexos que pertencem a uma postagem. |
| Listar os tópicos de conversa de uma conversa |
Obtenha todos os tópicos em uma conversa em grupo. |
| Listar os tópicos de um grupo |
Obtenha todos os tópicos de um grupo. |
| Obter um tópico de conversa |
Obtenha um thread específico que pertença a um grupo. |
| Obter uma conversa em grupo |
Recupera as propriedades de uma conversa específica. |
| Obter uma publicação de discussão |
Recupera uma postagem em um thread especificado. |
| Responder a um tópico de conversação |
Responda a um tópico em uma conversa de grupo e adicione uma nova postagem a ele. |
| Responder a uma publicação |
Responda a uma publicação e adicione uma nova publicação ao thread especificado numa conversa de grupo. |
Criar um tópico de conversação
Crie um novo thread na conversa especificada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do grupo
|
groupId | True | string |
Escolha um grupo na lista suspensa ou insira a ID do grupo. |
|
ID da conversação
|
conversationId | True | string |
Insira o ID da conversa. |
|
Novo tópico
|
topic | True | string |
Tema da nova conversa. |
|
Content
|
content | True | html |
Conteúdo da nova conversa. |
|
Categorias
|
categories | array of string |
As categorias associadas ao post. |
|
|
Address
|
Address |
Endereço de e-mail. |
||
|
Nome do anexo
|
Name | True | string |
Nome do anexo. |
|
Conteúdo do anexo
|
ContentBytes | True | byte |
Conteúdo do anexo. |
Devoluções
Criar uma nova conversação num grupo
Crie uma nova conversa neste grupo.
Parâmetros
| Name | Chave | Necessá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 |
Tema da nova conversa. |
|
Content
|
content | True | html |
Conteúdo da nova conversa. |
|
Categorias
|
categories | array of string |
As categorias associadas ao post. |
|
|
Address
|
Address |
Endereço de e-mail. |
||
|
Nome do anexo
|
Name | True | string |
Nome do anexo. |
|
Conteúdo do anexo
|
ContentBytes | True | byte |
Conteúdo do anexo. |
Devoluções
A resposta de com os detalhes da conversa criada.
- Objeto de conversação criado
- CreateConversationResponse
Encaminhar um post [DEPRECATED]
Esta ação foi preterida. Por favor, use Encaminhar uma postagem em vez disso.
Encaminhar uma postagem para um destinatário.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
|
ID da publicação
|
postId | True | string |
Insira o ID da postagem. |
|
Comment
|
comment | string |
Comente para encaminhar com o post. |
|
|
Address
|
Address |
Endereço de e-mail. |
Encaminhar uma publicação (Visualização)
Encaminhar uma postagem para um destinatário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Correio de grupo
|
groupMail | True | string |
Escolha um grupo na lista suspensa ou digite o endereço de e-mail do grupo. |
|
ID da conversação
|
conversationId | True | string |
Insira o ID da conversa. |
|
Thread ID
|
threadId | True | string |
Insira o ID do tópico de conversa. |
|
ID da publicação
|
postId | True | string |
Insira o ID da postagem. |
|
Comment
|
Comment | html |
Comente para encaminhar com o post. |
|
|
Address
|
Address |
Endereço de e-mail. |
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
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
O URI completo ou relativo. Exemplo: |
|
Método
|
Method | True | string |
O método HTTP (o padrão é GET). |
|
Body
|
Body | binary |
O conteúdo do corpo da solicitação. |
|
|
Tipo de conteúdo
|
ContentType | string |
O cabeçalho do tipo de conteúdo para o corpo (o padrão é application/json). |
|
|
CustomHeader1
|
CustomHeader1 | string |
Cabeçalho personalizado 1. Especificar em formato: header-name: header-value |
|
|
CustomHeader2
|
CustomHeader2 | string |
Cabeçalho personalizado 2. Especificar em formato: header-name: header-value |
|
|
CustomHeader3
|
CustomHeader3 | string |
Cabeçalho personalizado 3. Especificar em formato: header-name: header-value |
|
|
CustomHeader4
|
CustomHeader4 | string |
Cabeçalho personalizado 4. Especificar em formato: header-name: header-value |
|
|
CustomHeader5
|
CustomHeader5 | string |
Cabeçalho personalizado 5. Especificar em formato: header-name: header-value |
Devoluções
- response
- ObjectWithoutType
Excluir um tópico de conversa
Exclui o thread de conversa especificado.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
Iniciar uma nova conversa de grupo criando um thread
Inicie uma nova conversa em grupo criando primeiro um tópico.
Parâmetros
| Name | Chave | Necessá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 |
Tema da nova conversa. |
|
Content
|
content | True | html |
Conteúdo da nova conversa. |
|
Categorias
|
categories | array of string |
As categorias associadas ao post. |
|
|
Address
|
Address |
Endereço de e-mail. |
||
|
Nome do anexo
|
Name | True | string |
Nome do anexo. |
|
Conteúdo do anexo
|
ContentBytes | True | byte |
Conteúdo do anexo. |
Devoluções
Listar as conversas de um grupo
Obtenha todas as conversas neste grupo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do grupo
|
groupId | True | string |
Escolha um grupo na lista suspensa ou insira a ID do grupo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of Conversation |
Listar as postagens de um tópico de conversa
Obtenha todas as postagens do tópico de conversa especificado.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of Post |
Matriz que contém as postagens no thread especificado. |
Listar os anexos de uma postagem
Recupere uma lista de anexos que pertencem a uma postagem.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
|
ID da publicação
|
postId | True | string |
Insira o ID da postagem. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of Attachment |
Matriz que contém os anexos da postagem. |
Listar os tópicos de conversa de uma conversa
Obtenha todos os tópicos em uma conversa em grupo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do grupo
|
groupId | True | string |
Escolha um grupo na lista suspensa ou insira a ID do grupo. |
|
ID da conversação
|
conversationId | True | string |
Insira o ID da conversa. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of ConversationThread |
Listar os tópicos de um grupo
Obtenha todos os tópicos de um grupo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do grupo
|
groupId | True | string |
Escolha um grupo na lista suspensa ou insira a ID do grupo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of ConversationThread |
Obter um tópico de conversa
Obtenha um thread específico que pertença a um grupo.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
Devoluções
Objeto de thread de conversa.
- Body
- ConversationThread
Obter uma conversa em grupo
Recupera as propriedades de uma conversa específica.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do grupo
|
groupId | True | string |
Escolha um grupo na lista suspensa ou insira a ID do grupo. |
|
ID da conversação
|
conversationId | True | string |
Insira o ID da conversa. |
Devoluções
Objeto de conversação.
- Body
- Conversation
Obter uma publicação de discussão
Recupera uma postagem em um thread especificado.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
|
ID da publicação
|
postId | True | string |
Insira o ID da postagem. |
Devoluções
Representa um item Post individual dentro de uma entidade conversationThread.
- Body
- Post
Responder a um tópico de conversação
Responda a um tópico em uma conversa de grupo e adicione uma nova postagem a ele.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
|
Content
|
content | True | html |
Conteúdo da nova conversa. |
|
Categorias
|
categories | array of string |
As categorias associadas ao post. |
|
|
Address
|
Address |
Endereço de e-mail. |
||
|
Nome do anexo
|
Name | True | string |
Nome do anexo. |
|
Conteúdo do anexo
|
ContentBytes | True | byte |
Conteúdo do anexo. |
Responder a uma publicação
Responda a uma publicação e adicione uma nova publicação ao thread especificado numa conversa de grupo.
Parâmetros
| Name | Chave | Necessá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 o ID do tópico de conversa. |
|
ID da publicação
|
postId | True | string |
Insira o ID da postagem. |
|
Content
|
content | True | html |
Conteúdo da nova conversa. |
|
Categorias
|
categories | array of string |
As categorias associadas ao post. |
|
|
Address
|
Address |
Endereço de e-mail. |
||
|
Nome do anexo
|
Name | True | string |
Nome do anexo. |
|
Conteúdo do anexo
|
ContentBytes | True | byte |
Conteúdo do anexo. |
Acionadores
| Quando um novo e-mail chega a um grupo |
Quando um novo e-mail chega a um grupo. |
Quando um novo e-mail chega a um grupo
Quando um novo e-mail chega a um grupo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do grupo
|
groupId | True | string |
Escolha um grupo na lista suspensa ou insira a ID do grupo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of ConversationTriggerResponse |
Resposta do gatilho. |
Definições
Conversa
Objeto de conversação.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conversação
|
id | string |
O identificador único das conversas. |
|
Tópico da conversa
|
topic | string |
O tema da conversa. |
|
Tem anexos?
|
hasAttachments | boolean |
Indica se alguma das publicações desta Conversa tem pelo menos um anexo. |
|
Carimbo de data/hora entregue pela última vez
|
lastDeliveredDateTime | date-time |
O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em hora 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 do último post desta conversa. |
ConversaThread
Objeto de thread de conversa.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tópico de conversação
|
id | string |
O identificador exclusivo do thread de conversa. |
|
Tópico da conversa
|
topic | string |
O tema da conversa. |
|
Tem anexos?
|
hasAttachments | boolean |
Indica se alguma das publicações desta Conversa tem pelo menos um anexo. |
|
Carimbo de data/hora entregue pela última vez
|
lastDeliveredDateTime | date-time |
O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em hora 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 do último post desta conversa. |
|
Está bloqueado?
|
isLocked | boolean |
Indica se o thread está bloqueado. |
|
paraDestinatários
|
toRecipients | array of EmailAddress |
Os destinatários Para: para o thread. |
|
ccDestinatários
|
ccRecipients | array of EmailAddress |
O Cc: destinatários para o thread. |
Publicar
Representa um item Post individual dentro de uma entidade conversationThread.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da publicação
|
id | string |
O identificador exclusivo da postagem. |
|
Criado carimbo de data/hora do post
|
createdDateTime | date-time | |
|
Carimbo de data/hora da última modificação do correio
|
lastModifiedDateTime | date-time | |
|
Alterar chave
|
changeKey | string |
Identifica a versão da postagem. |
|
ID da conversação
|
conversationId | string |
ID exclusivo da conversa a que a publicação pertence. |
|
ID do tópico de conversação
|
conversationThreadId | string |
ID exclusivo do tópico de conversa ao qual a postagem pertence. |
|
Categorias
|
categories | array of string |
As categorias associadas ao post. |
|
Carimbo de data/hora recebido
|
receivedDateTime | date-time |
Post recebeu carimbo de data/hora. |
|
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 tópico como parte desta publicação. |
|
body
|
body | ItemBody |
Representa as propriedades do corpo de um item, como uma mensagem, evento ou postagem de grupo. |
|
de
|
from | EmailAddress | |
|
remetente
|
sender | EmailAddress | |
|
attachments
|
attachments | array of Attachment |
Anexo
| Name | 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 do 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
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome do utilizador
|
emailAddress.name | string | |
|
Endereço de e-mail do utilizador
|
emailAddress.address |
ItemBody
Representa as propriedades do corpo de um item, como uma mensagem, evento ou postagem de grupo.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tipo de conteúdo corporal
|
contentType | string |
Tipo de conteúdo do corpo. |
|
Conteúdo corporal
|
content | string |
Conteúdo do corpo. |
CreateConversationResponse
A resposta de com os detalhes da conversa criada.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conversação
|
id | string |
Novo ID de conversação. |
|
Tópicos de conversa
|
threads | array of object |
Discussão de conversa criada. |
|
Thread ID
|
threads.id | string |
O novo ID de thread. |
NewConversationThreadResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tópico de conversação
|
id | string |
Novo ID de thread de conversa. |
ConversationTriggerResponse
Quando um novo e-mail chega, aciona a resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da conversação
|
id | string |
O identificador exclusivo da conversa. |
|
Carimbo de data/hora entregue pela última vez
|
lastDeliveredDateTime | date-time |
O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em hora UTC. |
|
threads
|
threads | array of ConversationThreadTriggerResponse |
ConversationThreadTriggerResponse
Objeto de thread de conversa.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tópico de conversação
|
id | string |
O identificador exclusivo do thread de conversa. |
|
publicações
|
posts | array of PostTriggerResponse |
PostTriggerResponse
Representa um item Post individual dentro de uma entidade conversationThread.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da publicação
|
id | string |
O identificador exclusivo da postagem. |
|
Carimbo de data/hora da última modificação do correio
|
lastModifiedDateTime | date-time | |
|
Alterar chave
|
changeKey | string |
Identifica a versão da postagem. |