Zendesk

Zendesk vytváří software pro lepší vztahy se zákazníky. S několika produkty v portfoliu poskytuje Zendesk zákaznickou službu a platformu lístků podpory, která firmám umožňuje zpracovávat hovory zákazníků, e-maily a další technické dotazy z jednotného rozhraní.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate kromě následujících:
     – 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:
     – Azure oblasti Čína
     - 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 High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Microsoft
URL Podpora Microsoft LogicApps
podpora Microsoft Power Automate
Podpora Power Apps Microsoft
Metadata konektoru
Vydavatel Microsoft
Internetová stránka https://www.zendesk.com/
Zásady ochrany osobních údajů https://www.zendesk.com/company/customers-partners/privacy-policy/

Známé problémy a omezení

  1. Konektor vrací pouze atomické vlastnosti entity Zendesku (tj. seznamy, záznamy a další komplexní typy nejsou podporovány). Například Ticket entita má tags vlastnost reprezentovanou polem na straně Zendesku. Konektor Zendesk vrátí [List] řetězec pro taková pole.
  2. Konektor vyžaduje updated_at , aby existoval sloupec pro libovolnou tabulku, která se používá s triggery.
  3. Rozhraní API služby Zendesk Search má omezení pro vrácení 1 000 výsledků na dotaz. To má vliv na některé akce konektoru, které by selhaly s chybou (Požadavek HTTP selhal: obsah nebyl platný JSON), pokud cílová tabulka obsahuje 1 000 záznamů nebo více:
  4. Trigger Při změně položky se může aktivovat při vytvoření nového lístku. Vzhledem k tomu, že Zendesk aktualizuje lístek během vytváření, může se trigger změněného lístku aktivovat krátce po triggeru Při vytvoření položky pro stejný lístek.

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é
Název společnosti řetězec Název společnosti Zendesk je subdoménou, která je součástí adresy URL webu. Například https://{company}.zendesk.com Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizovat položku

Aktualizuje existující položku Zendesku.
Odstranit položku

Odstraní položku Zendesku.
Vytvořit položku

Vytvoří položku Zendesku.
Získat položku

Načte položku Zendesku.
Získání položek

Načte položky Zendesku určitého typu Zendesku (příklad: Ticket).
Získání tabulek

Načte tabulky Zendesku z webu.
Články hledání

Vrátí výchozí počet 25 článků na stránku, maximálně 1 000 výsledků.

Aktualizovat položku

ID operace:
PatchItem

Aktualizuje existující položku Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Typ položky Zendesku (příklad: Ticket)
Klíč položky
 id True string

Jedinečný identifikátor položky, která se má aktualizovat
Položka
 item True dynamic

Položka Zendesku s aktualizovanými hodnotami

Návraty

Výstupy této operace jsou dynamické.

Odstranit položku

ID operace:
DeleteItem

Odstraní položku Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Typ položky Zendesku (příklad: Ticket)
Klíč položky
 id True string

Jedinečný identifikátor položky k odstranění

Vytvořit položku

ID operace:
PostItem

Vytvoří položku Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Typ položky Zendesku (příklad: Ticket)
Položka
 item True dynamic

Položka Zendesku pro vytvoření

Návraty

Výstupy této operace jsou dynamické.

Získat položku

ID operace:
GetItem

Načte položku Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Typ položky Zendesku (příklad: Ticket)
Klíč položky
 id True string

Jedinečný identifikátor položky, která se má načíst

Návraty

Výstupy této operace jsou dynamické.

Získání položek

ID operace:
GetItems

Načte položky Zendesku určitého typu Zendesku (příklad: Ticket).

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Typ položky Zendesku (příklad: Ticket)
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle
 $orderby string

Dotaz ODATA orderBy pro zadání pořadí položek
Přeskočit počet
 $skip integer

Počet položek, které se mají přeskočit (výchozí hodnota = 0)
Maximální počet získání
 $top integer

Maximální počet položek k načtení (výchozí hodnota = 512)
Výběr dotazu
 $select string

Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání tabulek

ID operace:
GetTables

Načte tabulky Zendesku z webu.

Návraty

Body
TablesList

Články hledání

ID operace:
SearchArticles

Vrátí výchozí počet 25 článků na stránku, maximálně 1 000 výsledků.

Parametry

Name Klíč Vyžadováno Typ Description
Query
 query True string

Článek, který chcete vyhledat.
Locale
 locale string

Národní prostředí, ve kterém se položka zobrazuje
ID značky
 brand_id integer

Vyhledejte články v zadané značce.
Kategorie
 category integer

