Chat pro komunikaci Azure
Konektor pro využití funkcí chatu v Azure Communication Services
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| acssolutions@microsoft.com |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
| Internetová stránka | https://azure.microsoft.com/services/communication-services |
| Zásady ochrany osobních údajů | https://privacy.microsoft.com |
| Kategorie | Communication |
Chat služby Azure Communication Services pomáhá přidávat textovou komunikaci v reálném čase do multiplatformních aplikací.
Požadavky
Abyste mohli pokračovat, budete potřebovat následující:
- Plán Microsoft Power Apps nebo Power Automate s funkcí vlastního konektoru
- Předplatné Azure
- Prostředek Azure Communication Services
Jak získat přihlašovací údaje
1 Nastavení prostředku Azure Communication Services
2 Ověření připojovacího řetězce
- Nové připojení můžete vytvořit pomocí adresy URL koncového bodu prostředku služby Azure Communication Services.
Začínáme s konektorem
Po nastavení prostředku Azure Communication Services vygenerujte přístupový token uživatele. Tento token použijte pro akce konektoru.
Známé problémy a omezení
V tomto okamžiku nejsou známé problémy ani omezení.
časté otázky
- Jak vygeneruji přístupový token?
- Pomocí konektoru identit služeb Azure Communication Services můžete vygenerovat novou identitu uživatele a aktualizovat přístupové tokeny pro uživatele. Můžete to také provést ručně prostřednictvím portálu pro testování.
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Adresa URL koncového bodu | securestring | Adresa URL koncového bodu služby Azure Communication Services | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Aktualizace vlastností vlákna chatu |
Aktualizujte vlastnosti vlákna chatu. |
| Odebrání účastníka vlákna chatu |
Odeberte účastníka z vlákna chatu. |
| Odeslání zprávy do vlákna chatu |
Odeslání zprávy do vlákna chatu |
| Odstranění vlákna chatu |
Odstraňte vlákno chatu. |
| Přidání účastníků vlákna chatu |
Přidejte účastníky do vlákna chatu. |
| Seznam vláken chatu |
Vypsat vlákna chatu |
| Vytvoření vlákna chatu |
Vytvořte vlákno chatu. |
| Výpis zpráv vlákna chatu |
Vypsat zprávy z vlákna chatu |
| Zobrazení seznamu účastníků vlákna chatu |
Uveďte účastníky ve vlákně chatu. |
| Získání vlastností vlákna chatu |
Získejte vlastnosti vlákna chatu. |
Aktualizace vlastností vlákna chatu
Aktualizujte vlastnosti vlákna chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
|
Téma vlákna chatu
|
topic | string |
Téma vlákna chatu |
Odebrání účastníka vlákna chatu
Odeberte účastníka z vlákna chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
|
ID uživatele
|
id | string |
Odeslání zprávy do vlákna chatu
Odeslání zprávy do vlákna chatu
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
|
Content
|
content | True | string |
Obsah zprávy. |
|
Název
|
senderDisplayName | True | string |
Zobrazované jméno odesílatele zprávy |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
identifikační číslo
|
id | string |
identifikační číslo |
Odstranění vlákna chatu
Odstraňte vlákno chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
Přidání účastníků vlákna chatu
Přidejte účastníky do vlákna chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
|
ID uživatele
|
id | string | ||
|
Zobrazovaný název
|
displayName | string |
Zobrazované jméno účastníka chatu |
|
|
Time
|
shareHistoryTime | string |
Čas ve formátu RFC3339 (rrrr-MM-ddTHH:mm:ssZ), ze kterého se sdílí historie chatu. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Neplatný seznam účastníků |
|
Target
|
invalidParticipants.target | string |
ID cíle. |
|
Code
|
invalidParticipants.code | string |
Kód chyby |
|
Message
|
invalidParticipants.message | string |
Chybová zpráva. |
Seznam vláken chatu
Vypsat vlákna chatu
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
Čas zahájení
|
startTime | string |
Počáteční čas ve formátu RFC3339 (yyyy-MM-ddTHH:mm:ssZ) pro získání vlákna chatu. |
|
|
Maximální velikost stránky
|
maxPageSize | integer |
Maximální počet vláken chatu vrácených na stránku |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Vlákna chatu
|
value | array of object |
Kolekce vláken chatu |
|
ID
|
value.id | string |
ID vlákna chatu |
|
Téma
|
value.topic | string |
Téma vlákna chatu |
|
Poslední zpráva byla přijata dne
|
value.lastMessageReceivedOn | string |
Časové razítko ve formátu RFC3339 (rrrr-MM-ddTHH:mm:ssZ) při doručení poslední zprávy na server. |
|
Odstraněno dne
|
value.deletedOn | string |
Časové razítko ve formátu RFC3339 (rrrr-MM-ddTHH:mm:ssZ) při odstranění vlákna chatu. |
|
Další odkaz
|
nextLink | string |
Pokud je možné načíst více vláken chatu, naplní se další odkaz. |
Vytvoření vlákna chatu
Vytvořte vlákno chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
Téma vlákna chatu
|
topic | True | string |
Téma vlákna chatu |
|
ID uživatele
|
id | string | ||
|
Název
|
displayName | string |
Zobrazované jméno účastníka chatu |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
chatThread.id | string |
ID vlákna chatu |
|
Téma
|
chatThread.topic | string |
Téma vlákna chatu |
|
Vytvořeno dne
|
chatThread.createdOn | date-time |
Čas vytvoření chatu |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Identifikátor komunikace. |
Výpis zpráv vlákna chatu
Vypsat zprávy z vlákna chatu
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
|
Čas zahájení
|
startTime | string |
Počáteční čas ve formátu RFC3339 (rrrr-MM-ddTHH:mm:ssZ) pro získání zpráv. |
|
|
Maximální velikost stránky
|
maxPageSize | string |
Maximální počet zpráv, které se mají vrátit na stránku. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Seznam zpráv
|
value | array of object |
Kolekce chatovacích zpráv |
|
ID
|
value.id | string |
ID zprávy chatu. Toto ID je vygenerováno serverem. |
|
Typ
|
value.type | string |
Typ zprávy chatu |
|
Version
|
value.version | string |
Verze zprávy chatu |
|
ID sekvence
|
value.sequenceId | string |
Posloupnost chatové zprávy v konverzaci |
|
zpráva
|
value.content.message | string |
Obsah zprávy chatu |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Identifikátor komunikace. |
|
Téma
|
value.content.topic | string |
Obsah zprávy chatu pro zprávy typu topicUpdated |
|
účastníci
|
value.content.participants | array of object |
Obsah zprávy chatu pro zprávy typu participantAdded nebo participantRemoved. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Identifikátor komunikace. |
|
Zobrazované jméno odesílatele
|
value.senderDisplayName | string |
Zobrazované jméno odesílatele zprávy chatu Tato vlastnost slouží k naplnění názvu odesílatele pro nabízená oznámení. |
|
Vytvořeno dne
|
value.createdOn | string |
Časové razítko ve formátu RFC3339 (yyyy-MM-ddTHH:mm:ssZ) při příchodu chatovací zprávy na server. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Identifikátor komunikace. |
|
Další odkaz
|
nextLink | string |
Pokud je možné načíst další zprávy chatu, naplní se další odkaz. |
Zobrazení seznamu účastníků vlákna chatu
Uveďte účastníky ve vlákně chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
|
Počet účastníků, kteří se mají přeskočit
|
skip | string |
Přeskočí účastníky na zadanou pozici v odpovědi. |
|
|
Maximální počet účastníků na stránku
|
maxPageSize | string |
Maximální počet účastníků, kteří se mají vrátit na stránku. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
value
|
value | array of object |
Účastníci chatu. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Identifikátor komunikace. |
|
Název
|
value.displayName | string |
Zobrazované jméno účastníka chatu |
|
Time
|
value.shareHistoryTime | string |
Čas ve formátu RFC3339 (rrrr-MM-ddTHH:mm:ssZ), ze kterého se sdílí historie chatu. |
|
Další odkaz
|
nextLink | string |
Pokud je možné načíst další účastníky chatu, naplní se další odkaz. |
Získání vlastností vlákna chatu
Získejte vlastnosti vlákna chatu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Token přístupu
|
Access-Token | True | string |
Přístupový token uživatele. |
|
ID vlákna
|
chatThreadId | True | string |
ID vlákna chatu |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID vlákna chatu |
|
Téma
|
topic | string |
Téma vlákna chatu |
|
Vytvořeno dne
|
createdOn | string |
Čas vytvoření vlákna |
|
Odstraněno dne
|
deletedOn | string |
Čas odstranění vlákna |
|
Nezpracované ID
|
createdByCommunicationIdentifier.rawId | string |
Nezpracované ID identifikátoru. |
|
ID
|
createdByCommunicationIdentifier.communicationUser.id | string |
ID komunikačního uživatele. |
Definice
CommunicationIdentifier
Identifikátor komunikace.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID uživatele
|
communicationUser.id | string |