Chat de Comunicação do Azure
Conector para utilizar recursos de Chat dos Serviços de Comunicação do Azure.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| acssolutions@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://azure.microsoft.com/services/communication-services |
| Política de privacidade | https://privacy.microsoft.com |
| Categorias | Communication |
O Chat dos Serviços de Comunicação do Azure ajuda a adicionar comunicação de texto em tempo real a aplicativos multiplataforma.
Pré-requisitos
Você precisará do seguinte para continuar:
- Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado
- Uma assinatura do Azure
- Um recurso dos Serviços de Comunicação do Azure
Como obter credenciais
1 Configurar um recurso dos Serviços de Comunicação do Azure
Autenticação de cadeia de conexão 2
- Você pode criar uma nova conexão usando uma URL de ponto de extremidade de recurso dos Serviços de Comunicação do Azure.
Introdução ao conector
Depois de configurar um recurso dos Serviços de Comunicação do Azure, gere um token de acesso do usuário. Use esse token para as ações do conector.
Problemas e limitações conhecidos
Nenhum problema ou limitação conhecido neste momento.
perguntas frequentes
- Como faço para gerar um token de acesso?
- Você pode usar o Conector de Identidade dos Serviços de Comunicação do Azure para gerar uma nova identidade de usuário, bem como atualizar tokens de acesso para um usuário. Você também pode fazer isso manualmente por meio do portal para teste.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| URL do ponto de extremidade | secureString | URL do ponto de extremidade dos Serviços de Comunicação do Azure. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adicionar participantes do thread de chat |
Adicionar participantes ao thread de chat. |
| Atualizar as propriedades do thread de chat |
Atualize as propriedades do thread de chat. |
| Criar o tópico de bate-papo |
Crie um thread de chat. |
| Enviar mensagem para o thread de chat |
Enviar mensagem para o thread de chat. |
| Excluir conversa de chat |
Excluir um thread de chat. |
| Listar participantes do tópico de chat |
Listar participantes no thread de chat. |
| Listar threads de chat |
Listar threads de chat. |
| Liste as mensagens de thread de chat |
Listar mensagens do thread de chat. |
| Obter propriedades de thread de chat |
Obtenha as propriedades do thread de chat. |
| Remover participante do thread de chat |
Remova o participante do thread de chat. |
Adicionar participantes do thread de chat
Adicionar participantes ao thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
|
ID do Usuário
|
id | string | ||
|
Nome de Exibição
|
displayName | string |
Nome de exibição para o participante do chat. |
|
|
Hora
|
shareHistoryTime | string |
Tempo em RFC3339 formato (yyyy-MM-ddTHH:mm:ssZ) do qual o histórico de chat é compartilhado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Lista de participantes inválidos. |
|
Meta
|
invalidParticipants.target | string |
ID de destino. |
|
Code
|
invalidParticipants.code | string |
Código de erro. |
|
Message
|
invalidParticipants.message | string |
Mensagem de erro. |
Atualizar as propriedades do thread de chat
Atualize as propriedades do thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
|
Tópico do Thread de Chat
|
topic | string |
Tópico do thread de chat. |
Criar o tópico de bate-papo
Crie um thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Tópico do Thread de Chat
|
topic | True | string |
Tópico do thread de chat. |
|
ID do Usuário
|
id | string | ||
|
Nome
|
displayName | string |
Nome de exibição para o participante do chat. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
chatThread.id | string |
Chat Thread ID |
|
Tópico
|
chatThread.topic | string |
Tópico do Thread de Chat |
|
Data da criação
|
chatThread.createdOn | date-time |
Hora de criação do chat |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
Enviar mensagem para o thread de chat
Enviar mensagem para o thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
|
Content
|
content | True | string |
Conteúdo da mensagem. |
|
Nome
|
senderDisplayName | True | string |
Nome de exibição para o remetente da mensagem. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
Excluir conversa de chat
Excluir um thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
Listar participantes do tópico de chat
Listar participantes no thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
|
Número de participantes a ignorar
|
skip | string |
Ignora os participantes até uma posição especificada em resposta. |
|
|
Máximo de participantes por página
|
maxPageSize | string |
Número máximo de participantes a serem retornados por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of object |
Participantes do chat. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
|
Nome
|
value.displayName | string |
Nome de exibição para o participante do chat. |
|
Hora
|
value.shareHistoryTime | string |
Tempo em RFC3339 formato (yyyy-MM-ddTHH:mm:ssZ) do qual o histórico de chat é compartilhado. |
|
Próximo Link
|
nextLink | string |
Se houver mais participantes de chat que possam ser recuperados, o próximo link será preenchido. |
Listar threads de chat
Listar threads de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Hora de Início
|
startTime | string |
Hora de início em RFC3339 formato (yyy-MM-ddTHH:mm:ssZ) para obter threads de chat. |
|
|
Tamanho máximo da página
|
maxPageSize | integer |
Número máximo de threads de chat retornados por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Chat Threads
|
value | array of object |
Coleção de threads de chat. |
|
ID
|
value.id | string |
ID do thread de chat. |
|
Tópico
|
value.topic | string |
Tópico do thread de chat. |
|
última mensagem recebida
|
value.lastMessageReceivedOn | string |
Carimbo de data/hora no formato RFC3339 (yyy-MM-ddTHH:mm:ssZ) quando a última mensagem chegou ao servidor. |
|
Excluído em
|
value.deletedOn | string |
Carimbo de data/hora no formato RFC3339 (yyy-MM-ddTHH:mm:ssZ) quando o thread de chat foi excluído. |
|
Próximo Link
|
nextLink | string |
Se houver mais threads de chat que podem ser recuperados, o próximo link será preenchido. |
Liste as mensagens de thread de chat
Listar mensagens do thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
|
Hora de Início
|
startTime | string |
Hora de início em RFC3339 formato (yyy-MM-ddTHH:mm:ssZ) para obter mensagens. |
|
|
Tamanho máximo da página
|
maxPageSize | string |
Número máximo de mensagens a serem retornadas por página. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Lista de Mensagens
|
value | array of object |
Coleção de mensagens de chat. |
|
ID
|
value.id | string |
ID da mensagem de chat. Essa ID é gerada pelo servidor. |
|
Tipo
|
value.type | string |
Tipo de mensagem de chat. |
|
Versão
|
value.version | string |
Versão da mensagem de chat. |
|
ID da sequência
|
value.sequenceId | string |
Sequência da mensagem de chat na conversa. |
|
mensagem
|
value.content.message | string |
Conteúdo da mensagem de chat. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
|
Tópico
|
value.content.topic | string |
Conteúdo da mensagem de chat para mensagens do tipo topicUpdated. |
|
Participantes
|
value.content.participants | array of object |
Conteúdo da mensagem de chat para mensagens dos tipos de participante Adicionados ou participanteRemoved. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
|
Nome de exibição do remetente
|
value.senderDisplayName | string |
Nome de exibição do remetente da mensagem de chat. Essa propriedade é usada para preencher o nome do remetente para notificações por push. |
|
Data da criação
|
value.createdOn | string |
Carimbo de data/hora no formato RFC3339 (yyy-MM-ddTHH:mm:ssZ) quando a mensagem de chat chegou ao servidor. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
|
Próximo Link
|
nextLink | string |
Se houver mais mensagens de chat que podem ser recuperadas, o próximo link será preenchido. |
Obter propriedades de thread de chat
Obtenha as propriedades do thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
ID do thread de chat. |
|
Tópico
|
topic | string |
Tópico do thread de chat. |
|
Data da criação
|
createdOn | string |
Hora em que o thread foi criado. |
|
Excluído em
|
deletedOn | string |
Hora em que o thread foi excluído. |
|
ID bruta
|
createdByCommunicationIdentifier.rawId | string |
ID bruta do identificador. |
|
ID
|
createdByCommunicationIdentifier.communicationUser.id | string |
ID do usuário de comunicação. |
Remover participante do thread de chat
Remova o participante do thread de chat.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do thread de chat. |
|
ID do Usuário
|
id | string |
Definições
CommunicationIdentifier
Identificador de comunicação.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do Usuário
|
communicationUser.id | string |