Dela via

Zendesk

Zendesk skapar programvara för bättre kundrelationer. Med flera produkter i sin portfölj tillhandahåller Zendesk en kundtjänst- och supportplattform som ger företag möjlighet att hantera kundsamtal, e-postmeddelanden och andra tekniska frågor från ett enhetligt gränssnitt.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Premie Alla Power Automate regioner förutom följande:
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     - Azure kinaregioner
     - US Department of Defense (DoD)
Power Apps Premie Alla Power Apps regioner förutom följande:
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Premie Alla Power Automate regioner förutom följande:
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Namn Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Metadata för anslutningsprogram
Utgivare Microsoft
Webbplats https://www.zendesk.com/
Sekretesspolicy https://www.zendesk.com/company/customers-partners/privacy-policy/

Kända problem och begränsningar

  1. Anslutningsappen returnerar endast atomiska egenskaper för Zendesk-entitet (dvs. listor, poster och andra komplexa typer stöds inte). Entiteten har Ticket till exempel tags en egenskap som representeras av matrisen på Zendesks sida. Zendesk-anslutningsappen returnerar [List] sträng för sådana fält.
  2. Anslutningsprogrammet kräver updated_at att kolumnen finns för alla tabeller som används med utlösare.
  3. Zendesk Search-API:et har en begränsning för att returnera 1 000 resultat per fråga. Detta påverkar vissa anslutningsåtgärder som skulle misslyckas med ett fel ("Http-begäran misslyckades: innehållet var inte en giltig JSON") om måltabellen innehåller 1 000 poster eller mer:
  4. Utlösaren När ett objekt ändras kan utlösas när ett nytt ärende skapas. Eftersom Zendesk uppdaterar biljetten när den skapas kan utlösaren för den ändrade biljetten utlösas kort efter utlösaren När ett objekt har skapats för samma ärende.

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:
Standardinställning Parametrar för att skapa anslutning. Alla regioner Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn Typ Description Krävs
Företagsnamn snöre Zendesk-företagsnamnet är underdomändelen av webbplats-URL:en. T.ex. https://{company}.zendesk.com Sann

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 100 60 sekunder

Åtgärder

Hämta objekt

Hämtar ett Zendesk-objekt
Hämta objekt

Hämtar Zendesk-objekt av en viss Zendesk-typ (exempel: "Biljett")
Hämta tabeller

Hämtar Zendesk-tabeller från en webbplats
Skapa objekt

Skapar ett Zendesk-objekt
Sök efter artiklar

Returnerar ett standardnummer på 25 artiklar per sida, upp till högst 1 000 resultat.
Ta bort objekt

Tar bort ett Zendesk-objekt
Uppdatera objekt

Uppdaterar ett befintligt Zendesk-objekt

Hämta objekt

Åtgärds-ID:
GetItem

Hämtar ett Zendesk-objekt

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Zendesk-objekttyp (exempel: "Biljett")
Objektnyckel
 id True string

Unik identifierare för objektet som ska hämtas

Returer

Utdata för den här åtgärden är dynamiska.

Hämta objekt

Åtgärds-ID:
GetItems

Hämtar Zendesk-objekt av en viss Zendesk-typ (exempel: "Biljett")

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Zendesk-objekttyp (exempel: "Biljett")
Filtrera fråga
 $filter string

En ODATA-filterfråga för att begränsa de returnerade posterna (t.ex. stringColumn eq 'string' OR numberColumn lt 123).
Sortera efter
 $orderby string

En ODATA-orderAv-fråga för att ange ordningen på poster
Hoppa över antal
 $skip integer

Antal poster att hoppa över (standard = 0)
Maximalt antal hämtar
 $top integer

Maximalt antal poster som ska hämtas (standard = 512)
Välj fråga
 $select string

Specifika fält som ska hämtas från poster (standard = alla).

Returer

Utdata för den här åtgärden är dynamiska.

Hämta tabeller

Åtgärds-ID:
GetTables

Hämtar Zendesk-tabeller från en webbplats

Returer

Body
TablesList

Skapa objekt

Åtgärds-ID:
PostItem

Skapar ett Zendesk-objekt

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Zendesk-objekttyp (exempel: "Biljett")
Objekt
 item True dynamic

Zendesk-objekt att skapa

Returer

Utdata för den här åtgärden är dynamiska.

Sök efter artiklar

Åtgärds-ID:
SearchArticles

Returnerar ett standardnummer på 25 artiklar per sida, upp till högst 1 000 resultat.

Parametrar

Name Nyckel Obligatorisk Typ Description
Query
 query True string

Artikel att söka efter.
Lokal
 locale string

Språkvarianten som objektet visas i
Varumärkes-ID
 brand_id integer

Sök efter artiklar i det angivna varumärket.
Kategori
 category integer

Begränsa sökningen till det här kategori-ID:t.
Section
 section integer

Begränsa sökningen till det här avsnitts-ID:t
Etikettnamn
 label_names string

En kommaavgränsad lista med etikettnamn.
Multibrand
 multibrand boolean

Aktivera sökning över alla varumärken om det är sant.

Returer

Body
SearchResult

Ta bort objekt

Åtgärds-ID:
DeleteItem

Tar bort ett Zendesk-objekt

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Zendesk-objekttyp (exempel: "Biljett")
Objektnyckel
 id True string

