Chat de Comunicação do Azure
Conector para utilizar os recursos de Chat dos Serviços de Comunicação do Azure.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | 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 aplicações multiplataforma.
Pré-requisitos
Você precisará do seguinte para prosseguir:
- Um plano Microsoft Power Apps ou Power Automate com 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
2 Autenticação de cadeia de conexão
- 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 de usuário. Use esse token para as ações do conector.
Problemas conhecidos e limitações
Nenhum problema ou limitação conhecida neste momento.
FAQ
- Como 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 fazê-lo manualmente via portal para testes também.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Adicionar participantes do tópico de bate-papo |
Adicione participantes ao tópico de bate-papo. |
| Atualizar propriedades do thread de chat |
Atualize as propriedades do thread de chat. |
| Criar thread de bate-papo |
Crie um tópico de chat. |
| Enviar mensagem para o tópico de chat |
Enviar mensagem para o tópico de chat. |
| Excluir conversa de bate-papo |
Exclua um tópico de bate-papo. |
| Listar mensagens de thread de bate-papo |
Listar mensagens do tópico de bate-papo. |
| Listar participantes do tópico de bate-papo |
Liste os participantes no tópico de bate-papo. |
| Listar tópicos de bate-papo |
Listar tópicos de bate-papo. |
| Obter propriedades de thread de bate-papo |
Obtenha as propriedades do tópico de chat. |
| Remover participante do tópico de bate-papo |
Remova o participante do tópico de bate-papo. |
Adicionar participantes do tópico de bate-papo
Adicione participantes ao tópico de bate-papo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
|
ID de utilizador
|
id | string | ||
|
Nome de exibição
|
displayName | string |
Nome de exibição para o participante do bate-papo. |
|
|
Time
|
shareHistoryTime | string |
Hora no formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) a partir do qual o histórico de bate-papo é compartilhado. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
invalidParticipantes
|
invalidParticipants | array of object |
Lista de participantes inválidos. |
|
Target
|
invalidParticipants.target | string |
ID de destino. |
|
Código
|
invalidParticipants.code | string |
Código de erro. |
|
Message
|
invalidParticipants.message | string |
Mensagem de erro. |
Atualizar propriedades do thread de chat
Atualize as propriedades do thread de chat.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
|
Tópico do tópico do bate-papo
|
topic | string |
Tópico do tópico do bate-papo. |
Criar thread de bate-papo
Crie um tópico de chat.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Tópico do tópico do bate-papo
|
topic | True | string |
Tópico do tópico do bate-papo. |
|
ID de utilizador
|
id | string | ||
|
Nome
|
displayName | string |
Nome de exibição para o participante do bate-papo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
chatThread.id | string |
ID do tópico de bate-papo |
|
Tópico
|
chatThread.topic | string |
Tópico do tópico do bate-papo |
|
Criado em
|
chatThread.createdOn | date-time |
Tempo de Criação do Chat |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
Enviar mensagem para o tópico de chat
Enviar mensagem para o tópico de chat.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
|
Content
|
content | True | string |
Conteúdo da mensagem. |
|
Nome
|
senderDisplayName | True | string |
Nome para exibição do remetente da mensagem. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
Excluir conversa de bate-papo
Exclua um tópico de bate-papo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
Listar mensagens de thread de bate-papo
Listar mensagens do tópico de bate-papo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
|
Hora de Início
|
startTime | string |
Hora de início no formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) para receber mensagens. |
|
|
Tamanho máximo da página
|
maxPageSize | string |
Número máximo de mensagens a serem retornadas por página. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Lista de Mensagens
|
value | array of object |
Recolha de mensagens de chat. |
|
ID
|
value.id | string |
ID da mensagem de chat. Este id é gerado 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 participanteAdicionado ou participanteRemovido. |
|
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. |
|
Criado em
|
value.createdOn | string |
Carimbo de data/hora no formato RFC3339 (aaaa-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 bate-papo que podem ser recuperadas, o próximo link será preenchido. |
Listar participantes do tópico de bate-papo
Liste os participantes no tópico de bate-papo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
|
Número de participantes a saltar
|
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 devolver por página. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of object |
Participantes do bate-papo. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Identificador de comunicação. |
|
Nome
|
value.displayName | string |
Nome de exibição para o participante do bate-papo. |
|
Time
|
value.shareHistoryTime | string |
Hora no formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) a partir do qual o histórico de bate-papo é compartilhado. |
|
Próximo link
|
nextLink | string |
Se houver mais participantes no chat que possam ser recuperados, o próximo link será preenchido. |
Listar tópicos de bate-papo
Listar tópicos de bate-papo.
Parâmetros
| Name | Chave | Necessá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 no formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) para obter tópicos de chat. |
|
|
Tamanho máximo da página
|
maxPageSize | integer |
Número máximo de tópicos de bate-papo retornados por página. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tópicos de bate-papo
|
value | array of object |
Coleção de tópicos de bate-papo. |
|
ID
|
value.id | string |
ID do tópico de chat. |
|
Tópico
|
value.topic | string |
Tópico do tópico do bate-papo. |
|
última mensagem recebida em
|
value.lastMessageReceivedOn | string |
Carimbo de data/hora no formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) quando a última mensagem chegou ao servidor. |
|
Suprimido em
|
value.deletedOn | string |
Carimbo de data/hora no formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) quando o thread de chat foi excluído. |
|
Próximo link
|
nextLink | string |
Se houver mais tópicos de bate-papo que podem ser recuperados, o próximo link será preenchido. |
Obter propriedades de thread de bate-papo
Obtenha as propriedades do tópico de chat.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
ID do tópico de chat. |
|
Tópico
|
topic | string |
Tópico do tópico do bate-papo. |
|
Criado em
|
createdOn | string |
Hora em que o thread foi criado. |
|
Suprimido em
|
deletedOn | string |
Hora em que o thread foi excluído. |
|
ID bruto
|
createdByCommunicationIdentifier.rawId | string |
ID bruto do identificador. |
|
ID
|
createdByCommunicationIdentifier.communicationUser.id | string |
ID do utilizador da comunicação. |
Remover participante do tópico de bate-papo
Remova o participante do tópico de bate-papo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Token de Acesso
|
Access-Token | True | string |
Token de acesso do usuário. |
|
Thread ID
|
chatThreadId | True | string |
ID do tópico de bate-papo. |
|
ID de utilizador
|
id | string |
Definições
CommunicationIdentifier
Identificador de comunicação.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de utilizador
|
communicationUser.id | string |