Udostępnij przez


Plumsail HelpDesk

Interfejs API umożliwia interakcję z systemem biletów Plumsail HelpDesk. Odwiedź stronę https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html , aby uzyskać więcej informacji.

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

Usługa Class Regions
Copilot Studio Standard 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 Standard 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 Standard 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 Plumsail
adres URL https://plumsail.com/sharepoint-helpdesk
Email support@plumsail.com
Metadane łącznika
Publisher Plumsail Inc.
Witryna internetowa https://plumsail.com
Zasady ochrony prywatności https://plumsail.com/privacy-policy/
Kategorie Kolaboracja; Zarządzanie biznesem

Ten łącznik ułatwia manipulowanie danymi w pomocy technicznej za pomocą usługi Power Automate.

Odwiedź stronę https://plumsail.com/helpdesk , aby uzyskać więcej informacji.

Plumsail HelpDesk Plumsail HelpDesk Power Automate Wideo

Wymagania wstępne

Aby rozpocząć korzystanie z niego, należy spełnić następujące wymagania wstępne:

Następnie po utworzeniu klucza interfejsu API możesz przystąpić do tworzenia pierwszej usługi Flow.

Wystarczy wyszukać ciąg "Plumsail HelpDesk" w usłudze Flow i dodać odpowiednią akcję:

Lista akcji pomocy technicznej

Po dodaniu akcji po raz pierwszy zostanie wyświetlony monit o Connection Name polecenie i dla Access Keyelementu . Możesz wpisać dowolną nazwę połączenia. Na przykład Plumsail HelpDesk.

Następnie wklej klucz interfejsu API utworzony w pierwszym kroku, aby Access Key wprowadzić dane wejściowe.

Tworzenie połączenia przepływu

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Udostępnialne

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API dla tego interfejsu API Prawda
Region centrum danych ciąg Prawda

Limity ograniczania

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

Akcje

Aktualizowanie biletu

Pobiera bilet według identyfikatora i aktualizuje go. Zwraca zaktualizowany bilet.

Aktualizowanie kontaktu

Znajduje kontakt według identyfikatora i aktualizuje go. Zwraca zaktualizowany kontakt.

Aktualizowanie kontaktu pocztą e-mail

Znajduje kontakt pocztą e-mail i aktualizuje go. Zwraca zaktualizowany kontakt.

Aktualizowanie organizacji według tytułu

Pobiera organizację według tytułu i aktualizuje ją. Zwraca zaktualizowaną organizację.

Pobieranie wszystkich komentarzy dla biletu

Pobiera wszystkie komentarze dla biletu o określonym identyfikatorze.

Pobieranie załącznika

Zwraca plik załącznika dla określonego biletu według jego nazwy lub zwraca kod błędu

Tworzenie biletu

Tworzy nowy bilet i zwraca utworzony bilet.

Tworzenie komentarza

Tworzy nowy komentarz dla biletu z określonym identyfikatorem i zwraca go.

Tworzenie kontaktu

Tworzy nowy kontakt i zwraca go.

Tworzenie organizacji

Tworzy nowy element na liście Organizacje i zwraca go

Usuwanie biletu

Usuwa bilet według identyfikatora.

Usuwanie kontaktu

Usuwa kontakt według identyfikatora

Usuwanie organizacji według tytułu

Usuwa organizację według tytułu

Usuń organizację

Usuwa organizację według identyfikatora.

Uzyskiwanie biletów

Zwraca listę obiektów TicketRead, każdy obiekt TicketRead ma następujące pola: Category, Created, TicketID, Status, Requester itp. Sprawdź definicję obiektu TicketRead, aby uzyskać więcej szczegółów

Uzyskiwanie jednej organizacji

Pobiera organizację według identyfikatora i zwraca ją

Uzyskiwanie jednej organizacji według tytułu

Pobiera organizację według tytułu i zwraca ją.

Uzyskiwanie kontaktów

Pobieranie listy kontaktów

Uzyskiwanie organizacji

Pobieranie listy organizacji

Uzyskiwanie pojedynczego biletu

Pobiera bilet według identyfikatora i zwraca go

Uzyskiwanie pojedynczego komentarza

Pobiera komentarz według identyfikatora i zwraca go.

Uzyskiwanie pojedynczego kontaktu pocztą e-mail

Pobiera kontakt pocztą e-mail i zwraca go.

Uzyskiwanie pojedynczego kontaktu według identyfikatora

Pobiera kontakt według identyfikatora i retursuje go.

Zaktualizuj organizację

Pobiera organizację według identyfikatora i zwraca ją.

Aktualizowanie biletu

Pobiera bilet według identyfikatora i aktualizuje go. Zwraca zaktualizowany bilet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
id True integer

