Udostępnij przez

Zendesk

Zendesk tworzy oprogramowanie w celu uzyskania lepszych relacji z klientami. Dzięki wielu produktom w swoim portfolio zendesk zapewnia platformę obsługi klienta i obsługi biletów pomocy technicznej, która zapewnia firmom możliwość obsługi połączeń klientów, wiadomości e-mail i innych zapytań technicznych z ujednoliconego interfejsu.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://www.zendesk.com/
Zasady ochrony prywatności https://www.zendesk.com/company/customers-partners/privacy-policy/

Znane problemy i ograniczenia

  1. Łącznik zwraca tylko niepodzielne właściwości jednostki Zendesk (tj. listy, rekordy i inne typy złożone nie są obsługiwane). Na przykład Ticket jednostka ma tags właściwość reprezentowaną przez tablicę po stronie zendesk. Łącznik Zendesk zwraca [List] ciąg dla takich pól.
  2. Łącznik wymaga updated_at istnienia kolumny dla dowolnej tabeli, która jest używana z wyzwalaczami.
  3. Interfejs API wyszukiwania zendesk ma ograniczenie dotyczące zwracania 1000 wyników na zapytanie. Ma to wpływ na niektóre akcje łącznika, które mogłyby zakończyć się niepowodzeniem z powodu błędu ("Żądanie HTTP nie powiodło się: zawartość nie była prawidłowym kodem JSON"), jeśli tabela docelowa zawiera 1000 rekordów lub więcej:

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Nazwa firmy ciąg Nazwa firmy Zendesk jest częścią poddomeny adresu URL witryny. Np. https://{company}.zendesk.com Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizowanie elementu

Aktualizuje istniejący element zendesk
Pobieranie elementu

Pobiera element zendesk
Pobieranie elementów

Pobiera elementy systemu Zendesk określonego typu Zendesk (na przykład : "Bilet")
Pobieranie tabel

Pobiera tabele Zendesk z witryny
Usuń element

Usuwa element zendesk
Utwórz element

Tworzy element zendesk
Wyszukaj artykuły

Zwraca domyślną liczbę 25 artykułów na stronę, maksymalnie 1000 wyników.

Aktualizowanie elementu

Identyfikator operacji:
PatchItem

Aktualizuje istniejący element zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Typ elementu Zendesk (przykład: "Bilet")
Klucz elementu
 id True string

Unikatowy identyfikator elementu do zaktualizowania
Produkt
 item True dynamic

Element zendesk ze zaktualizowanymi wartościami

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie elementu

Identyfikator operacji:
GetItem

Pobiera element zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Typ elementu Zendesk (przykład: "Bilet")
Klucz elementu
 id True string

Unikatowy identyfikator elementu do pobrania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie elementów

Identyfikator operacji:
GetItems

Pobiera elementy systemu Zendesk określonego typu Zendesk (na przykład : "Bilet")

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Typ elementu Zendesk (przykład: "Bilet")
Zapytanie filtru
 $filter string

Zapytanie filtru ODATA służące do ograniczania wpisów zwróciło wynik (np. stringColumn eq 'ciąg' OR numberColumn lt 123).
Zamów według
 $orderby string

Zapytanie ODATA orderBy określające kolejność wpisów
Pomiń liczbę
 $skip integer

Liczba wpisów do pominięcia (wartość domyślna = 0)
Maksymalna liczba pobrań
 $top integer

Maksymalna liczba wpisów do pobrania (wartość domyślna = 512)
Wybieranie zapytania
 $select string

Określone pola do pobrania z wpisów (wartość domyślna = wszystkie).

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie tabel

Identyfikator operacji:
GetTables

Pobiera tabele Zendesk z witryny

Zwraca

Body
TablesList

Usuń element

Identyfikator operacji:
DeleteItem

Usuwa element zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Typ elementu Zendesk (przykład: "Bilet")
Klucz elementu
 id True string

Unikatowy identyfikator elementu do usunięcia

Utwórz element

Identyfikator operacji:
PostItem

Tworzy element zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Typ elementu Zendesk (przykład: "Bilet")
Produkt
 item True dynamic

Element zendesk do utworzenia

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wyszukaj artykuły

Identyfikator operacji:
SearchArticles

Zwraca domyślną liczbę 25 artykułów na stronę, maksymalnie 1000 wyników.

Parametry

Nazwa Klucz Wymagane Typ Opis
Query
 query True string

Artykuł do wyszukania.
Lokalizacja
 locale string

Ustawienia regionalne elementu są wyświetlane w elemencie
Identyfikator marki
 brand_id integer

Wyszukaj artykuły w określonej marce.
Kategoria
 category integer

Ogranicz wyszukiwanie do tego identyfikatora kategorii.
Section
 section integer

Ogranicz wyszukiwanie do tego identyfikatora sekcji
Nazwy etykiet
 label_names string

Rozdzielona przecinkami lista nazw etykiet.
Multibrand
 multibrand boolean

Włącz wyszukiwanie we wszystkich markach, jeśli to prawda.

Zwraca

Body
SearchResult

Wyzwalacze

Po utworzeniu elementu

Wyzwala przepływ po utworzeniu elementu w systemie Zendesk
Po zmodyfikowaniu elementu

