Czat komunikacji platformy Azure
Łącznik do korzystania z funkcji czatu usług Azure Communication Services.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL | https://azure.microsoft.com/services/communication-services |
| acssolutions@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://azure.microsoft.com/services/communication-services |
| Zasady ochrony prywatności | https://privacy.microsoft.com |
| Kategorie | Communication |
Czat usług Azure Communication Services pomaga w dodawaniu komunikacji tekstowej w czasie rzeczywistym do aplikacji międzyplatformowych.
Wymagania wstępne
Aby kontynuować, musisz wykonać następujące czynności:
- Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
- Subskrypcja platformy Azure
- Zasób usług Azure Communication Services
Jak uzyskać poświadczenia
1 Konfigurowanie zasobu usług Azure Communication Services
2 Uwierzytelnianie parametrów połączenia
- Nowe połączenie można utworzyć przy użyciu adresu URL punktu końcowego zasobów usług Azure Communication Services.
Wprowadzenie do łącznika
Po skonfigurowaniu zasobu usług Azure Communication Services wygeneruj token dostępu użytkownika. Użyj tego tokenu dla akcji łącznika.
Znane problemy i ograniczenia
W tym momencie nie ma znanych problemów ani ograniczeń.
Często zadawane pytania
- Jak wygenerować token dostępu?
- Łącznik tożsamości usług Azure Communication Services umożliwia generowanie nowej tożsamości użytkownika, a także odświeżanie tokenów dostępu dla użytkownika. Można to również zrobić ręcznie za pośrednictwem portalu na potrzeby testowania.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Adres URL punktu końcowego | securestring | Adres URL punktu końcowego usług Azure Communication Services. | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie właściwości wątku czatu |
Zaktualizuj właściwości wątku czatu. |
| Dodawanie uczestników wątku czatu |
Dodaj uczestników do wątku czatu. |
| Lista uczestników czatu |
Wyświetl listę uczestników wątku czatu. |
| Pobieranie właściwości wątku czatu |
Pobierz właściwości wątku czatu. |
| Tworzenie wątku czatu |
Utwórz wątek czatu. |
| Usuwanie uczestnika wątku czatu |
Usuń uczestnika z wątku czatu. |
| Usuń wątek czatu |
Usuń wątek czatu. |
| Wysyłanie wiadomości do wątku czatu |
Wyślij wiadomość do wątku czatu. |
| Wyświetlanie listy wiadomości wątku czatu |
Wyświetl listę wiadomości z wątku czatu. |
| Wyświetlanie listy wątków czatu |
Wyświetl wątki czatu. |
Aktualizowanie właściwości wątku czatu
Zaktualizuj właściwości wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
|
Temat wątku czatu
|
topic | string |
Temat wątku czatu. |
Dodawanie uczestników wątku czatu
Dodaj uczestników do wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
|
Identyfikator użytkownika
|
id | string | ||
|
Wyświetlana nazwa
|
displayName | string |
Nazwa wyświetlana uczestnika czatu. |
|
|
Time
|
shareHistoryTime | string |
Czas w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ), z którego jest udostępniana historia czatów. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Nieprawidłowa lista uczestników. |
|
Target
|
invalidParticipants.target | string |
Identyfikator docelowy. |
|
Code
|
invalidParticipants.code | string |
Kod błędu. |
|
Message
|
invalidParticipants.message | string |
Komunikat o błędzie. |
Lista uczestników czatu
Wyświetl listę uczestników wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
|
Liczba uczestników do pominięcia
|
skip | string |
Pomija uczestników do określonej pozycji w odpowiedzi. |
|
|
Maksymalna liczba uczestników na stronę
|
maxPageSize | string |
Maksymalna liczba uczestników do zwrócenia na stronę. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
value
|
value | array of object |
Uczestnicy czatu. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Identyfikator komunikacji. |
|
Name
|
value.displayName | string |
Nazwa wyświetlana uczestnika czatu. |
|
Time
|
value.shareHistoryTime | string |
Czas w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ), z którego jest udostępniana historia czatów. |
|
Następny link
|
nextLink | string |
Jeśli będzie można pobrać więcej uczestników czatu, zostanie wypełniony następny link. |
Pobieranie właściwości wątku czatu
Pobierz właściwości wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | string |
Identyfikator wątku czatu. |
|
Temat
|
topic | string |
Temat wątku czatu. |
|
Utworzono
|
createdOn | string |
Godzina utworzenia wątku. |
|
Usunięto
|
deletedOn | string |
Czas usunięcia wątku. |
|
Nieprzetworzone identyfikatory
|
createdByCommunicationIdentifier.rawId | string |
Nieprzetworzone identyfikatora. |
|
identyfikator
|
createdByCommunicationIdentifier.communicationUser.id | string |
Identyfikator użytkownika komunikacji. |
Tworzenie wątku czatu
Utwórz wątek czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Temat wątku czatu
|
topic | True | string |
Temat wątku czatu. |
|
Identyfikator użytkownika
|
id | string | ||
|
Name
|
displayName | string |
Nazwa wyświetlana uczestnika czatu. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
chatThread.id | string |
Identyfikator wątku czatu |
|
Temat
|
chatThread.topic | string |
Temat wątku czatu |
|
Utworzono
|
chatThread.createdOn | date-time |
Czas tworzenia czatu |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Identyfikator komunikacji. |
Usuwanie uczestnika wątku czatu
Usuń uczestnika z wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
|
Identyfikator użytkownika
|
id | string |
Usuń wątek czatu
Usuń wątek czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
Wysyłanie wiadomości do wątku czatu
Wyślij wiadomość do wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
|
Content
|
content | True | string |
Zawartość komunikatu. |
|
Name
|
senderDisplayName | True | string |
Nazwa wyświetlana nadawcy wiadomości. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
id |
Wyświetlanie listy wiadomości wątku czatu
Wyświetl listę wiadomości z wątku czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Identyfikator wątku
|
chatThreadId | True | string |
Identyfikator wątku czatu. |
|
Godzina rozpoczęcia
|
startTime | string |
Czas rozpoczęcia w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ) w celu pobrania komunikatów. |
|
|
Maksymalny rozmiar strony
|
maxPageSize | string |
Maksymalna liczba komunikatów do zwrócenia na stronę. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Lista wiadomości
|
value | array of object |
Kolekcja wiadomości czatu. |
|
identyfikator
|
value.id | string |
Identyfikator wiadomości czatu. Ten identyfikator jest generowany przez serwer. |
|
Typ
|
value.type | string |
Typ wiadomości czatu. |
|
wersja
|
value.version | string |
Wersja wiadomości czatu. |
|
Identyfikator sekwencji
|
value.sequenceId | string |
Sekwencja wiadomości czatu w konwersacji. |
|
komunikat
|
value.content.message | string |
Zawartość wiadomości czatu. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Identyfikator komunikacji. |
|
Temat
|
value.content.topic | string |
Zawartość wiadomości czatu dla wiadomości o typie topicUpdated. |
|
Uczestnicy
|
value.content.participants | array of object |
Zawartość wiadomości czatu dla wiadomości o typach uczestnikówDodaj lub uczestnikRemoved. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Identyfikator komunikacji. |
|
Nazwa wyświetlana nadawcy
|
value.senderDisplayName | string |
Nazwa wyświetlana nadawcy wiadomości czatu. Ta właściwość służy do wypełniania nazwy nadawcy dla powiadomień wypychanych. |
|
Utworzono
|
value.createdOn | string |
Sygnatura czasowa w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ), gdy wiadomość czatu dotarła na serwer. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Identyfikator komunikacji. |
|
Następny link
|
nextLink | string |
Jeśli istnieje więcej wiadomości na czacie, które można pobrać, zostanie wypełniony następny link. |
Wyświetlanie listy wątków czatu
Wyświetl wątki czatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Token dostępu
|
Access-Token | True | string |
Token dostępu użytkownika. |
|
Godzina rozpoczęcia
|
startTime | string |
Czas rozpoczęcia w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ), aby pobrać wątki rozmów. |
|
|
Maksymalny rozmiar strony
|
maxPageSize | integer |
Maksymalna liczba wątków czatu zwracanych na stronę. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wątki rozmów
|
value | array of object |
Kolekcja wątków czatu. |
|
identyfikator
|
value.id | string |
Identyfikator wątku czatu. |
|
Temat
|
value.topic | string |
Temat wątku czatu. |
|
ostatnia wiadomość odebrana
|
value.lastMessageReceivedOn | string |
Sygnatura czasowa w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ), gdy ostatni komunikat dotarł do serwera. |
|
Usunięto
|
value.deletedOn | string |
Sygnatura czasowa w formacie RFC3339 (rrrr-MM-ddTHH:mm:ssZ), gdy wątek czatu został usunięty. |
|
Następny link
|
nextLink | string |
Jeśli istnieje więcej wątków czatu, które można pobrać, zostanie wypełniony następny link. |
Definicje
CommunicationIdentifier
Identyfikator komunikacji.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator użytkownika
|
communicationUser.id | string |