Zendesk
Zendesk erstellt Software für bessere Kundenbeziehungen. Mit mehreren Produkten in seinem Portfolio bietet Zendesk eine Kundendienst- und Support-Ticketing-Plattform, die Unternehmen die Möglichkeit bietet, Kundenanrufe, E-Mails und andere technische Anfragen über eine einheitliche Schnittstelle zu verarbeiten.
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 High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - 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 High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps-Unterstützung Microsoft Power Automate-Support Microsoft Power Apps-Unterstützung |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://www.zendesk.com/ |
| Datenschutzrichtlinie | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
Bekannte Probleme und Einschränkungen
- Connector gibt nur atomische Eigenschaften der Zendesk-Entität zurück (d. h. Listen, Datensätze und andere komplexe Typen werden nicht unterstützt). Beispielsweise verfügt
tagsdie Entität über eine Eigenschaft,Ticketdie von Array auf Zendesk-Seite dargestellt wird. Zendesk Connector gibt eine Zeichenfolge für solche Felder zurück[List]. - Connector erfordert
updated_at, dass eine Spalte für jede Tabelle vorhanden ist, die mit Triggern verwendet wird. - Die Zendesk-Such-API hat eine Einschränkung für die Rückgabe von 1000 Ergebnissen pro Abfrage. Dies wirkt sich auf einige Connectoraktionen aus, die mit einem Fehler fehlschlagen würden ("Http-Anforderung fehlgeschlagen: Der Inhalt war kein gültiger JSON-Code"), wenn die Zieltabelle 1000 Datensätze oder mehr enthält:
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 |
|---|---|---|---|
| Unternehmensname | Schnur | Der Name des Unternehmens "Zendesk" ist der Unterdomänenteil Ihrer Website-URL. Z. B. https://{company}.zendesk.com | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Tabellen |
Ruft Zendesk-Tabellen von einer Website ab. |
| Artikel durchsuchen |
Gibt eine Standardanzahl von 25 Artikeln pro Seite zurück, bis zu maximal 1000 Ergebnisse. |
| Element abrufen |
Ruft ein Zendesk-Element ab |
| Element aktualisieren |
Aktualisiert ein vorhandenes Zendesk-Element |
| Element erstellen |
Erstellt ein Zendesk-Element |
| Element löschen |
Löscht ein Zendesk-Element |
| Elemente abrufen |
Ruft Zendesk-Elemente eines bestimmten Zendesk-Typs ab (Beispiel: 'Ticket') |
Abrufen von Tabellen
Artikel durchsuchen
Gibt eine Standardanzahl von 25 Artikeln pro Seite zurück, bis zu maximal 1000 Ergebnisse.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Query
|
query | True | string |
Artikel, nach dem gesucht werden soll. |
|
Gebietsschema
|
locale | string |
Das Gebietsschema, in dem das Element angezeigt wird |
|
|
Marken-ID
|
brand_id | integer |
Suchen Sie nach Artikeln in der angegebenen Marke. |
|
|
Kategorie
|
category | integer |
Beschränken Sie die Suche auf diese Kategorie-ID. |
|
|
`Section`
|
section | integer |
Beschränken der Suche auf diese Abschnitts-ID |
|
|
Bezeichnungsnamen
|
label_names | string |
Eine durch Trennzeichen getrennte Liste von Bezeichnungsnamen. |
|
|
Multibrand
|
multibrand | boolean |
Aktivieren Sie die Suche für alle Marken, wenn wahr. |
Gibt zurück
- Body
- SearchResult
Element abrufen
Ruft ein Zendesk-Element ab
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Zendesk-Elementtyp (Beispiel: 'Ticket') |
|
Elementschlüssel
|
id | True | string |
Eindeutiger Bezeichner des abzurufenden Elements |
Gibt zurück
Element aktualisieren
Aktualisiert ein vorhandenes Zendesk-Element
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Zendesk-Elementtyp (Beispiel: 'Ticket') |
|
Elementschlüssel
|
id | True | string |
Eindeutiger Bezeichner des zu aktualisierenden Elements |
|
Artikel
|
item | True | dynamic |
Zendesk-Element mit aktualisierten Werten |
Gibt zurück
Element erstellen
Erstellt ein Zendesk-Element
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Zendesk-Elementtyp (Beispiel: 'Ticket') |
|
Artikel
|
item | True | dynamic |
Zendesk-Element zum Erstellen |
Gibt zurück
Element löschen
Löscht ein Zendesk-Element
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Zendesk-Elementtyp (Beispiel: 'Ticket') |
|
Elementschlüssel
|
id | True | string |
Eindeutiger Bezeichner des zu löschenden Elements |
Elemente abrufen
Ruft Zendesk-Elemente eines bestimmten Zendesk-Typs ab (Beispiel: 'Ticket')
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Zendesk-Elementtyp (Beispiel: 'Ticket') |
|
Filterabfrage
|
$filter | string |
Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellung nach
|
$orderby | string |
Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge |
|
|
Anzahl überspringen
|
$skip | integer |
Anzahl der zu überspringenden Einträge (Standard = 0) |
|
|
Maximale Anzahl abrufen
|
$top | integer |
Maximale Anzahl abzurufender Einträge (Standard = 512) |
|
|
Abfrage auswählen
|
$select | string |
Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle). |
Gibt zurück
Auslöser
| Beim Erstellen eines Elements |
Löst einen Fluss aus, wenn ein Element in Zendesk erstellt wird |
| Wenn ein Element geändert wird |
Löst einen Fluss aus, wenn ein Element in Zendesk geändert wird |
| Wenn ein Element geändert wird |
Löst einen Fluss aus, wenn ein Element in Zendesk geändert wird |
Beim Erstellen eines Elements
Löst einen Fluss aus, wenn ein Element in Zendesk erstellt wird
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Name der Zendesk-Tabelle |
|
Filterabfrage
|
$filter | string |
Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellung nach
|
$orderby | string |
Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge |
|
|
Anzahl überspringen
|
$skip | integer |
Anzahl der zu überspringenden Einträge (Standard = 0) |
|
|
Maximale Anzahl abrufen
|
$top | integer |
Maximale Anzahl abzurufender Einträge (Standard = 512) |
Gibt zurück
Wenn ein Element geändert wird
Löst einen Fluss aus, wenn ein Element in Zendesk geändert wird
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Name der Zendesk-Tabelle |
|
Filterabfrage
|
$filter | string |
Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellung nach
|
$orderby | string |
Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge |
|
|
Anzahl überspringen
|
$skip | integer |
Anzahl der zu überspringenden Einträge (Standard = 0) |
|
|
Maximale Anzahl abrufen
|
$top | integer |
Maximale Anzahl abzurufender Einträge (Standard = 512) |
Gibt zurück
Wenn ein Element geändert wird
Löst einen Fluss aus, wenn ein Element in Zendesk geändert wird
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tabellenname
|
table | True | string |
Name der Zendesk-Tabelle |
|
Filterabfrage
|
$filter | string |
Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellung nach
|
$orderby | string |
Eine ODATA orderBy-Abfrage zum Angeben der Reihenfolge der Einträge |
|
|
Anzahl überspringen
|
$skip | integer |
Anzahl der zu überspringenden Einträge (Standard = 0) |
|
|
Maximale Anzahl abrufen
|
$top | integer |
Maximale Anzahl abzurufender Einträge (Standard = 512) |
Gibt zurück
Definitionen
Table
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Name
|
Name | string | |
|
Anzeigename
|
DisplayName | string |
SearchResult
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
results
|
results | array of object | |
|
id
|
results.id | integer |
Automatisch zugewiesene Artikel-ID |
|
URL
|
results.url | string |
Die API-URL des Artikels |
|
html_url
|
results.html_url | string |
Die URL des Artikels im Hilfecenter |
|
author_id
|
results.author_id | integer |
Autor-ID |
|
comments_disabled
|
results.comments_disabled | boolean |
True, wenn Kommentare deaktiviert sind; "false" andernfalls |
|
draft
|
results.draft | boolean |
True, wenn die Übersetzung für das aktuelle Gebietsschema ein Entwurf ist |
|
gefördert
|
results.promoted | boolean |
True, wenn dieser Artikel höhergestuft wird; andernfalls "false". false standardmäßig |
|
Position
|
results.position | integer |
Die Position dieses Artikels in der Artikelliste. 0 standardmäßig |
|
vote_sum
|
results.vote_sum | integer |
Die Summe der Upvotes (+1) und Downvotes (-1), die positiv oder negativ sein können |
|
vote_count
|
results.vote_count | integer |
Die Gesamtanzahl der Auf- und Abwärtsstimten |
|
section_id
|
results.section_id | integer |
Die ID des Abschnitts, zu dem dieser Artikel gehört |
|
erstellt_am
|
results.created_at | date-time |
Der Zeitpunkt, zu dem der Artikel erstellt wurde |
|
updated_at
|
results.updated_at | date-time |
Zeitpunkt der letzten Aktualisierung des Artikels |
|
name
|
results.name | string |
Name des Artikels |
|
title
|
results.title | string |
Der Titel des Artikels |
|
source_locale
|
results.source_locale | string |
Das Quellgebietsschema (Standardgebietsschema) des Artikels |
|
Gebietsschema
|
results.locale | string |
Das Gebietsschema, in dem der Artikel angezeigt wird |
|
überholt
|
results.outdated | boolean |
Deprecated |
|
outdated_locales
|
results.outdated_locales | array of string |
Gebietsschemas, in denen der Artikel als veraltet markiert wurde |
|
edited_at
|
results.edited_at | date-time |
Die Zeit, zu der der Artikel zuletzt in seinem angezeigten Gebietsschema bearbeitet wurde |
|
user_segment_id
|
results.user_segment_id | integer |
Die ID des Benutzersegments, das definiert, wer diesen Artikel sehen kann |
|
permission_group_id
|
results.permission_group_id | integer |
Die ID der Berechtigungsgruppe, die definiert, wer diesen Artikel bearbeiten und veröffentlichen kann |
|
content_tag_ids
|
results.content_tag_ids | array of string |
Die Liste der Inhaltstags, die an den Artikel angefügt sind |
|
label_names
|
results.label_names | array of string |
Ein Array von Bezeichnungsnamen, die diesem Artikel zugeordnet sind |
|
body
|
results.body | string |
HTML-Textkörper des Artikels |
|
Schnipsel
|
results.snippet | string |
HTML-Codeausschnitt des Artikels |
|
result_type
|
results.result_type | string |
Ergebnistyp |
TablesList
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
value
|
value | array of Table |