Zendesk
Zendesk bouwt software voor betere klantrelaties. Met meerdere producten in zijn portfolio biedt Zendesk een klantenservice- en ondersteuningsticketplatform dat bedrijven de mogelijkheid biedt om klantgesprekken, e-mails en andere technische vragen vanuit een geïntegreerde interface af te handelen.
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 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 China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - 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 High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft |
| URL |
Ondersteuning voor Microsoft LogicApps Ondersteuning voor Microsoft Power Automate Ondersteuning voor Microsoft Power Apps |
| Connector-metagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://www.zendesk.com/ |
| Privacybeleid | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
Bekende problemen en beperkingen
- Connector retourneert alleen atomische eigenschappen van Zendesk-entiteit (dat wil gezegd lijsten, records en andere complexe typen worden niet ondersteund). De entiteit heeft
tagsbijvoorbeeldTicketeigenschap die wordt vertegenwoordigd door een matrix aan de zijde van Zendesk. Zendesk-connector retourneert[List]een tekenreeks voor dergelijke velden. - De connector vereist dat
updated_ater een kolom bestaat voor elke tabel die wordt gebruikt met triggers. - Zendesk Search-API heeft een beperking voor het retourneren van 1000 resultaten per query. Dit is van invloed op sommige connectoracties, die mislukken met een fout (Http-aanvraag is mislukt: de inhoud is geen geldige JSON) als de doeltabel 1000 records of meer bevat:
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 |
|---|---|---|---|
| Bedrijfsnaam | touw | De bedrijfsnaam van Zendesk is het subdomeingedeelte van uw site-URL. Bijvoorbeeld https://{company}.zendesk.com | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Artikelen zoeken |
Retourneert een standaardaantal van 25 artikelen per pagina, maximaal 1000 resultaten. |
| Item bijwerken |
Een bestaand Zendesk-item bijwerken |
| Item maken |
Een Zendesk-item maken |
| Item ophalen |
Hiermee haalt u een Zendesk-item op |
| Item verwijderen |
Een Zendesk-item verwijderen |
| Items ophalen |
Hiermee worden Zendesk-items van een bepaald Zendesk-type opgehaald (bijvoorbeeld: 'Ticket') |
| Tabellen ophalen |
Zendesk-tabellen ophalen van een site |
Artikelen zoeken
Retourneert een standaardaantal van 25 artikelen per pagina, maximaal 1000 resultaten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Artikel om naar te zoeken. |
|
Lokatie
|
locale | string |
De landinstelling waarin het item wordt weergegeven |
|
|
Merk-id
|
brand_id | integer |
Zoek naar artikelen in het opgegeven merk. |
|
|
Categorie
|
category | integer |
Beperk de zoekopdracht tot deze categorie-id. |
|
|
Afdeling
|
section | integer |
De zoekopdracht beperken tot deze sectie-id |
|
|
Labelnamen
|
label_names | string |
Een door komma's gescheiden lijst met labelnamen. |
|
|
Multibrand
|
multibrand | boolean |
Schakel zoeken in alle merken in, indien waar. |
Retouren
- Body
- SearchResult
Item bijwerken
Een bestaand Zendesk-item bijwerken
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Zendesk-itemtype (bijvoorbeeld: Ticket) |
|
Itemsleutel
|
id | True | string |
Unieke id van het item dat moet worden bijgewerkt |
|
Onderdeel
|
item | True | dynamic |
Zendesk-item met bijgewerkte waarden |
Retouren
Item maken
Een Zendesk-item maken
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Zendesk-itemtype (bijvoorbeeld: Ticket) |
|
Onderdeel
|
item | True | dynamic |
Zendesk-item dat moet worden gemaakt |
Retouren
Item ophalen
Hiermee haalt u een Zendesk-item op
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Zendesk-itemtype (bijvoorbeeld: Ticket) |
|
Itemsleutel
|
id | True | string |
Unieke id van het item dat moet worden opgehaald |
Retouren
Item verwijderen
Een Zendesk-item verwijderen
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Zendesk-itemtype (bijvoorbeeld: Ticket) |
|
Itemsleutel
|
id | True | string |
Unieke id van het item dat moet worden verwijderd |
Items ophalen
Hiermee worden Zendesk-items van een bepaald Zendesk-type opgehaald (bijvoorbeeld: 'Ticket')
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Zendesk-itemtype (bijvoorbeeld: Ticket) |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen |
|
|
Aantal overslaan
|
$skip | integer |
Aantal items dat moet worden overgeslagen (standaard = 0) |
|
|
Maximumaantal get
|
$top | integer |
Maximum aantal items dat moet worden opgehaald (standaard = 512) |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Tabellen ophalen
Triggers
| Wanneer een item wordt gemaakt |
Hiermee wordt een stroom geactiveerd wanneer een item wordt gemaakt in Zendesk |
| Wanneer een item wordt gewijzigd |
Hiermee wordt een stroom geactiveerd wanneer een item wordt gewijzigd in Zendesk |
| Wanneer een item wordt gewijzigd |
Hiermee wordt een stroom geactiveerd wanneer een item wordt gewijzigd in Zendesk |
Wanneer een item wordt gemaakt
Hiermee wordt een stroom geactiveerd wanneer een item wordt gemaakt in Zendesk
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Naam van Zendesk-tabel |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen |
|
|
Aantal overslaan
|
$skip | integer |
Aantal items dat moet worden overgeslagen (standaard = 0) |
|
|
Maximumaantal get
|
$top | integer |
Maximum aantal items dat moet worden opgehaald (standaard = 512) |
Retouren
Wanneer een item wordt gewijzigd
Hiermee wordt een stroom geactiveerd wanneer een item wordt gewijzigd in Zendesk
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Naam van Zendesk-tabel |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen |
|
|
Aantal overslaan
|
$skip | integer |
Aantal items dat moet worden overgeslagen (standaard = 0) |
|
|
Maximumaantal get
|
$top | integer |
Maximum aantal items dat moet worden opgehaald (standaard = 512) |
Retouren
Wanneer een item wordt gewijzigd
Hiermee wordt een stroom geactiveerd wanneer een item wordt gewijzigd in Zendesk
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tabelnaam
|
table | True | string |
Naam van Zendesk-tabel |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen |
|
|
Aantal overslaan
|
$skip | integer |
Aantal items dat moet worden overgeslagen (standaard = 0) |
|
|
Maximumaantal get
|
$top | integer |
Maximum aantal items dat moet worden opgehaald (standaard = 512) |
Retouren
Definities
Table
| Name | Pad | Type | Description |
|---|---|---|---|
|
Naam
|
Name | string | |
|
Schermnaam
|
DisplayName | string |
SearchResult
| Name | Pad | Type | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
identiteitskaart
|
results.id | integer |
Automatisch toegewezen artikel-id |
|
url
|
results.url | string |
De API-URL van het artikel |
|
html_url
|
results.html_url | string |
De URL van het artikel in het Helpcentrum |
|
author_id
|
results.author_id | integer |
Auteur-id |
|
comments_disabled
|
results.comments_disabled | boolean |
Waar als opmerkingen zijn uitgeschakeld; anders onwaar |
|
draft
|
results.draft | boolean |
Waar als de vertaling voor de huidige landinstelling een concept is |
|
gepromoveerd
|
results.promoted | boolean |
Waar als dit artikel wordt gepromoveerd; anders onwaar. false standaard |
|
positie
|
results.position | integer |
De positie van dit artikel in de lijst met artikelen. Standaard 0 |
|
vote_sum
|
results.vote_sum | integer |
De som van upvotes (+1) en downvotes (-1), die mogelijk positief of negatief zijn |
|
vote_count
|
results.vote_count | integer |
Het totale aantal upvotes en downvotes |
|
section_id
|
results.section_id | integer |
De id van de sectie waartoe dit artikel behoort |
|
aangemaakt_op
|
results.created_at | date-time |
Het tijdstip waarop het artikel is gemaakt |
|
updated_at
|
results.updated_at | date-time |
Het tijdstip waarop het artikel voor het laatst is bijgewerkt |
|
naam
|
results.name | string |
Naam van artikel |
|
title
|
results.title | string |
De titel van het artikel |
|
source_locale
|
results.source_locale | string |
De bronlandinstelling (standaardinstelling) van het artikel |
|
locatie
|
results.locale | string |
De landinstelling waarin het artikel wordt weergegeven |
|
verouderd
|
results.outdated | boolean |
Deprecated |
|
outdated_locales
|
results.outdated_locales | array of string |
Landinstellingen waarin het artikel is gemarkeerd als verouderd |
|
edited_at
|
results.edited_at | date-time |
De tijd waarop het artikel voor het laatst is bewerkt in de weergegeven landinstelling |
|
user_segment_id
|
results.user_segment_id | integer |
De id van het gebruikerssegment waarmee wordt gedefinieerd wie dit artikel kan zien |
|
permission_group_id
|
results.permission_group_id | integer |
De id van de machtigingsgroep die definieert wie dit artikel kan bewerken en publiceren |
|
content_tag_ids
|
results.content_tag_ids | array of string |
De lijst met inhoudstags die aan het artikel zijn gekoppeld |
|
label_names
|
results.label_names | array of string |
Een matrix met labelnamen die aan dit artikel zijn gekoppeld |
|
body
|
results.body | string |
HTML-hoofdtekst van het artikel |
|
fragment
|
results.snippet | string |
HTML-fragment van het artikel |
|
result_type
|
results.result_type | string |
Type resultaat |
TablesList
| Name | Pad | Type | Description |
|---|---|---|---|
|
waarde
|
value | array of Table |