Identyfikator biletu

Adres e-mail osoby przypisanej do biletu lub nazwa grupy programu SharePoint
assignedToEmail string
ZałącznikContent
AttachmentContent True binary

Zawartość pliku

Nazwa pliku załącznika
Name True string
Treść biletu
body True string
Kategoria biletu
category string
Wiadomości e-mail z biletami DW
ccEmails array of string
Pola niestandardowe biletu
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Data ukończenia biletu
dueDate date-time
Priorytet biletu
priority string
Adres e-mail żądania biletu
requesterEmail True string
Stan biletu
status string
Temat biletu
subject True string
Obsługa biletówChannel
supportChannel string
Tytuły tagów biletów
tagTitles array of string

Zwraca

Body
TicketRead

Aktualizowanie kontaktu

Znajduje kontakt według identyfikatora i aktualizuje go. Zwraca zaktualizowany kontakt.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
id True integer

Identyfikator kontaktu

Kontakt z polami niestandardowymi
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Kontaktowy adres e-mail
email True string
Kontakt alternatywny adres e-mail
emailAlternate string
Rola kontaktu
role string
Skontaktuj się z identyfikatorem SPUserId
spUserId integer
Nazwa kontaktu
title True string

Zwraca

Aktualizowanie kontaktu pocztą e-mail

Znajduje kontakt pocztą e-mail i aktualizuje go. Zwraca zaktualizowany kontakt.

Parametry

Nazwa Klucz Wymagane Typ Opis
Kontaktowy adres e-mail
email True string

Kontaktowy adres e-mail

Kontakt z polami niestandardowymi
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Kontaktowy adres e-mail
email True string
Kontakt alternatywny adres e-mail
emailAlternate string
Rola kontaktu
role string
Skontaktuj się z identyfikatorem SPUserId
spUserId integer
Nazwa kontaktu
title True string

Zwraca

Aktualizowanie organizacji według tytułu

Pobiera organizację według tytułu i aktualizuje ją. Zwraca zaktualizowaną organizację.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tytuł organizacji
title True string

Tytuł organizacji

Pola niestandardowe organizacji
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Tytuł organizacji
title True string

Zwraca

Pobieranie wszystkich komentarzy dla biletu

Pobiera wszystkie komentarze dla biletu o określonym identyfikatorze.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
ticketId True integer

Identyfikator biletu

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

$filter
$filter string

Opcja zapytania $FILTER ODATA w celu ograniczenia zwracanych wpisów

$orderBy
$orderBy string

Opcja zapytania ODATA $orderBy określająca kolejność wpisów.

Zwraca

Pobieranie załącznika

Zwraca plik załącznika dla określonego biletu według jego nazwy lub zwraca kod błędu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
id True integer

Identyfikator biletu

Nazwa pliku załącznika
filename True string

Nazwa pliku załącznika

Zwraca

Plik wyników
binary

Tworzenie biletu

Tworzy nowy bilet i zwraca utworzony bilet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail osoby przypisanej do biletu lub nazwa grupy programu SharePoint
assignedToEmail string
ZałącznikContent
AttachmentContent True binary

Zawartość pliku

Nazwa pliku załącznika
Name True string
Treść biletu
body True string
Kategoria biletu
category string
Wiadomości e-mail z biletami DW
ccEmails array of string
Pola niestandardowe biletu
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Data ukończenia biletu
dueDate date-time
Priorytet biletu
priority string
Adres e-mail żądania biletu
requesterEmail True string
Stan biletu
status string
Temat biletu
subject True string
Obsługa biletówChannel
supportChannel string
Tytuły tagów biletów
tagTitles array of string

Zwraca

Body
TicketRead

Tworzenie komentarza

Tworzy nowy komentarz dla biletu z określonym identyfikatorem i zwraca go.

Parametry

Nazwa Klucz Wymagane Typ Opis
ZałącznikContent
AttachmentContent True binary

Zawartość pliku

Nazwa pliku załącznika
Name True string
Treść komentarza
body True string
Pola niestandardowe komentarza
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Wiadomość e-mail autora komentarzy
fromEmail True string
Identyfikator komunikatu komentarza
messageId string
Identyfikator biletu
ticketId True integer

Identyfikator biletu

Zwraca

Tworzenie kontaktu

Tworzy nowy kontakt i zwraca go.

Parametry

Nazwa Klucz Wymagane Typ Opis
Kontakt z polami niestandardowymi
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Kontaktowy adres e-mail
email True string
Kontakt alternatywny adres e-mail
emailAlternate string
Rola kontaktu
role string
Skontaktuj się z identyfikatorem SPUserId
spUserId integer
Nazwa kontaktu
title True string
Zaktualizuj kontakt, jeśli istnieje
updateIfExists boolean

