Azure Communication Chat
Connector voor het gebruik van chatfuncties van Azure Communication Services.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| E-mailen | acssolutions@microsoft.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://azure.microsoft.com/services/communication-services |
| Privacybeleid | https://privacy.microsoft.com |
| Categorieën | Communication |
Met Azure Communication Services Chat kunt u realtime tekstcommunicatie toevoegen aan platformoverschrijdende toepassingen.
Vereiste voorwaarden
U hebt het volgende nodig om door te gaan:
- Een Microsoft Power Apps- of Power Automate-abonnement met aangepaste connectorfunctie
- Een Azure-abonnement
- Een Azure Communication Services-resource
Referenties ophalen
1 Een Azure Communication Services-resource instellen
2 Verificatie van verbindingsreeks
- U kunt een nieuwe verbinding maken met behulp van een Azure Communication Services-resource-eindpunt-URL.
Aan de slag met uw connector
Nadat u een Azure Communication Services-resource hebt ingesteld, genereert u een toegangstoken voor gebruikers. Gebruik dit token voor de connectoracties.
Bekende problemen en beperkingen
Er zijn op dit moment geen bekende problemen of beperkingen.
Veelgestelde vragen
- Hoe genereer ik een toegangstoken?
- U kunt de Azure Communication Services Identity Connector gebruiken om een nieuwe gebruikersidentiteit te genereren en toegangstokens voor een gebruiker te vernieuwen. U kunt dit ook handmatig doen via de portal voor testen.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Eindpunt-URL | beveiligde string | Azure Communication Services-eindpunt-URL. | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Bericht verzenden naar chatthread |
Bericht verzenden naar chatthread. |
| Chatthread maken |
Een chatgesprek maken. |
| Chatthread verwijderen |
Een chatthread verwijderen. |
| Chatthreadberichten weergeven |
Berichten uit chat-thread weergeven. |
| Chatthreads vermelden |
Chatthreads weergeven. |
| Deelnemer aan chatthread verwijderen |
Deelnemer verwijderen uit chatthread. |
| Deelnemers aan chatthread toevoegen |
Deelnemers toevoegen aan chatthread. |
| Deelnemers aan chatthread vermelden |
Deelnemers weergeven in een chatgesprek. |
| Eigenschappen van chatthread bijwerken |
Werk de eigenschappen van de chatthread bij. |
| Eigenschappen van chatthread ophalen |
Haal de eigenschappen van de chatthread op. |
Bericht verzenden naar chatthread
Bericht verzenden naar chatthread.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
|
Content
|
content | True | string |
Berichtinhoud. |
|
Naam
|
senderDisplayName | True | string |
Weergavenaam voor de afzender van het bericht. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | string |
identiteitskaart |
Chatthread maken
Een chatgesprek maken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Onderwerp chatthread
|
topic | True | string |
Chatthread-onderwerp. |
|
Gebruikers-ID
|
id | string | ||
|
Naam
|
displayName | string |
Weergavenaam voor de chatdeelnemer. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
chatThread.id | string |
Chatthread-id |
|
Onderwerp
|
chatThread.topic | string |
Onderwerp chatthread |
|
Gemaakt op
|
chatThread.createdOn | date-time |
Tijd voor het maken van chats |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
Communicatie-id. |
Chatthread verwijderen
Een chatthread verwijderen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
Chatthreadberichten weergeven
Berichten uit chat-thread weergeven.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
|
Begintijd
|
startTime | string |
Begintijd in RFC3339 indeling (jjjj-MM-ddTHH:mm:ssZ) om berichten op te halen. |
|
|
Max. paginaformaat
|
maxPageSize | string |
Maximum aantal berichten dat per pagina moet worden geretourneerd. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Berichtenlijst
|
value | array of object |
Verzameling chatberichten. |
|
ID-kaart
|
value.id | string |
Id van het chatbericht. Deze id wordt gegenereerd door de server. |
|
Typologie
|
value.type | string |
Type chatbericht. |
|
Versie
|
value.version | string |
Versie van het chatbericht. |
|
Reeks-id
|
value.sequenceId | string |
Volgorde van het chatbericht in het gesprek. |
|
message
|
value.content.message | string |
Inhoud van chatberichten. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
Communicatie-id. |
|
Onderwerp
|
value.content.topic | string |
Chatberichtinhoud voor berichten van het type topicUpdated. |
|
Deelnemers
|
value.content.participants | array of object |
Chatberichtinhoud voor berichten van het type participantAdded of participantRemoved. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
Communicatie-id. |
|
Weergavenaam van afzender
|
value.senderDisplayName | string |
Weergavenaam van de afzender van het chatbericht. Deze eigenschap wordt gebruikt om de naam van de afzender in te vullen voor pushmeldingen. |
|
Gemaakt op
|
value.createdOn | string |
Tijdstempel in RFC3339 indeling (jjjj-MM-ddTHH:mm:ssZ) toen het chatbericht op de server aankwam. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
Communicatie-id. |
|
Volgende koppeling
|
nextLink | string |
Als er meer chatberichten kunnen worden opgehaald, wordt de volgende koppeling ingevuld. |
Chatthreads vermelden
Chatthreads weergeven.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Begintijd
|
startTime | string |
Begintijd in RFC3339 indeling (jjjj-MM-ddTHH:mm:ssZ) om chatthreads op te halen. |
|
|
Max. paginaformaat
|
maxPageSize | integer |
Maximum aantal chatthreads dat per pagina wordt geretourneerd. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Chatthreads
|
value | array of object |
Verzameling chatthreads. |
|
ID-kaart
|
value.id | string |
Chatthread-id. |
|
Onderwerp
|
value.topic | string |
Chatthread-onderwerp. |
|
laatste bericht ontvangen op
|
value.lastMessageReceivedOn | string |
Tijdstempel in RFC3339 indeling (jjjj-MM-ddTHH:mm:ssZ) toen het laatste bericht op de server aankwam. |
|
Verwijderd op
|
value.deletedOn | string |
Tijdstempel in RFC3339 indeling (jjjj-MM-ddTHH:mm:ssZ) toen de chatthread werd verwijderd. |
|
Volgende koppeling
|
nextLink | string |
Als er meer chatthreads zijn die kunnen worden opgehaald, wordt de volgende koppeling ingevuld. |
Deelnemer aan chatthread verwijderen
Deelnemer verwijderen uit chatthread.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
|
Gebruikers-ID
|
id | string |
Deelnemers aan chatthread toevoegen
Deelnemers toevoegen aan chatthread.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
|
Gebruikers-ID
|
id | string | ||
|
Weergavenaam
|
displayName | string |
Weergavenaam voor de chatdeelnemer. |
|
|
Time
|
shareHistoryTime | string |
Tijd in RFC3339 notatie (jjjj-MM-ddTHH:mm:ssZ) waaruit de chatgeschiedenis wordt gedeeld. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
Lijst met ongeldige deelnemers. |
|
Doel
|
invalidParticipants.target | string |
Doel-id. |
|
Code
|
invalidParticipants.code | string |
Foutcode. |
|
Message
|
invalidParticipants.message | string |
Foutmelding. |
Deelnemers aan chatthread vermelden
Deelnemers weergeven in een chatgesprek.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
|
Aantal deelnemers dat moet worden overgeslagen
|
skip | string |
Hiermee worden deelnemers naar een opgegeven positie in antwoord overgeslagen. |
|
|
Maximum aantal deelnemers per pagina
|
maxPageSize | string |
Maximum aantal deelnemers dat per pagina moet worden geretourneerd. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
waarde
|
value | array of object |
Chatdeelnemers. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
Communicatie-id. |
|
Naam
|
value.displayName | string |
Weergavenaam voor de chatdeelnemer. |
|
Time
|
value.shareHistoryTime | string |
Tijd in RFC3339 notatie (jjjj-MM-ddTHH:mm:ssZ) waaruit de chatgeschiedenis wordt gedeeld. |
|
Volgende koppeling
|
nextLink | string |
Als er meer chatdeelnemers zijn die kunnen worden opgehaald, wordt de volgende koppeling ingevuld. |
Eigenschappen van chatthread bijwerken
Werk de eigenschappen van de chatthread bij.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
|
Onderwerp chatthread
|
topic | string |
Chatthread-onderwerp. |
Eigenschappen van chatthread ophalen
Haal de eigenschappen van de chatthread op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Toegangstoken
|
Access-Token | True | string |
Token voor gebruikerstoegang. |
|
Thread-id
|
chatThreadId | True | string |
Chatthread-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | string |
Chatthread-id. |
|
Onderwerp
|
topic | string |
Chatthread-onderwerp. |
|
Gemaakt op
|
createdOn | string |
Tijdstip waarop de thread is gemaakt. |
|
Verwijderd op
|
deletedOn | string |
Tijdstip waarop de thread is verwijderd. |
|
Onbewerkte id
|
createdByCommunicationIdentifier.rawId | string |
Onbewerkte id van de id. |
|
ID-kaart
|
createdByCommunicationIdentifier.communicationUser.id | string |
Id van de communicatiegebruiker. |
Definities
CommunicationIdentifier
Communicatie-id.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gebruikers-ID
|
communicationUser.id | string |