Udostępnij przez

Freshservice (wersja zapoznawcza)

Freshservice to oparte na chmurze rozwiązanie do zarządzania usługami i usługami IT, które jest łatwe do skonfigurowania i użycia w celu przekształcenia środowiska pracowników w całej organizacji.

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)
     - 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 Government
     — 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)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate - narzędzie do automatyzacji procesów Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Obsługa aplikacji Freshworks
adres URL https://www.freshworks.com
Email appsupport-ex@freshworks.com
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://www.freshworks.com/freshservice/lp/home/
Zasady ochrony prywatności https://www.freshworks.com/privacy
Kategorie Operacje IT

Authentication

Ważne

Uwierzytelnianie oparte na nazwach użytkownika i hasłach nie jest już obsługiwane przez aplikację FreshService. Łącznik obsługuje teraz tylko jeden typ uwierzytelniania — klucz interfejsu API. Dokumentacja migracji interfejsu API usługi FreshService

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Klucz API Typ uwierzytelniania klucza interfejsu API Wszystkie regiony Nie można udostępniać
Domyślne [PRZESTARZAŁE] Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. Wszystkie regiony Nie można udostępniać

Klucz interfejsu API

Identyfikator uwierzytelniania: Podstawowy

Dotyczy: wszystkie regiony

Typ uwierzytelniania klucza interfejsu API

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
Klucz interfejsu API ciąg Klucz interfejsu API dla tego interfejsu API Prawda
Adres URL witryny ciąg Adres URL witryny głównej (przykład: https://sample.freshservice.com ) Prawda

Domyślne [PRZESTARZAŁE]

Dotyczy: wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

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 użytkownika ciąg Nazwa użytkownika dla tego interfejsu API Prawda
Hasło securestring Hasło dla tego interfejsu API Prawda
Adres URL witryny ciąg Adres URL witryny głównej (przykład: https://sample.freshservice.com ) Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund
Częstotliwość sond wyzwalacza 1 120 sekund

Akcje

Aktualizowanie biletu (wersja 2)

Zaktualizuj bilet (zostaną zaktualizowane tylko określone wartości).
Aktualizowanie biletu [PRZESTARZAŁE]

Zaktualizuj bilet (zostaną zaktualizowane tylko określone wartości).
Dodawanie notatki do biletu (wersja 2)

Dodaj notatkę prywatną lub publiczną do biletu.
Dodawanie notatki do biletu [PRZESTARZAŁE]

Dodaj notatkę prywatną lub publiczną do biletu.
Tworzenie biletu (wersja 2)

Utwórz bilet.
Tworzenie biletu [PRZESTARZAŁE]

Utwórz bilet.

Aktualizowanie biletu (wersja 2)

Identyfikator operacji:
UpdateTicketV2

Zaktualizuj bilet (zostaną zaktualizowane tylko określone wartości).

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Identyfikator biletu do zaktualizowania.
Identyfikator obiektu żądającego
 requester_id integer

Identyfikator użytkownika obiektu żądającego. W przypadku istniejących kontaktów można przekazać requester_id zamiast wiadomości e-mail.
Temat
 subject string

Temat biletu.
Status
 status string

Stan biletu.
Priority
 priority string

Priorytet biletu (na przykład Niski, Średni lub Wysoki).
Pilność
 urgency string

Pilność problemu (na przykład Niski, Średni lub Wysoki).
Wpływ
 impact string

Wpływ problemu (na przykład niski, średni lub wysoki).
Źródło
 source string

Kanał, za pośrednictwem którego utworzono bilet.

Zwraca

Body
CreateUpdateTicket_ResponseV2

Aktualizowanie biletu [PRZESTARZAŁE]

Identyfikator operacji:
UpdateTicket

Zaktualizuj bilet (zostaną zaktualizowane tylko określone wartości).

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Identyfikator biletu do zaktualizowania.
Identyfikator obiektu żądającego
 requester_id integer

Identyfikator użytkownika obiektu żądającego. W przypadku istniejących kontaktów można przekazać requester_id zamiast wiadomości e-mail.
Temat
 subject string

Temat biletu.
Status
 status string

Stan biletu.
Priority
 priority string

Priorytet biletu (na przykład Niski, Średni lub Wysoki).
Pilność
 urgency string

Pilność problemu (na przykład Niski, Średni lub Wysoki).
Wpływ
 impact string

Wpływ problemu (na przykład niski, średni lub wysoki).
Źródło
 source string

Kanał, za pośrednictwem którego utworzono bilet.

Zwraca

Body
UpdateTicket_Response

Dodawanie notatki do biletu (wersja 2)

Identyfikator operacji:
AddNoteV2

Dodaj notatkę prywatną lub publiczną do biletu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Identyfikator biletu do zaktualizowania.
Uwaga / Notatka
 body True string

Notatka do dodania do biletu.
Jest prywatny
 private boolean

Ustaw wartość true, jeśli wiadomość jest prywatna.

Zwraca

Body
AddNote_ResponseV2

Dodawanie notatki do biletu [PRZESTARZAŁE]

Identyfikator operacji:
AddNote

Dodaj notatkę prywatną lub publiczną do biletu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator biletu
 ticketId True integer

Identyfikator biletu do zaktualizowania.
Uwaga / Notatka
 body True string

Notatka do dodania do biletu.
Jest prywatny
 private boolean

Ustaw wartość true, jeśli wiadomość jest prywatna.

Zwraca

Body
AddNote_Response

Tworzenie biletu (wersja 2)

Identyfikator operacji:
CreateTicketV2

Utwórz bilet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obiektu żądającego
 requester_id integer

Identyfikator użytkownika obiektu żądającego. Wymagany jest jeden z identyfikatorów żądającego, adres e-mail i telefon żądający
Wiadomość e-mail żądającego
 email string

Adres e-mail obiektu żądającego. Wymagany jest jeden z identyfikatorów żądającego, adres e-mail i telefon żądający
Telefon żądający
 phone string

Numer telefonu obiektu żądającego. Wymagany jest jeden z identyfikatorów żądającego, adres e-mail i telefon żądający
Nazwa osoby żądającego
 name string

Nazwa obiektu żądającego. Jest to pole wymagane tylko wtedy, gdy podano wartość telefonu osoby żądającego
Temat
 subject True string

Temat biletu.
Status
 status True string

Stan biletu.
Priority
 priority True string

Priorytet biletu (na przykład Niski, Średni lub Wysoki).
Description
 description True string

Opis biletu.
Pilność
 urgency string

Pilność problemu (na przykład Niski, Średni lub Wysoki).
Wpływ
 impact string

Wpływ problemu (na przykład niski, średni lub wysoki).
Źródło
 source string

Kanał, za pośrednictwem którego utworzono bilet.

Zwraca

Body
CreateUpdateTicket_ResponseV2

Tworzenie biletu [PRZESTARZAŁE]

Identyfikator operacji:
CreateTicket

Utwórz bilet.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obiektu żądającego
 requester_id True integer

Identyfikator użytkownika obiektu żądającego. W przypadku istniejących kontaktów można przekazać requester_id zamiast wiadomości e-mail.
Temat
 subject True string

Temat biletu.
Status
 status True string

Stan biletu.
Priority
 priority True string

Priorytet biletu (na przykład Niski, Średni lub Wysoki).
Description
 description True string

Opis biletu.
Pilność
 urgency string

Pilność problemu (na przykład Niski, Średni lub Wysoki).
Wpływ
 impact string

Wpływ problemu (na przykład niski, średni lub wysoki).
Źródło
 source string

Kanał, za pośrednictwem którego utworzono bilet.

Zwraca

Nazwa Ścieżka Typ Opis
helpdesk_ticket
 item.helpdesk_ticket Ticket_Response

Wyzwalacze

Po utworzeniu biletu (wersja 2)

Wyzwala po utworzeniu nowego biletu.
Po utworzeniu biletu [PRZESTARZAŁE]

Wyzwala po utworzeniu nowego biletu.

Po utworzeniu biletu (wersja 2)

Identyfikator operacji:
OnTicketCreatedV2

Wyzwala po utworzeniu nowego biletu.

Zwraca

Body
ListTicket_ResponseV2

Po utworzeniu biletu [PRZESTARZAŁE]

Identyfikator operacji:
OnTicketCreated

Wyzwala po utworzeniu nowego biletu.

Zwraca

Body
Ticket_Response

Definicje

Ticket_Response

Nazwa Ścieżka Typ Opis
Utworzono w Date-Time
 created_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Jest usuwany
 deleted boolean

Ustaw wartość true, jeśli bilet zostanie usunięty/z kosza. Usunięte bilety nie będą brane pod uwagę w żadnych widokach z wyjątkiem filtru "usunięte".
Identyfikator działu
 department_id_value integer
Identyfikator biletu
 display_id integer

Identyfikator biletu specyficzny dla Twojego konta.
Termin ukończenia przez Date-Time
 due_by date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator grupy
 group_id integer

Identyfikator grupy, do której przypisano bilet.
Id
 id integer

Unikatowy identyfikator biletu.
Wpływ
 impact integer

Liczba reprezentująca wpływ problemu.
Eskalowano
 isescalated boolean

Ustaw wartość true, jeśli wysłano eskalację.
Identyfikator właściciela
 owner_id string

Identyfikator agenta, któremu przypisano problem.
Priority
 priority integer

Liczba reprezentująca priorytet biletu.
Identyfikator obiektu żądającego
 requester_id integer

Identyfikator użytkownika obiektu żądającego. W przypadku istniejących kontaktów można przekazać requester_id zamiast wiadomości e-mail.
Identyfikator odpowiedzi
 responder_id integer

Identyfikator agenta, któremu przypisano bilet.
Źródło
 source integer

Liczba reprezentująca kanał, za pośrednictwem którego utworzono bilet.
Spam
 spam boolean

Ustaw wartość true, jeśli bilet jest oznaczony jako spam.
Status
 status integer

Liczba reprezentująca stan biletu.
Temat
 subject string

Temat biletu.
Typ biletu
 ticket_type string

Wpisz pole właściwości zgodnie z definicją w polach biletu.
Do wiadomości e-mail
 to_email string

Adres e-mail, na który wysłano wiadomość e-mail z biletem przychodzącym.
Zaktualizowano o Date-Time
 updated_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Pilność
 urgency integer

Liczba reprezentująca pilność problemu.
Description
 description string

Opis problemu.
Opis HTML
 description_html string

Zawartość HTML biletu. Opis i description_html nie powinny być przekazywane razem.
Nazwa stanu
 status_name string

Stan biletu.
Nazwa priorytetu
 priority_name string

Priorytet biletu.
Nazwa źródłowa
 source_name string

Kanał, za pośrednictwem którego utworzono bilet.
Nazwa osoby odpowiadającej
 responder_name string

Nazwa agenta, któremu przypisano bilet.
Do wiadomości e-mail
 to_emails array of string

Adresy e-mail, do których wysłano wiadomość e-mail z biletem przychodzącym.
Nazwa działu
 department_name string

Nazwa działu.
Skojarzony identyfikator problemu
 assoc_problem_id integer

Identyfikator skojarzonego problemu z biletem.
Skojarzony identyfikator zmiany
 assoc_change_id integer

Identyfikator skojarzonej zmiany problemu.
Identyfikator skojarzonej przyczyny zmiany
 assoc_change_cause_id integer

Identyfikator zmiany powodującej bilet.
Skojarzony identyfikator zasobu
 assoc_asset_id integer

Identyfikator zasobu skojarzonego z biletem.
Nazwa pilności
 urgency_name string

Pilność problemu.
Nazwa wpływu
 impact_name string

Wpływ problemu.

CreateUpdateTicket_ResponseV2

Nazwa Ścieżka Typ Opis
Utworzono w Date-Time
 ticket.created_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator działu
 ticket.department_id integer
Termin ukończenia przez Date-Time
 ticket.due_by date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator grupy
 ticket.group_id integer

Identyfikator grupy, do której przypisano bilet.
Id
 ticket.id integer

Unikatowy identyfikator biletu.
Eskalowano
 ticket.is_escalated boolean

Ustaw wartość true, jeśli wysłano eskalację.
Priority
 ticket.priority integer

Liczba reprezentująca priorytet biletu.
Identyfikator obiektu żądającego
 ticket.requester_id integer

Identyfikator użytkownika obiektu żądającego. W przypadku istniejących kontaktów można przekazać requester_id zamiast wiadomości e-mail.
Identyfikator odpowiedzi
 ticket.responder_id integer

Identyfikator agenta, któremu przypisano bilet.
Źródło
 ticket.source integer

Liczba reprezentująca kanał, za pośrednictwem którego utworzono bilet.
Spam
 ticket.spam boolean

Ustaw wartość true, jeśli bilet jest oznaczony jako spam.
Status
 ticket.status integer

Liczba reprezentująca stan biletu.
Temat
 ticket.subject string

Temat biletu.
Typ biletu
 ticket.type string

Wpisz pole właściwości zgodnie z definicją w polach biletu.
Zaktualizowano o Date-Time
 ticket.updated_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Description
 ticket.description_text string

Opis problemu.
Opis HTML
 ticket.description string

Zawartość HTML biletu. Opis i description_html nie powinny być przekazywane razem.
Do wiadomości e-mail
 ticket.to_emails array of string

Adresy e-mail, do których wysłano wiadomość e-mail z biletem przychodzącym.

ListTicket_ResponseV2

Nazwa Ścieżka Typ Opis
Utworzono w Date-Time
 created_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator działu
 department_id integer
Termin ukończenia przez Date-Time
 due_by date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator grupy
 group_id integer

Identyfikator grupy, do której przypisano bilet.
Id
 id integer

Unikatowy identyfikator biletu.
Eskalowano
 is_escalated boolean

Ustaw wartość true, jeśli wysłano eskalację.
Priority
 priority integer

Liczba reprezentująca priorytet biletu.
Identyfikator obiektu żądającego
 requester_id integer

Identyfikator użytkownika obiektu żądającego. W przypadku istniejących kontaktów można przekazać requester_id zamiast wiadomości e-mail.
Identyfikator odpowiedzi
 responder_id integer

Identyfikator agenta, któremu przypisano bilet.
Źródło
 source integer

Liczba reprezentująca kanał, za pośrednictwem którego utworzono bilet.
Spam
 spam boolean

Ustaw wartość true, jeśli bilet jest oznaczony jako spam.
Status
 status integer

Liczba reprezentująca stan biletu.
Temat
 subject string

Temat biletu.
Typ biletu
 type string

Wpisz pole właściwości zgodnie z definicją w polach biletu.
Zaktualizowano o Date-Time
 updated_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Description
 description_text string

Opis problemu.
Opis HTML
 description string

Zawartość HTML biletu. Opis i description_html nie powinny być przekazywane razem.
Do wiadomości e-mail
 to_emails array of string

Adresy e-mail, do których wysłano wiadomość e-mail z biletem przychodzącym.

UpdateTicket_Response

Nazwa Ścieżka Typ Opis
Jest usuwany
 ticket.deleted boolean

Ustaw wartość true, jeśli bilet zostanie usunięty/z kosza. Usunięte bilety nie będą brane pod uwagę w żadnych widokach z wyjątkiem filtru "usunięte".
Identyfikator biletu
 ticket.display_id integer

Identyfikator biletu specyficzny dla Twojego konta.
Temat
 ticket.subject string

Temat biletu.
Description
 ticket.description string

Opis biletu.
Opis HTML
 ticket.description_html string

Zawartość HTML biletu. Opis i description_html nie powinny być przekazywane razem.
Nazwa stanu
 ticket.status_name string

Stan biletu.
Nazwa priorytetu
 ticket.priority_name string

Priorytet biletu.
Nazwa źródłowa
 ticket.source_name string

Kanał, za pośrednictwem którego utworzono bilet.
Nazwa osoby odpowiadającej
 ticket.responder_name string

Nazwa agenta, któremu przypisano bilet.
Do wiadomości e-mail
 ticket.to_emails array of string

Adresy e-mail, do których wysłano wiadomość e-mail z biletem przychodzącym.
Nazwa działu
 ticket.department_name string

Nazwa działu.
Skojarzony identyfikator problemu
 ticket.assoc_problem_id integer

Identyfikator skojarzonego problemu z biletem.
Skojarzony identyfikator zmiany
 ticket.assoc_change_id integer

Identyfikator skojarzonej zmiany problemu.
Identyfikator skojarzonej przyczyny zmiany
 ticket.assoc_change_cause_id integer

Identyfikator zmiany powodującej bilet.
Skojarzony identyfikator zasobu
 ticket.assoc_asset_id integer

Identyfikator zasobu skojarzonego z biletem.
Nazwa pilności
 ticket.urgency_name string

Pilność problemu.
Nazwa wpływu
 ticket.impact_name string

Wpływ problemu.

AddNote_Response

Nazwa Ścieżka Typ Opis
Utworzono w Date-Time
 note.created_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Jest usuwany
 note.deleted boolean

Ustaw wartość true, jeśli bilet zostanie usunięty/z kosza. Usunięte bilety nie będą brane pod uwagę w żadnych widokach z wyjątkiem filtru "usunięte".
Id
 note.id integer

Unikatowy identyfikator notatki.
Prywatne
 note.private boolean

Ustaw wartość true, jeśli notatka jest prywatna.
Źródło
 note.source integer

Liczba reprezentująca kanał, za pośrednictwem którego utworzono bilet.
Zaktualizowano o Date-Time
 note.updated_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator użytkownika
 note.user_id integer

User_id agenta, który dodaje notatkę.
Body
 note.body string

Zawartość notatki w postaci zwykłego tekstu.
Kod HTML treści
 note.body_html string

Zawartość notatki w formacie HTML. Należy przekazać treść lub body_html.
attachments
 note.attachments array of string

AddNote_ResponseV2

Nazwa Ścieżka Typ Opis
Utworzono w Date-Time
 conversation.created_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Id
 conversation.id integer

Unikatowy identyfikator notatki.
Prywatne
 conversation.private boolean

Ustaw wartość true, jeśli notatka jest prywatna.
Zaktualizowano o Date-Time
 conversation.updated_at date-time

rrrr-MM-ddTHH:mm:ss.fffZ
Identyfikator użytkownika
 conversation.user_id integer

User_id agenta, który dodaje notatkę.
Body
 conversation.body_text string

Zawartość notatki w postaci zwykłego tekstu.
Kod HTML treści
 conversation.body string

Zawartość notatki w formacie HTML. Należy przekazać treść lub body_html.
attachments
 conversation.attachments array of string
Identyfikator biletu
 conversation.ticket_id integer

Unikatowy identyfikator biletu.