Freshdesk
Freshdesk je cloudové řešení zákaznické podpory, které vám pomůže zjednodušit zákaznické služby a zajistit, aby vaši zákazníci získali podporu, kterou si zaslouží. Konektor Freshdesk je určený pro agenty Freshdesku ke správě lístků a kontaktů.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Standard | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Standard | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL |
Podpora Microsoft LogicApps Podpora microsoft Power Automate Podpora Microsoft Power Apps |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
| Internetová stránka | https://freshdesk.com/ |
| Zásady ochrany osobních údajů | https://www.freshworks.com/privacy/ |
Známé problémy a omezení
- U aktivačních událostí Při vytvoření lístku se popis lístku při aktualizaci lístku agentovi nevrátí ve výchozím nastavení v odpovědi. Zahrnutí do odpovědi triggeru můžete zadat tak, že nastavíte parametr Include description na Hodnotu Ano. Upozorňujeme však, že to souvisí s dodatečnými náklady na straně freshdesku, protože se v tomto případě používá vkládání . Pokud potřebujete popis lístku, doporučujeme použít trigger v kombinaci s akcí Získat lístek, protože odpověď této akce ve výchozím nastavení obsahuje popis.
- Vytvoření typu lístku Service Task se v současné době nepodporuje.
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Adresa URL účtu | řetězec | Příklad: https://company.freshdesk.com | Pravdivé |
| E-mail nebo klíč rozhraní API (https://aka.ms/ii9u75) | řetězec | Vaše e-mailová adresa | Pravdivé |
| Heslo | securestring | Heslo (pokud používáte klíč rozhraní API, můžete zadat libovolnou hodnotu). | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
| Frekvence dotazování triggerů | 1 | 15 sekund |
Akce
| Aktualizace lístku |
Aktualizace lístku (budou aktualizovány pouze zadané hodnoty). |
| Přidání poznámky do lístku |
Přidejte k lístku soukromou nebo veřejnou poznámku. |
| Vytvoření lístku |
Vytvořte lístek. |
| Získání lístku |
Získejte lístek podle ID. |
Aktualizace lístku
Aktualizace lístku (budou aktualizovány pouze zadané hodnoty).
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | True | integer |
ID lístku, které se má aktualizovat. |
|
Description
|
description | string |
Popis lístku |
|
|
Předmět
|
subject | string |
Předmět lístku. |
|
|
Priority
|
priority | string |
Priorita lístku. |
|
|
Stav
|
status | string |
Stav lístku |
|
|
Typ
|
type | string |
Pomáhá kategorizovat lístek podle různých druhů problémů, se kterými se váš tým podpory zabývá. |
|
|
Splnit podle
|
due_by | date-time |
Časové razítko, které označuje, kdy má být lístek vyřešen (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
|
Agenta
|
responder_id | integer |
Agent lístku. |
Návraty
Přidání poznámky do lístku
Přidejte k lístku soukromou nebo veřejnou poznámku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | True | integer |
ID lístku pro přidání poznámky. |
|
Content
|
body | True | string |
Obsah poznámky. |
|
Soukromý
|
private | boolean |
Označuje, jestli se jedná o soukromou poznámku (výchozí hodnota je true). |
Návraty
- Body
- AddNote200Response
Vytvoření lístku
Vytvořte lístek.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Předmět
|
subject | True | string |
Předmět lístku. |
|
Description
|
description | True | string |
Popis lístku |
|
Email
|
True | string |
E-mail žadatele |
|
|
Priority
|
priority | True | string |
Priorita lístku. |
|
Stav
|
status | True | string |
Stav lístku |
|
Typ
|
type | string |
Pomáhá kategorizovat lístek podle různých druhů problémů, se kterými se váš tým podpory zabývá. |
|
|
Splnit podle
|
due_by | date-time |
Časové razítko, které označuje, kdy má být lístek vyřešen (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
|
První odpověď s termínem splnění
|
fr_due_by | date-time |
Časové razítko, které označuje, kdy je první odpověď splatná (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
|
Agenta
|
responder_id | integer |
Agent lístku. |
|
|
Product
|
product_id | integer |
Tento produkt by měl být součástí lístku (pouze pro použití správcem). |
Návraty
Získání lístku
Získejte lístek podle ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | True | string |
ID lístku. |
Návraty
Aktivační události
| Když se stav lístku změní |
Když se stav lístku změní. |
| Při aktualizaci lístku |
Při aktualizaci lístku. |
| Při aktualizaci lístku přiřazeného agentovi |
Když se aktualizuje jakýkoli lístek přiřazený vybranému agentovi. |
| Při přidání agenta |
Když se přidá agent (jenom pro správce). Tento trigger funguje jenom v případě, že má účet Freshdesk méně než 100 agentů. |
| Při přidání kontaktu |
Po přidání kontaktu. Tento trigger funguje jenom v případě, že má účet Freshdesk méně než 100 kontaktů. |
| Při vytvoření lístku |
Po vytvoření jakéhokoli lístku. |
Když se stav lístku změní
Když se stav lístku změní.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | True | integer |
ID lístku. |
|
Nový stav
|
status | string |
Nový stav lístku. |
Návraty
Při aktualizaci lístku
Při aktualizaci lístku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | integer |
ID lístku. |
|
|
Zahrnout popis
|
includeDescription | boolean |
Měla by odpověď triggeru obsahovat popis. |
Návraty
Při aktualizaci lístku přiřazeného agentovi
Když se aktualizuje jakýkoli lístek přiřazený vybranému agentovi.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID agenta
|
agentId | True | integer |
ID agenta. |
|
Zahrnout popis
|
includeDescription | boolean |
Měla by odpověď triggeru obsahovat popis. |
Návraty
Při přidání agenta
Když se přidá agent (jenom pro správce). Tento trigger funguje jenom v případě, že má účet Freshdesk méně než 100 agentů.
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
identifikační číslo
|
id | integer |
identifikační číslo |
|
Rozsah lístku
|
ticket_scope | integer |
Oprávnění k lístku agenta. |
|
Vytvořeno na adrese
|
created_at | date-time |
Časové razítko vytvoření agenta (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
Aktualizováno na adrese
|
updated_at | date-time |
Agent aktualizoval časové razítko (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
Aktivní
|
contact.active | boolean |
Pokud je agent ověřený, nastavte na hodnotu true. |
|
Email
|
contact.email | string |
E-mailová adresa agenta |
|
Název pracovní pozice
|
contact.job_title | string |
Pracovní pozice agenta. |
|
Jazyk
|
contact.language | string |
Jazyk agenta. |
|
Poslední přihlášení na adrese
|
contact.last_login_at | date-time |
Časové razítko posledního úspěšného přihlášení agenta (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
Mobilní zařízení
|
contact.mobile | string |
Mobilní číslo agenta. |
|
Název
|
contact.name | string |
Název agenta. |
|
telefon
|
contact.phone | string |
Telefonní číslo agenta. |
|
Časová zóna
|
contact.time_zone | string |
Časové pásmo agenta. |
|
Vytvořeno na adrese
|
contact.created_at | date-time |
Časové razítko vytvoření agenta (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
Aktualizováno na adrese
|
contact.updated_at | date-time |
Časové razítko poslední aktualizace agenta (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
Při přidání kontaktu
Po přidání kontaktu. Tento trigger funguje jenom v případě, že má účet Freshdesk méně než 100 kontaktů.
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Aktivní
|
active | boolean |
Pokud byl kontakt ověřený, nastavte na hodnotu true. |
|
Address
|
address | string |
Adresa kontaktu. |
|
ID společnosti
|
company_id | integer |
ID společnosti, do které tento kontakt patří. |
|
Description
|
description | string |
Stručný popis kontaktu. |
|
Email
|
string |
Primární e-mailová adresa kontaktu |
|
|
identifikační číslo
|
id | integer |
ID kontaktu. |
|
Název pracovní pozice
|
job_title | string |
Pracovní pozice kontaktu. |
|
Jazyk
|
language | string |
Jazyk kontaktu. |
|
Mobilní zařízení
|
mobile | string |
Číslo mobilního kontaktu. |
|
Název
|
name | string |
Jméno kontaktu. |
|
telefon
|
phone | string |
Telefonní číslo kontaktu. |
|
Časová zóna
|
time_zone | string |
Časové pásmo, ve kterém se kontakt nachází. |
|
Id Twitteru
|
twitter_id | string |
Popisovač kontaktu na Twitteru |
|
Vytvořeno na adrese
|
created_at | date-time |
Časové razítko vytvoření kontaktu (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
Aktualizováno na adrese
|
updated_at | date-time |
Kontaktujte aktualizované časové razítko (ve formátu yyyy-MM-ddTHH:mm:ssZ). |
Při vytvoření lístku
Po vytvoření jakéhokoli lístku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Zahrnout popis
|
includeDescription | boolean |
Měla by odpověď triggeru obsahovat popis. |
Návraty
Definice
CreateTicket200Response
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Nevyžádaná pošta
|
spam | boolean |
Pokud je lístek označený jako spam, nastavte na hodnotu true. |
|
Priority
|
priority | string |
Priorita lístku |
|
ID žadatele
|
requester_id | integer |
ID uživatele žadatele. |
|
ID agenta
|
responder_id | integer |
ID agenta, kterému byl lístek přiřazen. |
|
Zdroj
|
source | string |
Kanál, přes který byl lístek vytvořen. |
|
Stav
|
status | string |
Stav lístku |
|
Předmět
|
subject | string |
Předmět lístku. |
|
ID lístku
|
id | integer |
Jedinečné ID lístku. |
|
Typ
|
type | string |
Pomáhá kategorizovat lístek podle různých druhů problémů, se kterými se váš tým podpory zabývá. |
|
Splnit podle
|
due_by | date-time |
Časové razítko, které označuje, kdy má být lístek vyřešen (ve formátu rrrr-MM-ddTHH:mm:ssZ). |
|
Je eskalováno
|
is_escalated | boolean |
Pokud byl lístek z nějakého důvodu eskalován, nastavte na hodnotu true. |
|
Description
|
description | string |
Obsah html lístku. |
|
Text popisu
|
description_text | string |
Obsah lístku ve formátu prostého textu |
|
Vytvořeno na adrese
|
created_at | date-time |
Časové razítko vytvoření lístku (ve formátu yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualizováno na adrese
|
updated_at | date-time |
Časové razítko aktualizace lístku (ve formátu rrrr-MM-ddTHH:mm:ssZ) |
|
Odstraněné
|
deleted | boolean |
Pokud byl lístek odstraněn, nastavte na hodnotu true. |
PřidatNote200Response
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Soukromý
|
private | boolean |
Pokud je poznámka soukromá, nastavte na hodnotu true. |
|
Content
|
body | string |
Obsah poznámky ve formátu HTML |
|
Text obsahu
|
body_text | string |
Obsah poznámky ve formátu prostého textu |
|
ID lístku
|
ticket_id | integer |
ID lístku, ke kterému se tato poznámka přidává. |
|
Vytvořeno na adrese
|
created_at | date-time |
Časové razítko vytváření poznámek (ve formátu yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualizovat na
|
updated_at | date-time |
Všimněte si aktualizovaného časového razítka (ve formátu rrrr-MM-ddTHH:mm:ssZ). |