Conversation de communication Azure
Connecteur permettant d’utiliser les fonctionnalités de conversation Azure Communication Services.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| Messagerie électronique | acssolutions@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://azure.microsoft.com/services/communication-services |
| Politique de confidentialité | https://privacy.microsoft.com |
| Catégories | Communication |
Azure Communication Services Chat permet d’ajouter une communication texte en temps réel aux applications multiplateformes.
Prerequisites
Vous devez procéder comme suit :
- Un plan Microsoft Power Apps ou Power Automate avec une fonctionnalité de connecteur personnalisée
- Un abonnement Azure
- Ressource Azure Communication Services
Comment obtenir des informations d’identification
1 Configurer une ressource Azure Communication Services
2 Authentification de chaîne de connexion
- Vous pouvez créer une connexion à l’aide d’une URL de point de terminaison de ressource Azure Communication Services.
Bien démarrer avec votre connecteur
Après avoir configuré une ressource Azure Communication Services, générez un jeton d’accès utilisateur. Utilisez ce jeton pour les actions du connecteur.
Problèmes connus et limitations
Aucun problème ou limitations connus à ce stade.
Questions fréquentes (FAQ)
- Comment générer un jeton d’accès ?
- Vous pouvez utiliser Azure Communication Services Identity Connector pour générer une nouvelle identité utilisateur, ainsi que actualiser les jetons d’accès pour un utilisateur. Vous pouvez également le faire manuellement via le portail pour les tests.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| URL du point de terminaison | securestring | URL du point de terminaison Azure Communication Services. | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Ajouter des participants au fil de conversation |
Ajoutez des participants au fil de conversation. |
| Créer un fil de conversation |
Créez un fil de conversation. |
| Envoyer un message à un thread de conversation |
Envoyez un message au fil de conversation. |
| Mettre à jour les propriétés du thread de conversation |
Mettez à jour les propriétés du thread de conversation. |
| Obtenir les propriétés du thread de conversation |
Obtenez les propriétés du thread de conversation. |
| Répertorier les fils de conversation |
Répertorier les threads de conversation. |
| Répertorier les messages de thread de conversation |
Répertorier les messages à partir du fil de conversation. |
| Répertorier les participants d’un fil de conversation |
Répertorier les participants dans le fil de conversation. |
| Supprimer le participant du thread de conversation |
Supprimez le participant du fil de conversation. |
| Supprimer un fil de conversation |
Supprimez un thread de conversation. |
Ajouter des participants au fil de conversation
Ajoutez des participants au fil de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
|
ID d’utilisateur
|
id | string | ||
|
Nom d’affichage
|
displayName | string |
Nom complet du participant de conversation. |
|
|
Heure
|
shareHistoryTime | string |
Temps au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) à partir duquel l’historique des conversations est partagé. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Liste des participants non valides. |
|
Cible
|
invalidParticipants.target | string |
ID cible. |
|
Code
|
invalidParticipants.code | string |
Code d’erreur. |
|
Message
|
invalidParticipants.message | string |
Message d’erreur. |
Créer un fil de conversation
Créez un fil de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Rubrique sur les threads de conversation
|
topic | True | string |
Rubrique sur les threads de conversation. |
|
ID d’utilisateur
|
id | string | ||
|
Nom
|
displayName | string |
Nom complet du participant de conversation. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
chatThread.id | string |
ID du thread de conversation |
|
Sujet
|
chatThread.topic | string |
Rubrique sur les threads de conversation |
|
Création le
|
chatThread.createdOn | date-time |
Heure de création de conversation |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Identificateur de communication. |
Envoyer un message à un thread de conversation
Envoyez un message au fil de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
|
Content
|
content | True | string |
Contenu du message. |
|
Nom
|
senderDisplayName | True | string |
Nom complet de l’expéditeur du message. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string |
pièce d'identité |
Mettre à jour les propriétés du thread de conversation
Mettez à jour les propriétés du thread de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
|
Rubrique sur les threads de conversation
|
topic | string |
Rubrique sur les threads de conversation. |
Obtenir les propriétés du thread de conversation
Obtenez les propriétés du thread de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
ID du thread de conversation. |
|
Sujet
|
topic | string |
Rubrique sur les threads de conversation. |
|
Création le
|
createdOn | string |
Heure de création du thread. |
|
Supprimé sur
|
deletedOn | string |
Heure de suppression du thread. |
|
ID brut
|
createdByCommunicationIdentifier.rawId | string |
ID brut de l’identificateur. |
|
ID
|
createdByCommunicationIdentifier.communicationUser.id | string |
ID de l’utilisateur de communication. |
Répertorier les fils de conversation
Répertorier les threads de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Heure de début
|
startTime | string |
Heure de début au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) pour obtenir des threads de conversation. |
|
|
Taille maximale de la page
|
maxPageSize | integer |
Nombre maximal de threads de conversation retournés par page. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Threads de conversation
|
value | array of object |
Collection de threads de conversation. |
|
ID
|
value.id | string |
ID du thread de conversation. |
|
Sujet
|
value.topic | string |
Rubrique sur les threads de conversation. |
|
dernier message reçu le
|
value.lastMessageReceivedOn | string |
Horodatage au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) lorsque le dernier message est arrivé au serveur. |
|
Supprimé sur
|
value.deletedOn | string |
Horodatage au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) lorsque le thread de conversation a été supprimé. |
|
Lien suivant
|
nextLink | string |
S’il existe d’autres threads de conversation qui peuvent être récupérés, le lien suivant est rempli. |
Répertorier les messages de thread de conversation
Répertorier les messages à partir du fil de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
|
Heure de début
|
startTime | string |
Heure de début au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) pour obtenir des messages. |
|
|
Taille maximale de la page
|
maxPageSize | string |
Nombre maximal de messages à renvoyer par page. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Liste des messages
|
value | array of object |
Collection de messages de conversation. |
|
ID
|
value.id | string |
ID du message de conversation. Cet ID est généré par le serveur. |
|
Type
|
value.type | string |
Type de message de conversation. |
|
Version
|
value.version | string |
Version du message de conversation. |
|
ID de séquence
|
value.sequenceId | string |
Séquence du message de conversation dans la conversation. |
|
Message
|
value.content.message | string |
Contenu du message de conversation. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Identificateur de communication. |
|
Sujet
|
value.content.topic | string |
Contenu du message de conversation pour les messages de type topicUpdated. |
|
Participants
|
value.content.participants | array of object |
Contenu du message de conversation pour les messages de types participantAdded ou participantRemoved. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Identificateur de communication. |
|
Nom complet de l’expéditeur
|
value.senderDisplayName | string |
Nom complet de l’expéditeur du message de conversation. Cette propriété est utilisée pour remplir le nom de l’expéditeur pour les notifications Push. |
|
Création le
|
value.createdOn | string |
Horodatage au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) lorsque le message de conversation est arrivé au serveur. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Identificateur de communication. |
|
Lien suivant
|
nextLink | string |
S’il existe plus de messages de conversation qui peuvent être récupérés, le lien suivant est rempli. |
Répertorier les participants d’un fil de conversation
Répertorier les participants dans le fil de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
|
Nombre de participants à ignorer
|
skip | string |
Ignore les participants jusqu’à une position spécifiée en réponse. |
|
|
Nombre maximal de participants par page
|
maxPageSize | string |
Nombre maximal de participants à retourner par page. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of object |
Participants à la conversation. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Identificateur de communication. |
|
Nom
|
value.displayName | string |
Nom complet du participant de conversation. |
|
Heure
|
value.shareHistoryTime | string |
Temps au format RFC3339 (aaaa-MM-ddTHH :mm :ssZ) à partir duquel l’historique des conversations est partagé. |
|
Lien suivant
|
nextLink | string |
S’il y a plus de participants à la conversation qui peuvent être récupérés, le lien suivant est rempli. |
Supprimer le participant du thread de conversation
Supprimez le participant du fil de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
|
ID d’utilisateur
|
id | string |
Supprimer un fil de conversation
Supprimez un thread de conversation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton d'accès
|
Access-Token | True | string |
Jeton d’accès utilisateur. |
|
Thread ID
|
chatThreadId | True | string |
ID du thread de conversation. |
Définitions
CommunicationIdentifier
Identificateur de communication.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID d’utilisateur
|
communicationUser.id | string |