Chat de comunicación de Azure
Conector para usar las características de chat de Azure Communication Services.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| Correo Electrónico | acssolutions@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://azure.microsoft.com/services/communication-services |
| Directiva de privacidad | https://privacy.microsoft.com |
| Categorías | Communication |
Chat de Azure Communication Services ayuda a agregar comunicación de texto en tiempo real a aplicaciones multiplataforma.
Prerrequisitos
Necesitará lo siguiente para continuar:
- Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada
- Una suscripción de Azure
- Un recurso de Azure Communication Services
Obtención de credenciales
1 Configuración de un recurso de Azure Communication Services
2 Autenticación de cadena de conexión
- Puede crear una nueva conexión mediante una dirección URL de punto de conexión de recursos de Azure Communication Services.
Introducción al conector
Después de configurar un recurso de Azure Communication Services, genere un token de acceso de usuario. Use este token para las acciones del conector.
Problemas y limitaciones conocidos
No hay problemas o limitaciones conocidos en este momento.
Preguntas más frecuentes
- ¿Cómo se genera un token de acceso?
- Puede usar Azure Communication Services Identity Connector para generar una nueva identidad de usuario, así como actualizar tokens de acceso para un usuario. También puede hacerlo manualmente a través del portal para realizar pruebas.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Dirección URL del punto de conexión | securestring | Dirección URL del punto de conexión de Azure Communication Services. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar las propiedades del subproceso de chat |
Actualice las propiedades del subproceso de chat. |
| Agregar participantes de subprocesos de chat |
Agregar participantes al subproceso de chat. |
| Crear hilo de chat |
Cree un subproceso de chat. |
| Eliminar hilo de chat |
Eliminar un subproceso de chat. |
| Enumerar mensajes de subprocesos de chat |
Enumerar mensajes del subproceso de chat. |
| Enumerar subprocesos de chat |
Enumerar los subprocesos de chat. |
| Enviar mensaje al subproceso de chat |
Enviar mensaje al subproceso de chat. |
| Lista de participantes de los hilos de chat |
Enumerar a los participantes en el subproceso de chat. |
| Obtener propiedades del subproceso de chat |
Obtenga las propiedades del subproceso de chat. |
| Quitar participante del subproceso de chat |
Quite el participante del subproceso de chat. |
Actualizar las propiedades del subproceso de chat
Actualice las propiedades del subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
|
Tema de subproceso de chat
|
topic | string |
Tema del subproceso de chat. |
Agregar participantes de subprocesos de chat
Agregar participantes al subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
|
Id. de usuario
|
id | string | ||
|
Nombre de pantalla
|
displayName | string |
Nombre para mostrar del participante del chat. |
|
|
Time
|
shareHistoryTime | string |
Hora en RFC3339 formato (aaaa-MM-ddTHH:mm:ssZ) desde la que se comparte el historial de chat. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Lista de participantes no válidos. |
|
Objetivo
|
invalidParticipants.target | string |
Id. de destino. |
|
Código
|
invalidParticipants.code | string |
Código de error. |
|
Message
|
invalidParticipants.message | string |
Mensaje de error. |
Crear hilo de chat
Cree un subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Tema de subproceso de chat
|
topic | True | string |
Tema del subproceso de chat. |
|
Id. de usuario
|
id | string | ||
|
Nombre
|
displayName | string |
Nombre para mostrar del participante del chat. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
chatThread.id | string |
Identificador de subproceso de chat |
|
Tema
|
chatThread.topic | string |
Tema de subproceso de chat |
|
Creadas el
|
chatThread.createdOn | date-time |
Hora de creación del chat |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicación. |
Eliminar hilo de chat
Eliminar un subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
Enumerar mensajes de subprocesos de chat
Enumerar mensajes del subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
|
Hora de comienzo
|
startTime | string |
Hora de inicio en formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) para obtener mensajes. |
|
|
Tamaño máximo de página
|
maxPageSize | string |
Número máximo de mensajes que se van a devolver por página. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Lista de mensajes
|
value | array of object |
Recopilación de mensajes de chat. |
|
identificación
|
value.id | string |
Id. del mensaje de chat. Este identificador es el servidor generado. |
|
Tipo
|
value.type | string |
Tipo de mensaje de chat. |
|
Versión
|
value.version | string |
Versión del mensaje de chat. |
|
ID de secuencia
|
value.sequenceId | string |
Secuencia del mensaje de chat en la conversación. |
|
Mensaje
|
value.content.message | string |
Contenido del mensaje de chat. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicación. |
|
Tema
|
value.content.topic | string |
Contenido del mensaje de chat para mensajes de tipo topicUpdated. |
|
Participantes
|
value.content.participants | array of object |
Contenido del mensaje de chat para mensajes de tipos participantesAdded o participantRemoved. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Identificador de comunicación. |
|
Nombre para mostrar del remitente
|
value.senderDisplayName | string |
Nombre para mostrar del remitente del mensaje de chat. Esta propiedad se usa para rellenar el nombre del remitente para las notificaciones push. |
|
Creadas el
|
value.createdOn | string |
Marca de tiempo en formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) cuando el mensaje de chat llegó al servidor. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Identificador de comunicación. |
|
Vínculo siguiente
|
nextLink | string |
Si hay más mensajes de chat que se pueden recuperar, se rellenará el siguiente vínculo. |
Enumerar subprocesos de chat
Enumerar los subprocesos de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Hora de comienzo
|
startTime | string |
Hora de inicio en formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) para obtener subprocesos de chat. |
|
|
Tamaño máximo de página
|
maxPageSize | integer |
Número máximo de subprocesos de chat devueltos por página. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Subprocesos de chat
|
value | array of object |
Colección de subprocesos de chat. |
|
identificación
|
value.id | string |
Identificador de subproceso de chat. |
|
Tema
|
value.topic | string |
Tema del subproceso de chat. |
|
último mensaje recibido al
|
value.lastMessageReceivedOn | string |
Marca de tiempo en formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) cuando el último mensaje llegó al servidor. |
|
Eliminado en
|
value.deletedOn | string |
Marca de tiempo en formato RFC3339 (aaaa-MM-ddTHH:mm:ssZ) cuando se eliminó el subproceso de chat. |
|
Vínculo siguiente
|
nextLink | string |
Si hay más subprocesos de chat que se pueden recuperar, se rellenará el siguiente vínculo. |
Enviar mensaje al subproceso de chat
Enviar mensaje al subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
|
Content
|
content | True | string |
Contenido del mensaje. |
|
Nombre
|
senderDisplayName | True | string |
Nombre para mostrar del remitente del mensaje. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
Lista de participantes de los hilos de chat
Enumerar a los participantes en el subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
|
Número de participantes que se van a omitir
|
skip | string |
Omite a los participantes hasta una posición especificada en respuesta. |
|
|
Número máximo de participantes por página
|
maxPageSize | string |
Número máximo de participantes que se devolverán por página. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of object |
Participantes del chat. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Identificador de comunicación. |
|
Nombre
|
value.displayName | string |
Nombre para mostrar del participante del chat. |
|
Time
|
value.shareHistoryTime | string |
Hora en RFC3339 formato (aaaa-MM-ddTHH:mm:ssZ) desde la que se comparte el historial de chat. |
|
Vínculo siguiente
|
nextLink | string |
Si hay más participantes de chat que se pueden recuperar, se rellenará el siguiente vínculo. |
Obtener propiedades del subproceso de chat
Obtenga las propiedades del subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador de subproceso de chat. |
|
Tema
|
topic | string |
Tema del subproceso de chat. |
|
Creadas el
|
createdOn | string |
Hora en que se creó el subproceso. |
|
Eliminado en
|
deletedOn | string |
Hora en que se eliminó el subproceso. |
|
Id. sin formato
|
createdByCommunicationIdentifier.rawId | string |
Id. sin formato del identificador. |
|
identificación
|
createdByCommunicationIdentifier.communicationUser.id | string |
Identificador del usuario de comunicación. |
Quitar participante del subproceso de chat
Quite el participante del subproceso de chat.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Token de acceso
|
Access-Token | True | string |
Token de acceso de usuario. |
|
Identificador de subproceso
|
chatThreadId | True | string |
Identificador de subproceso de chat. |
|
Id. de usuario
|
id | string |
Definiciones
CommunicationIdentifier
Identificador de comunicación.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de usuario
|
communicationUser.id | string |