Freshdesk
Freshdesk to oparte na chmurze rozwiązanie do obsługi klienta, które pomoże Ci usprawnić obsługę klienta i upewnić się, że klienci otrzymują wsparcie, na które zasługują! Łącznik Freshdesk jest przeznaczony dla agentów freshdesk do zarządzania biletami i kontaktami.
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 | 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://freshdesk.com/ |
| Zasady ochrony prywatności | https://www.freshworks.com/privacy/ |
Znane problemy i ograniczenia
- W przypadku wyzwalaczy "Po utworzeniu biletu", "Po zaktualizowaniu biletu przypisanego do agenta", "Po zaktualizowaniu biletu" opis biletu nie jest domyślnie zwracany w odpowiedzi. Możesz określić dołączenie go do odpowiedzi wyzwalacza, ustawiając parametr "Uwzględnij opis" na wartość "Tak". Należy jednak pamiętać, że jest to związane z dodatkowymi kosztami konta po stronie aplikacji Freshdesk, ponieważ osadzanie jest używane w tym przypadku. Jeśli potrzebujesz opisu biletu, zalecamy użycie wyzwalacza w połączeniu z akcją "Pobierz bilet", ponieważ odpowiedź tej akcji domyślnie zawiera opis.
- Tworzenie typu biletu "Zadanie usługi" nie jest obecnie obsługiwane.
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 App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Adres URL konta | ciąg | Na przykład: https://company.freshdesk.com | Prawda |
| Adres e-mail lub klucz interfejsu API (https://aka.ms/ii9u75) | ciąg | Twój adres e-mail | Prawda |
| Hasło | securestring | Hasło (jeśli używasz klucza interfejsu API, można określić dowolną wartość) | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
| Częstotliwość sond wyzwalacza | 1 | 15 sekund |
Akcje
| Aktualizowanie biletu |
Zaktualizuj bilet (zostaną zaktualizowane tylko określone wartości). |
| Dodawanie notatki do biletu |
Dodaj notatkę prywatną lub publiczną do biletu. |
| Tworzenie biletu |
Utwórz bilet. |
| Uzyskiwanie biletu |
Uzyskaj bilet według identyfikatora. |
Aktualizowanie biletu
Zaktualizuj bilet (zostaną zaktualizowane tylko określone wartości).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | True | integer |
Identyfikator biletu do zaktualizowania. |
|
Description
|
description | string |
Opis biletu. |
|
|
Temat
|
subject | string |
Temat biletu. |
|
|
Priority
|
priority | string |
Priorytet biletu. |
|
|
Status
|
status | string |
Stan biletu. |
|
|
Typ
|
type | string |
Pomaga kategoryzować bilet zgodnie z różnymi rodzajami problemów, z jakimi zajmuje się zespół pomocy technicznej. |
|
|
Termin
|
due_by | date-time |
Sygnatura czasowa wskazująca, kiedy bilet ma zostać rozwiązany (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
|
Przedstawiciel
|
responder_id | integer |
Agent biletu. |
Zwraca
Dodawanie notatki do biletu
Dodaj notatkę prywatną lub publiczną do biletu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | True | integer |
Identyfikator biletu do dodania notatki. |
|
Content
|
body | True | string |
Zawartość notatki. |
|
Prywatne
|
private | boolean |
Wskazuje, czy jest to notatka prywatna (wartość domyślna to true). |
Zwraca
- Body
- AddNote200Response
Tworzenie biletu
Utwórz bilet.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Temat
|
subject | True | string |
Temat biletu. |
|
Description
|
description | True | string |
Opis biletu. |
|
Email
|
True | string |
Adres e-mail obiektu żądającego. |
|
|
Priority
|
priority | True | string |
Priorytet biletu. |
|
Status
|
status | True | string |
Stan biletu. |
|
Typ
|
type | string |
Pomaga kategoryzować bilet zgodnie z różnymi rodzajami problemów, z jakimi zajmuje się zespół pomocy technicznej. |
|
|
Termin
|
due_by | date-time |
Sygnatura czasowa wskazująca, kiedy bilet ma zostać rozwiązany (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
|
Pierwsza odpowiedź należna przez
|
fr_due_by | date-time |
Sygnatura czasowa, która wskazuje, kiedy pierwsza odpowiedź jest należna (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
|
Przedstawiciel
|
responder_id | integer |
Agent biletu. |
|
|
Product
|
product_id | integer |
Produkt, który powinien być częścią biletu (tylko do użytku przez administratora). |
Zwraca
Uzyskiwanie biletu
Uzyskaj bilet według identyfikatora.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | True | string |
Identyfikator biletu. |
Zwraca
Wyzwalacze
| Gdy stan biletu zmieni się |
Gdy zmieni się stan biletu. |
| Po dodaniu agenta |
Po dodaniu agenta (tylko do użytku przez administratora). Ten wyzwalacz działa tylko wtedy, gdy konto aplikacji Freshdesk ma mniej niż 100 agentów. |
| Po dodaniu kontaktu |
Po dodaniu kontaktu. Ten wyzwalacz działa tylko wtedy, gdy konto aplikacji Freshdesk ma mniej niż 100 kontaktów. |
| Po utworzeniu biletu |
Po utworzeniu dowolnego biletu. |
| Po zaktualizowaniu biletu |
Po zaktualizowaniu biletu. |
| Po zaktualizowaniu biletu przypisanego do agenta |
Po zaktualizowaniu dowolnego biletu przypisanego do wybranego agenta. |
Gdy stan biletu zmieni się
Gdy zmieni się stan biletu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | True | integer |
Identyfikator biletu. |
|
Nowy stan
|
status | string |
Nowy stan biletu. |
Zwraca
Po dodaniu agenta
Po dodaniu agenta (tylko do użytku przez administratora). Ten wyzwalacz działa tylko wtedy, gdy konto aplikacji Freshdesk ma mniej niż 100 agentów.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | integer |
id |
|
Zakres biletu
|
ticket_scope | integer |
Uprawnienie do biletu agenta. |
|
Utworzono pod adresem
|
created_at | date-time |
Sygnatura czasowa tworzenia agenta (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Zaktualizowano o
|
updated_at | date-time |
Sygnatura czasowa aktualizacji agenta (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Aktywna
|
contact.active | boolean |
Ustaw wartość true, jeśli agent zostanie zweryfikowany. |
|
Email
|
contact.email | string |
Adres e-mail agenta. |
|
Stanowisko
|
contact.job_title | string |
Stanowisko agenta. |
|
Język
|
contact.language | string |
Język agenta. |
|
Ostatnio zaloguj się pod adresem
|
contact.last_login_at | date-time |
Sygnatura czasowa ostatniego pomyślnego logowania agenta (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Mobile
|
contact.mobile | string |
Numer telefonu komórkowego agenta. |
|
Name
|
contact.name | string |
Nazwa agenta. |
|
Telefon
|
contact.phone | string |
Numer telefonu agenta. |
|
Strefa czasowa
|
contact.time_zone | string |
Strefa czasowa agenta. |
|
Utworzono pod adresem
|
contact.created_at | date-time |
Sygnatura czasowa tworzenia agenta (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Zaktualizowano o
|
contact.updated_at | date-time |
Sygnatura czasowa ostatniej aktualizacji agenta (w formacie rrrr-MM-ddTHH:mm:ssZ). |
Po dodaniu kontaktu
Po dodaniu kontaktu. Ten wyzwalacz działa tylko wtedy, gdy konto aplikacji Freshdesk ma mniej niż 100 kontaktów.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Aktywna
|
active | boolean |
Ustaw wartość true, jeśli kontakt został zweryfikowany. |
|
Address
|
address | string |
Adres kontaktu. |
|
Identyfikator firmy
|
company_id | integer |
Identyfikator firmy, do której należy ten kontakt. |
|
Description
|
description | string |
Krótki opis kontaktu. |
|
Email
|
string |
Podstawowy adres e-mail kontaktu. |
|
|
Id
|
id | integer |
Identyfikator kontaktu. |
|
Stanowisko
|
job_title | string |
Stanowisko kontaktu. |
|
Język
|
language | string |
Język kontaktu. |
|
Mobile
|
mobile | string |
Numer telefonu komórkowego kontaktu. |
|
Name
|
name | string |
Nazwa kontaktu. |
|
Telefon
|
phone | string |
Numer telefonu kontaktu. |
|
Strefa czasowa
|
time_zone | string |
Strefa czasowa, w której znajduje się kontakt. |
|
Identyfikator twittera
|
twitter_id | string |
Obsługa twittera kontaktu. |
|
Utworzono pod adresem
|
created_at | date-time |
Sygnatura czasowa tworzenia kontaktu (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Zaktualizowano o
|
updated_at | date-time |
Skontaktuj się ze zaktualizowanym znacznikiem czasu (w formacie rrrr-MM-ddTHH:mm:ssZ). |
Po utworzeniu biletu
Po utworzeniu dowolnego biletu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Dołącz opis
|
includeDescription | boolean |
Jeśli odpowiedź wyzwalacza zawiera opis. |
Zwraca
Po zaktualizowaniu biletu
Po zaktualizowaniu biletu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | integer |
Identyfikator biletu. |
|
|
Dołącz opis
|
includeDescription | boolean |
Jeśli odpowiedź wyzwalacza zawiera opis. |
Zwraca
Po zaktualizowaniu biletu przypisanego do agenta
Po zaktualizowaniu dowolnego biletu przypisanego do wybranego agenta.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator agenta
|
agentId | True | integer |
Identyfikator agenta. |
|
Dołącz opis
|
includeDescription | boolean |
Jeśli odpowiedź wyzwalacza zawiera opis. |
Zwraca
Definicje
CreateTicket200Response
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Spam
|
spam | boolean |
Ustaw wartość true, jeśli bilet został oznaczony jako spam. |
|
Priority
|
priority | string |
Priorytet biletu. |
|
Identyfikator obiektu żądającego
|
requester_id | integer |
Identyfikator użytkownika obiektu żądającego. |
|
Identyfikator agenta
|
responder_id | integer |
Identyfikator agenta, do którego przypisano bilet. |
|
Źródło
|
source | string |
Kanał, za pośrednictwem którego utworzono bilet. |
|
Status
|
status | string |
Stan biletu. |
|
Temat
|
subject | string |
Temat biletu. |
|
Identyfikator biletu
|
id | integer |
Unikatowy identyfikator biletu. |
|
Typ
|
type | string |
Pomaga kategoryzować bilet zgodnie z różnymi rodzajami problemów, z jakimi zajmuje się zespół pomocy technicznej. |
|
Termin
|
due_by | date-time |
Sygnatura czasowa wskazująca, kiedy bilet ma zostać rozwiązany (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Eskalowano
|
is_escalated | boolean |
Ustaw wartość true, jeśli bilet został eskalowany z jakiegokolwiek powodu. |
|
Description
|
description | string |
Zawartość HTML biletu. |
|
Tekst opisu
|
description_text | string |
Zawartość biletu w postaci zwykłego tekstu. |
|
Utworzono pod adresem
|
created_at | date-time |
Sygnatura czasowa tworzenia biletu (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Zaktualizowano o
|
updated_at | date-time |
Zaktualizowany znacznik czasu biletu (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Usunięte
|
deleted | boolean |
Ustaw wartość true, jeśli bilet został usunięty. |
AddNote200Response
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Prywatne
|
private | boolean |
Ustaw wartość true, jeśli notatka jest prywatna. |
|
Content
|
body | string |
Zawartość notatki w kodzie HTML. |
|
Tekst zawartości
|
body_text | string |
Zawartość notatki w postaci zwykłego tekstu. |
|
Identyfikator biletu
|
ticket_id | integer |
Identyfikator biletu, do którego jest dodawana ta notatka. |
|
Utworzono pod adresem
|
created_at | date-time |
Znacznik czasu tworzenia noty (w formacie rrrr-MM-ddTHH:mm:ssZ). |
|
Aktualizuj o
|
updated_at | date-time |
Zanotuj zaktualizowany znacznik czasu (w formacie rrrr-MM-ddTHH:mm:ssZ). |