Unik identifierare för objektet som ska tas bort

Uppdatera objekt

Åtgärds-ID:
PatchItem

Uppdaterar ett befintligt Zendesk-objekt

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Zendesk-objekttyp (exempel: "Biljett")
Objektnyckel
 id True string

Unik identifierare för objektet som ska uppdateras
Objekt
 item True dynamic

Zendesk-objekt med uppdaterade värden

Returer

Utdata för den här åtgärden är dynamiska.

Utlösare

När ett objekt skapas

Utlöser ett flöde när ett objekt skapas i Zendesk
När ett objekt ändras

Utlöser ett flöde när ett objekt ändras i Zendesk
När ett objekt ändras

Utlöser ett flöde när ett objekt ändras i Zendesk

När ett objekt skapas

Åtgärds-ID:
GetOnNewItems

Utlöser ett flöde när ett objekt skapas i Zendesk

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på Zendesk-tabell
Filtrera fråga
 $filter string

En ODATA-filterfråga för att begränsa de returnerade posterna (t.ex. stringColumn eq 'string' OR numberColumn lt 123).
Sortera efter
 $orderby string

En ODATA-orderAv-fråga för att ange ordningen på poster
Hoppa över antal
 $skip integer

Antal poster att hoppa över (standard = 0)
Maximalt antal hämtar
 $top integer

Maximalt antal poster som ska hämtas (standard = 512)

Returer

Utdata för den här åtgärden är dynamiska.

När ett objekt ändras

Åtgärds-ID:
GetOnUpdatedItemsV2

Utlöser ett flöde när ett objekt ändras i Zendesk

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på Zendesk-tabell
Filtrera fråga
 $filter string

En ODATA-filterfråga för att begränsa de returnerade posterna (t.ex. stringColumn eq 'string' OR numberColumn lt 123).
Sortera efter
 $orderby string

En ODATA-orderAv-fråga för att ange ordningen på poster
Hoppa över antal
 $skip integer

Antal poster att hoppa över (standard = 0)
Maximalt antal hämtar
 $top integer

Maximalt antal poster som ska hämtas (standard = 512)

Returer

Utdata för den här åtgärden är dynamiska.

När ett objekt ändras

Åtgärds-ID:
GetOnUpdatedItems

Utlöser ett flöde när ett objekt ändras i Zendesk

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på Zendesk-tabell
Filtrera fråga
 $filter string

En ODATA-filterfråga för att begränsa de returnerade posterna (t.ex. stringColumn eq 'string' OR numberColumn lt 123).
Sortera efter
 $orderby string

En ODATA-orderAv-fråga för att ange ordningen på poster
Hoppa över antal
 $skip integer

Antal poster att hoppa över (standard = 0)
Maximalt antal hämtar
 $top integer

Maximalt antal poster som ska hämtas (standard = 512)

Returer

Utdata för den här åtgärden är dynamiska.

Definitioner

Tabell

Name Sökväg Typ Description
Namn
 Name string
visningsnamn
 DisplayName string

SearchResult

Name Sökväg Typ Description
results
 results array of object
Id-nummer
 results.id integer

Automatiskt tilldelat artikel-ID
URL
 results.url string

ARTIKELNs API-URL
html_url
 results.html_url string

Url:en för artikeln i hjälpcentret
author_id
 results.author_id integer

Redigerings-ID
comments_disabled
 results.comments_disabled boolean

Sant om kommentarer är inaktiverade. false annars
draft
 results.draft boolean

Sant om översättningen för det aktuella språket är ett utkast
befordrad
 results.promoted boolean

Sant om den här artikeln framhävs; annars falskt. false som standard
position
 results.position integer

Positionen för den här artikeln i artikellistan. 0 som standard
vote_sum
 results.vote_sum integer

Summan av upvotes (+1) och downvotes (-1), som kan vara positiva eller negativa
vote_count
 results.vote_count integer

Det totala antalet upvotes och downvotes
section_id
 results.section_id integer

ID för avsnittet som den här artikeln tillhör
skapad_tid
 results.created_at date-time

Den tid då artikeln skapades
updated_at
 results.updated_at date-time

Den tid då artikeln senast uppdaterades
name
 results.name string

Artikelnamn
title
 results.title string

Artikelns rubrik
source_locale
 results.source_locale string

Artikelns källspråk (standard)
Lokalisering
 results.locale string

Det språk som artikeln visas i
förlegad
 results.outdated boolean

Deprecated
outdated_locales
 results.outdated_locales array of string

Nationella inställningar där artikeln har markerats som inaktuell
edited_at
 results.edited_at date-time

Den tid då artikeln senast redigerades i det språk som visas
user_segment_id
 results.user_segment_id integer

ID för användarsegmentet som definierar vem som kan se den här artikeln
permission_group_id
 results.permission_group_id integer

ID:t för den behörighetsgrupp som definierar vem som kan redigera och publicera den här artikeln
content_tag_ids
 results.content_tag_ids array of string

Listan över innehållstaggar som är kopplade till artikeln
label_names
 results.label_names array of string

En matris med etikettnamn som är associerade med den här artikeln
body
 results.body string

HTML-brödtext i artikeln
utdrag
 results.snippet string

HTML-kodfragment i artikeln
result_type
 results.result_type string

Typ av resultat

TablesList

Name Sökväg Typ Description
värde
 value array of Table