Aktualizowanie kontaktu, jeśli już istnieje

Zwraca

Tworzenie organizacji

Tworzy nowy element na liście Organizacje i zwraca go

Parametry

Nazwa Klucz Wymagane Typ Opis
Pola niestandardowe organizacji
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Tytuł organizacji
title True string

Zwraca

Usuwanie biletu

Usuwa bilet według identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
id True integer

Identyfikator biletu

Usuwanie kontaktu

Usuwa kontakt według identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
id True integer

Identyfikator kontaktu

Usuwanie organizacji według tytułu

Usuwa organizację według tytułu

Parametry

Nazwa Klucz Wymagane Typ Opis
Tytuł organizacji
title True string

Tytuł organizacji

Usuń organizację

Usuwa organizację według identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator organizacji
id True integer

Identyfikator organizacji

Uzyskiwanie biletów

Zwraca listę obiektów TicketRead, każdy obiekt TicketRead ma następujące pola: Category, Created, TicketID, Status, Requester itp. Sprawdź definicję obiektu TicketRead, aby uzyskać więcej szczegółów

Parametry

Nazwa Klucz Wymagane Typ Opis
$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

$filter
$filter string

Opcja zapytania $filter ODATA. Na przykład użyj $filter=Status/Title eq STATUS lub $filter=Status/Title ne STATUS (STAN może mieć wartość "Oczekiwanie", "Nowy", "W toku", "Rozwiązano" itp.), aby uzyskać bilety o określonym stanie lub $filter=Status/Tytuł rozwiązany w celu uzyskania aktywnych biletów lub $filter=Utworzono gt "2023-08-18", aby uzyskać bilety utworzone po określonej dacie. Użyj pola Kategoria, aby filtrować według kategorii, AssignedTo/Email, aby filtrować według adresu e-mail przypisywanego, AssignedTo/Title, aby filtrować według nazwy osoby przypisanej. Użyj polecenia $filter=substringof('@DOMAIN', requester/email), aby znaleźć osobę z adresem e-mail z domeny (DOMENA). Zaległe bilety są tylko aktywne bilety, gdzie DueDate jest mniej niż dzisiaj.

$orderBy
$orderBy string

Opcja zapytania ODATA $orderBy określająca kolejność wpisów.

$top
$top integer

Opcja zapytania ODATA $top, aby wybrać pierwsze n elementów zwracanego zestawu (wartość domyślna = 50, maksymalna = 100).

$skiptoken
$skiptoken string

Opcja zapytania ODATA $skiptoken pomijać elementy do momentu osiągnięcia określonego elementu i zwrócenia reszty.

Zwraca

Uzyskiwanie jednej organizacji

Pobiera organizację według identyfikatora i zwraca ją

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator organizacji
id True integer

Identyfikator organizacji

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

Zwraca

Uzyskiwanie jednej organizacji według tytułu

Pobiera organizację według tytułu i zwraca ją.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tytuł organizacji
title True string

Tytuł organizacji

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

Zwraca

Uzyskiwanie kontaktów

Pobieranie listy kontaktów

Parametry

Nazwa Klucz Wymagane Typ Opis
$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola. Użyj $select=PhoneNumber,Title,Email,ID, aby dołączyć numer telefonu.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

$filter
$filter string

Użyj opcji $filter ODATA, aby znaleźć wymagany kontakt. Na przykład użyj $filter=Title eq "Bill Gates", aby znaleźć osobę pod pełnym imieniem i nazwiskiem. Użyj $filter=substringof('@DOMAIN', email), aby znaleźć osobę z domeny (DOMENA)

$orderBy
$orderBy string

Opcja zapytania ODATA $orderBy określająca kolejność wpisów.

$top
$top integer

Opcja zapytania ODATA $top, aby wybrać pierwsze n elementów zwracanego zestawu (wartość domyślna = 50, maksymalna = 100).

$skiptoken
$skiptoken string

Opcja zapytania ODATA $skiptoken pomijać elementy do momentu osiągnięcia określonego elementu i zwrócenia reszty.

Zwraca

Uzyskiwanie organizacji

Pobieranie listy organizacji

Parametry

Nazwa Klucz Wymagane Typ Opis
$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

$filter
$filter string

Opcja zapytania $FILTER ODATA w celu ograniczenia zwracanych wpisów

$orderBy
$orderBy string

Opcja zapytania ODATA $orderBy określająca kolejność wpisów.

$top
$top integer

Opcja zapytania ODATA $top, aby wybrać pierwsze n elementów zwracanego zestawu (wartość domyślna = 50, maksymalna = 100).