Wyzwala przepływ po zmodyfikowaniu elementu w systemie Zendesk
Po zmodyfikowaniu elementu

Wyzwala przepływ po zmodyfikowaniu elementu w systemie Zendesk

Po utworzeniu elementu

Identyfikator operacji:
GetOnNewItems

Wyzwala przepływ po utworzeniu elementu w systemie Zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Nazwa tabeli Zendesk
Zapytanie filtru
 $filter string

Zapytanie filtru ODATA służące do ograniczania wpisów zwróciło wynik (np. stringColumn eq 'ciąg' OR numberColumn lt 123).
Zamów według
 $orderby string

Zapytanie ODATA orderBy określające kolejność wpisów
Pomiń liczbę
 $skip integer

Liczba wpisów do pominięcia (wartość domyślna = 0)
Maksymalna liczba pobrań
 $top integer

Maksymalna liczba wpisów do pobrania (wartość domyślna = 512)

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po zmodyfikowaniu elementu

Identyfikator operacji:
GetOnUpdatedItemsV2

Wyzwala przepływ po zmodyfikowaniu elementu w systemie Zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Nazwa tabeli Zendesk
Zapytanie filtru
 $filter string

Zapytanie filtru ODATA służące do ograniczania wpisów zwróciło wynik (np. stringColumn eq 'ciąg' OR numberColumn lt 123).
Zamów według
 $orderby string

Zapytanie ODATA orderBy określające kolejność wpisów
Pomiń liczbę
 $skip integer

Liczba wpisów do pominięcia (wartość domyślna = 0)
Maksymalna liczba pobrań
 $top integer

Maksymalna liczba wpisów do pobrania (wartość domyślna = 512)

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po zmodyfikowaniu elementu

Identyfikator operacji:
GetOnUpdatedItems

Wyzwala przepływ po zmodyfikowaniu elementu w systemie Zendesk

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tabeli
 table True string

Nazwa tabeli Zendesk
Zapytanie filtru
 $filter string

Zapytanie filtru ODATA służące do ograniczania wpisów zwróciło wynik (np. stringColumn eq 'ciąg' OR numberColumn lt 123).
Zamów według
 $orderby string

Zapytanie ODATA orderBy określające kolejność wpisów
Pomiń liczbę
 $skip integer

Liczba wpisów do pominięcia (wartość domyślna = 0)
Maksymalna liczba pobrań
 $top integer

Maksymalna liczba wpisów do pobrania (wartość domyślna = 512)

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Definicje

Tabela

Nazwa Ścieżka Typ Opis
Name
 Name string
Nazwa wyświetlana
 DisplayName string

SearchResult

Nazwa Ścieżka Typ Opis
results
 results array of object
id
 results.id integer

Automatycznie przypisany identyfikator artykułu
URL
 results.url string

Adres URL interfejsu API artykułu
html_url
 results.html_url string

Adres URL artykułu w Centrum pomocy
author_id
 results.author_id integer

Identyfikator autora
comments_disabled
 results.comments_disabled boolean

Prawda, jeśli komentarze są wyłączone; false — w przeciwnym razie
roboczy
 results.draft boolean

Prawda, jeśli tłumaczenie bieżących ustawień regionalnych jest wersją roboczą
Promowane
 results.promoted boolean

Prawda, jeśli ten artykuł jest promowany; w przeciwnym razie wartość false. wartość false domyślnie
pozycja
 results.position integer

Pozycja tego artykułu na liście artykułów. Domyślnie 0
vote_sum
 results.vote_sum integer

Suma wywołań upvotes (+1) i downvotes (-1), które mogą być dodatnie lub ujemne
vote_count
 results.vote_count integer

Całkowita liczba wywołań i wywołań w dół
section_id
 results.section_id integer

Identyfikator sekcji, do której należy ten artykuł
utworzono_o
 results.created_at date-time

Godzina utworzenia artykułu
updated_at
 results.updated_at date-time

Czas ostatniej aktualizacji artykułu
nazwa
 results.name string

Nazwa artykułu
title
 results.title string

Tytuł artykułu
source_locale
 results.source_locale string

Ustawienia regionalne źródła (domyślne) artykułu
regionalny
 results.locale string

Ustawienia regionalne wyświetlane w artykule
przestarzały
 results.outdated boolean

Deprecated
outdated_locales
 results.outdated_locales array of string

Ustawienia regionalne, w których artykuł został oznaczony jako nieaktualny
edited_at
 results.edited_at date-time

Czas ostatniej edycji artykułu w wyświetlanych ustawieniach regionalnych
user_segment_id
 results.user_segment_id integer

Identyfikator segmentu użytkownika, który definiuje, kto może zobaczyć ten artykuł
permission_group_id
 results.permission_group_id integer

Identyfikator grupy uprawnień, która definiuje, kto może edytować i opublikować ten artykuł
content_tag_ids
 results.content_tag_ids array of string

Lista tagów zawartości dołączonych do artykułu
label_names
 results.label_names array of string

Tablica nazw etykiet skojarzonych z tym artykułem
body
 results.body string

Treść artykułu w języku HTML
fragment
 results.snippet string

Fragment kodu HTML artykułu
result_type
 results.result_type string

Typ wyniku

TablesList

Nazwa Ścieżka Typ Opis
value
 value array of Table