Azure Communication Chat
Connector zur Nutzung von Azure Communication Services-Chatfunktionen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| acssolutions@microsoft.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://azure.microsoft.com/services/communication-services |
| Datenschutzrichtlinie | https://privacy.microsoft.com |
| Kategorien | Communication |
Azure Communication Services Chat unterstützt das Hinzufügen von Echtzeittextkommunikation zu plattformübergreifenden Anwendungen.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
- Ein Azure-Abonnement
- Eine Azure Communication Services-Ressource
So erhalten Sie Anmeldeinformationen
1 Einrichten einer Azure Communication Services-Ressource
2 Verbindungszeichenfolgenauthentifizierung
- Sie können eine neue Verbindung mit einer Azure Communication Services-Ressourcenendpunkt-URL erstellen.
Erste Schritte mit Ihrem Connector
Generieren Sie nach dem Einrichten einer Azure Communication Services-Ressource ein Benutzerzugriffstoken. Verwenden Sie dieses Token für die Connectoraktionen.
Bekannte Probleme und Einschränkungen
An diesem Punkt sind keine bekannten Probleme oder Einschränkungen bekannt.
Häufig gestellte Fragen
- Wie kann ich ein Zugriffstoken generieren?
- Sie können den Azure Communication Services Identity Connector verwenden, um eine neue Benutzeridentität zu generieren sowie Zugriffstoken für einen Benutzer zu aktualisieren. Sie können dies auch manuell über das Portal zum Testen erledigen.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Endpunkt-URL | securestring | Azure Communication Services-Endpunkt-URL. | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Chatthreadeigenschaften |
Ruft die Eigenschaften des Chatthreads ab. |
| Aktualisieren von Chatthreadeigenschaften |
Aktualisieren Sie die Eigenschaften des Chatthreads. |
| Auflisten von Chatthreadnachrichten |
Nachrichten aus Chatthread auflisten. |
| Auflisten von Chatthreads |
Auflisten von Chatthreads. |
| Chatthread erstellen |
Erstellen Sie einen Chatthread. |
| Chatthread löschen |
Löschen eines Chatthreads. |
| Entfernen eines Chatthreadteilnehmers |
Teilnehmer aus Chatthread entfernen. |
| Hinzufügen von Chatthreadteilnehmern |
Fügen Sie Teilnehmer zum Chatthread hinzu. |
| Nachricht an Chatthread senden |
Nachricht an Chatthread senden. |
| Teilnehmer des Chatthreads auflisten |
Teilnehmer im Chatthread auflisten. |
Abrufen von Chatthreadeigenschaften
Ruft die Eigenschaften des Chatthreads ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ID
|
id | string |
Chatthread-ID. |
|
Thema
|
topic | string |
Thema "Chatthread". |
|
Erstellt am
|
createdOn | string |
Zeitpunkt, zu dem der Thread erstellt wurde. |
|
Gelöscht am
|
deletedOn | string |
Zeitpunkt, zu dem der Thread gelöscht wurde. |
|
Roh-ID
|
createdByCommunicationIdentifier.rawId | string |
Unformatierte ID des Bezeichners. |
|
ID
|
createdByCommunicationIdentifier.communicationUser.id | string |
ID des Kommunikationsbenutzers. |
Aktualisieren von Chatthreadeigenschaften
Aktualisieren Sie die Eigenschaften des Chatthreads.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
|
Thema "Chatthread"
|
topic | string |
Thema "Chatthread". |
Auflisten von Chatthreadnachrichten
Nachrichten aus Chatthread auflisten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
|
Startzeit
|
startTime | string |
Startzeit im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), um Nachrichten abzurufen. |
|
|
Max. Seitengröße
|
maxPageSize | string |
Maximale Anzahl von Nachrichten, die pro Seite zurückgegeben werden sollen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Nachrichtenliste
|
value | array of object |
Sammlung von Chatnachrichten. |
|
ID
|
value.id | string |
ID der Chatnachricht. Diese ID wird vom Server generiert. |
|
Typ
|
value.type | string |
Chatnachrichtentyp. |
|
Version
|
value.version | string |
Version der Chatnachricht. |
|
Sequenz ID
|
value.sequenceId | string |
Sequenz der Chatnachricht in der Unterhaltung. |
|
message
|
value.content.message | string |
Chatnachrichteninhalt. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Kommunikationsbezeichner. |
|
Thema
|
value.content.topic | string |
Chatnachrichteninhalt für Nachrichten vom Typ "topicUpdated". |
|
Teilnehmer
|
value.content.participants | array of object |
Chatnachrichteninhalt für Nachrichten von Typen "participantAdded" oder "participantRemoved". |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Kommunikationsbezeichner. |
|
Anzeigename des Absenders
|
value.senderDisplayName | string |
Anzeigename des Absenders der Chatnachricht. Diese Eigenschaft wird verwendet, um den Namen des Absenders für Pushbenachrichtigungen aufzufüllen. |
|
Erstellt am
|
value.createdOn | string |
Zeitstempel im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), wenn die Chatnachricht auf dem Server eingetroffen ist. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Kommunikationsbezeichner. |
|
Nächster Link
|
nextLink | string |
Wenn weitere Chatnachrichten vorhanden sind, die abgerufen werden können, wird der nächste Link ausgefüllt. |
Auflisten von Chatthreads
Auflisten von Chatthreads.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Startzeit
|
startTime | string |
Startzeit im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), um Chatthreads abzurufen. |
|
|
Max. Seitengröße
|
maxPageSize | integer |
Maximale Anzahl der pro Seite zurückgegebenen Chatthreads. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Chatthreads
|
value | array of object |
Sammlung von Chatthreads. |
|
ID
|
value.id | string |
Chatthread-ID. |
|
Thema
|
value.topic | string |
Thema "Chatthread". |
|
Letzte Empfangene Nachricht am
|
value.lastMessageReceivedOn | string |
Zeitstempel im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), wenn die letzte Nachricht auf dem Server eingetroffen ist. |
|
Gelöscht am
|
value.deletedOn | string |
Zeitstempel im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), als der Chatthread gelöscht wurde. |
|
Nächster Link
|
nextLink | string |
Wenn weitere Chatthreads vorhanden sind, die abgerufen werden können, wird der nächste Link ausgefüllt. |
Chatthread erstellen
Erstellen Sie einen Chatthread.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thema "Chatthread"
|
topic | True | string |
Thema "Chatthread". |
|
Benutzer-ID
|
id | string | ||
|
Name
|
displayName | string |
Anzeigename für den Chatteilnehmer. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ID
|
chatThread.id | string |
Chatthread-ID |
|
Thema
|
chatThread.topic | string |
Thema "Chatthread" |
|
Erstellt am
|
chatThread.createdOn | date-time |
Erstellungszeit für Chats |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Kommunikationsbezeichner. |
Chatthread löschen
Löschen eines Chatthreads.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
Entfernen eines Chatthreadteilnehmers
Teilnehmer aus Chatthread entfernen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
|
Benutzer-ID
|
id | string |
Hinzufügen von Chatthreadteilnehmern
Fügen Sie Teilnehmer zum Chatthread hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
|
Benutzer-ID
|
id | string | ||
|
Anzeigename
|
displayName | string |
Anzeigename für den Chatteilnehmer. |
|
|
Uhrzeit
|
shareHistoryTime | string |
Zeit im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), aus dem der Chatverlauf geteilt wird. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Ungültige Teilnehmerliste. |
|
Ziel
|
invalidParticipants.target | string |
Ziel-ID. |
|
Code
|
invalidParticipants.code | string |
Fehlercode. |
|
Nachricht
|
invalidParticipants.message | string |
Fehlermeldung. |
Nachricht an Chatthread senden
Nachricht an Chatthread senden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
|
Content
|
content | True | string |
Nachrichteninhalt. |
|
Name
|
senderDisplayName | True | string |
Anzeigename für den Absender der Nachricht. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string |
id |
Teilnehmer des Chatthreads auflisten
Teilnehmer im Chatthread auflisten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zugriffstoken
|
Access-Token | True | string |
Benutzerzugriffstoken. |
|
Thread-ID
|
chatThreadId | True | string |
Chatthread-ID. |
|
Anzahl der zu überspringenden Teilnehmer
|
skip | string |
Überspringt Teilnehmer bis zu einer angegebenen Position als Antwort. |
|
|
Max. Teilnehmer pro Seite
|
maxPageSize | string |
Maximale Anzahl von Teilnehmern, die pro Seite zurückgegeben werden sollen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | array of object |
Chatteilnehmer. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Kommunikationsbezeichner. |
|
Name
|
value.displayName | string |
Anzeigename für den Chatteilnehmer. |
|
Uhrzeit
|
value.shareHistoryTime | string |
Zeit im RFC3339 Format (yyyy-MM-ddTHH:mm:ssZ), aus dem der Chatverlauf geteilt wird. |
|
Nächster Link
|
nextLink | string |
Wenn weitere Chatteilnehmer vorhanden sind, die abgerufen werden können, wird der nächste Link ausgefüllt. |
Definitionen
CommunicationIdentifier
Kommunikationsbezeichner.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer-ID
|
communicationUser.id | string |