Omezit vyhledávání na toto ID kategorie.
Oddíl
 section integer

Omezit vyhledávání na toto ID oddílu
Názvy popisků
 label_names string

Seznam názvů popisků oddělený čárkami.
Multibrand
 multibrand boolean

Povolte vyhledávání napříč všemi značkami, pokud je true.

Návraty

Body
SearchResult

Aktivační události

Při vytvoření položky

Aktivuje tok při vytvoření položky v Zendesku.
Při změně položky

Aktivuje tok při změně položky v Zendesku.
Při změně položky

Aktivuje tok při změně položky v Zendesku.

Při vytvoření položky

ID operace:
GetOnNewItems

Aktivuje tok při vytvoření položky v Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky Zendesk
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle
 $orderby string

Dotaz ODATA orderBy pro zadání pořadí položek
Přeskočit počet
 $skip integer

Počet položek, které se mají přeskočit (výchozí hodnota = 0)
Maximální počet získání
 $top integer

Maximální počet položek k načtení (výchozí hodnota = 512)

Návraty

Výstupy této operace jsou dynamické.

Při změně položky

ID operace:
GetOnUpdatedItemsV2

Aktivuje tok při změně položky v Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky Zendesk
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle
 $orderby string

Dotaz ODATA orderBy pro zadání pořadí položek
Přeskočit počet
 $skip integer

Počet položek, které se mají přeskočit (výchozí hodnota = 0)
Maximální počet získání
 $top integer

Maximální počet položek k načtení (výchozí hodnota = 512)

Návraty

Výstupy této operace jsou dynamické.

Při změně položky

ID operace:
GetOnUpdatedItems

Aktivuje tok při změně položky v Zendesku.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky Zendesk
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle
 $orderby string

Dotaz ODATA orderBy pro zadání pořadí položek
Přeskočit počet
 $skip integer

Počet položek, které se mají přeskočit (výchozí hodnota = 0)
Maximální počet získání
 $top integer

Maximální počet položek k načtení (výchozí hodnota = 512)

Návraty

Výstupy této operace jsou dynamické.

Definice

Table

Name Cesta Typ Description
Název
 Name string
ZobrazovanéJméno
 DisplayName string

SearchResult

Name Cesta Typ Description
results
 results array of object
identifikační číslo
 results.id integer

ID automaticky přiřazeného článku
adresa URL
 results.url string

Adresa URL rozhraní API článku
html_url
 results.html_url string

Adresa URL článku v Centru nápovědy
author_id
 results.author_id integer

ID autora
comments_disabled
 results.comments_disabled boolean

True pokud jsou komentáře zakázány; false otherwise
koncept
 results.draft boolean

Hodnota True, pokud je překlad pro aktuální národní prostředí koncept
povýšený
 results.promoted boolean

True, pokud je tento článek povýšen; jinak nepravda. false ve výchozím nastavení
postavení
 results.position integer

Pozice tohoto článku v seznamu článků. Výchozí hodnota 0
vote_sum
 results.vote_sum integer

Součet nahoru (+1) a dolů (-1), který může být kladný nebo záporný
vote_count
 results.vote_count integer

Celkový počet nahoru a dolů
section_id
 results.section_id integer

ID oddílu, do kterého tento článek patří
datum_vytvoření
 results.created_at date-time

Čas vytvoření článku
updated_at
 results.updated_at date-time

Čas poslední aktualizace článku
název
 results.name string

Název článku
title
 results.title string

Název článku
source_locale
 results.source_locale string

Zdrojové (výchozí) národní prostředí článku
národní prostředí
 results.locale string

Národní prostředí, ve kterém se článek zobrazuje
zastaralý
 results.outdated boolean

Deprecated
outdated_locales
 results.outdated_locales array of string

Národní prostředí, ve kterých byl článek označený jako zastaralý
edited_at
 results.edited_at date-time

Čas poslední úpravy článku v zobrazeném národním prostředí
user_segment_id
 results.user_segment_id integer

ID segmentu uživatele, který definuje, kdo může vidět tento článek
permission_group_id
 results.permission_group_id integer

ID skupiny oprávnění, která definuje, kdo může tento článek upravovat a publikovat
content_tag_ids
 results.content_tag_ids array of string

Seznam značek obsahu připojených k článku
label_names
 results.label_names array of string

Pole názvů popisků přidružených k tomuto článku
body
 results.body string

Text HTML článku
fragment
 results.snippet string

Fragment kódu HTML článku
result_type
 results.result_type string

Typ výsledku

TablesList

Name Cesta Typ Description
value
 value array of Table