$skiptoken
$skiptoken string

Opcja zapytania ODATA $skiptoken pomijać elementy do momentu osiągnięcia określonego elementu i zwrócenia reszty.

Zwraca

Uzyskiwanie pojedynczego biletu

Pobiera bilet według identyfikatora i zwraca go

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
id True integer

Identyfikator biletu

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

Zwraca

Body
TicketRead

Uzyskiwanie pojedynczego komentarza

Pobiera komentarz według identyfikatora i zwraca go.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
ticketId True integer

Identyfikator biletu

Identyfikator komentarza
id True integer

Identyfikator komentarza

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

Zwraca

Uzyskiwanie pojedynczego kontaktu pocztą e-mail

Pobiera kontakt pocztą e-mail i zwraca go.

Parametry

Nazwa Klucz Wymagane Typ Opis
Kontaktowy adres e-mail
email True string

Kontaktowy adres e-mail

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

Zwraca

Uzyskiwanie pojedynczego kontaktu według identyfikatora

Pobiera kontakt według identyfikatora i retursuje go.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
id True integer

Identyfikator kontaktu

$select
$select string

Opcja zapytania ODATA $select określająca pola, które mają być zwracane dla elementu listy. Możesz użyć * , aby zwrócić wszystkie dostępne pola.

$expand
$expand string

Opcja zapytania ODATA $expand określająca, że żądanie zwraca wartości odnośników.

Zwraca

Zaktualizuj organizację

Pobiera organizację według identyfikatora i zwraca ją.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator organizacji
id True integer

Identyfikator organizacji

Pola niestandardowe organizacji
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Tytuł organizacji
title True string

Zwraca

Definicje

Cesjonariusza

Nazwa Ścieżka Typ Opis
Pola niestandardowe przypisywania
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Adres e-mail przydzielić
email string
Alternatywny adres e-mail przydzielić
emailAlternate string
Identyfikator przypisywania
id integer
Rola przypisywana
role string
Assignee SPUserId
spUserId integer
Imię i nazwisko osoby przypisanej
title string

DW

Nazwa Ścieżka Typ Opis
Pola niestandardowe cc
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Dw e-mail
email string
Alternatywny adres e-mail dw
emailAlternate string
Identyfikator DW
id integer
Rola DW
role string
Cc SPUserId
spUserId integer
Pełna nazwa dw
title string

KomentarzRead

Nazwa Ścieżka Typ Opis
Treść komentarza
body string
Data utworzenia komentarza
created date-time
Pola niestandardowe komentarza
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Wiadomość e-mail autora komentarzy
fromEmail string
Nazwa autora komentarza
fromName string
Identyfikator komentarza
id integer
Identyfikator komunikatu komentarza
messageId string

ContactRead

Nazwa Ścieżka Typ Opis
Kontakt z polami niestandardowymi
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Kontaktowy adres e-mail
email string
Kontakt alternatywny adres e-mail
emailAlternate string
Identyfikator kontaktu
id integer
Rola kontaktu
role string
Skontaktuj się z identyfikatorem SPUserId
spUserId integer
Imię i nazwisko kontaktu
title string

OrganizationRead

Nazwa Ścieżka Typ Opis
Pola niestandardowe organizacji
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Identyfikator organizacji
id integer
Tytuł organizacji
title string

Żądającego

Nazwa Ścieżka Typ Opis
Pola niestandardowe żądającego
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Wiadomość e-mail żądającego
email string
Alternatywny adres e-mail żądania
emailAlternate string
Identyfikator obiektu żądającego
id integer
Rola żądającego
role string
Requester SPUserId
spUserId integer
Pełna nazwa osoby żądającego
title string

TagRead

Nazwa Ścieżka Typ Opis
Tagowanie pól niestandardowych
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Identyfikator tagu
id integer
Tytuł tagu
title string

TicketRead

Nazwa Ścieżka Typ Opis
Osoba przypisana biletowi
assignedTo Assignee
Załączniki biletów
attachments array of string
Kategoria biletu
category string
Bilet dw
cc array of Cc
Data utworzenia biletu
created date-time
Pola niestandardowe biletu
customFields object

Ciąg JSON zawierający niestandardowe wartości pól

Data ukończenia biletu
dueDate date-time
Identyfikator biletu
id integer
Priorytet biletu
priority string
Żądający biletów
requester Requester
Data rozwiązania biletu
resolutionDate date-time
Stan biletu
status string
Temat biletu
subject string
Tagi biletów
tags array of TagRead
Identyfikator biletu niestandardowego
ticketID string

binarny

Jest to podstawowy typ danych "binary".