Freshdesk
Freshdesk è una soluzione di supporto clienti basata sul cloud che consente di semplificare il servizio clienti e assicurarsi che i clienti ricevano il supporto che meritano. Il connettore Freshdesk è destinato agli agenti Freshdesk per gestire ticket e contatti.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Normale | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL |
Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://freshdesk.com/ |
| Informativa sulla privacy | https://www.freshworks.com/privacy/ |
Problemi noti e limitazioni
- Per i trigger "Quando viene creato un ticket", "Quando viene aggiornato un ticket assegnato a un agente", "Quando un ticket viene aggiornato" descrizione del ticket non viene restituito per impostazione predefinita nella risposta. È possibile specificarlo nella risposta del trigger impostando il parametro "Includi descrizione" su "Sì". Tuttavia, si noti che questo è associato a costi aggiuntivi per l'account sul lato Freshdesk poiché l'incorporamento viene usato in questo caso. Se è necessaria la descrizione del ticket, è consigliabile usare il trigger in combinazione con l'azione "Ottieni ticket", perché la risposta di questa azione include la descrizione per impostazione predefinita.
- La creazione del tipo di ticket "Attività servizio" non è attualmente supportata.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Account Url | corda | Ad esempio: https://company.freshdesk.com | Vero |
| Posta elettronica o chiave API (https://aka.ms/ii9u75) | corda | Indirizzo di posta elettronica | Vero |
| Parola chiave | securestring | Password (se si usa la chiave API, è possibile specificare qualsiasi valore) | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
| Frequenza dei polling dei trigger | 1 | 15 secondi |
Azioni
| Aggiornare un ticket |
Aggiornare un ticket (verranno aggiornati solo i valori specificati). |
| Aggiungere una nota a un ticket |
Aggiungere una nota privata o pubblica a un ticket. |
| Creare un ticket |
Creare un ticket. |
| Ottieni ticket |
Ottenere un ticket in base all'ID. |
Aggiornare un ticket
Aggiornare un ticket (verranno aggiornati solo i valori specificati).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID ticket da aggiornare. |
|
Description
|
description | string |
Descrizione del ticket. |
|
|
Oggetto
|
subject | string |
Oggetto del ticket. |
|
|
Priority
|
priority | string |
Priorità del ticket. |
|
|
stato
|
status | string |
Stato del ticket. |
|
|
TIPO
|
type | string |
Consente di classificare il ticket in base ai diversi tipi di problemi che il team di supporto gestisce. |
|
|
Scadenza
|
due_by | date-time |
Timestamp che indica quando il ticket è dovuto alla risoluzione (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
|
Agente
|
responder_id | integer |
Agente del ticket. |
Restituisce
- Corpo
- CreateTicket200Response
Aggiungere una nota a un ticket
Aggiungere una nota privata o pubblica a un ticket.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID ticket a cui aggiungere una nota. |
|
Content
|
body | True | string |
Contenuto della nota. |
|
Privato
|
private | boolean |
Indica se si tratta di una nota privata (il valore predefinito è true). |
Restituisce
- Corpo
- AddNote200Response
Creare un ticket
Creare un ticket.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Oggetto
|
subject | True | string |
Oggetto del ticket. |
|
Description
|
description | True | string |
Descrizione del ticket. |
|
Email
|
True | string |
Messaggio di posta elettronica del richiedente. |
|
|
Priority
|
priority | True | string |
Priorità per il ticket. |
|
stato
|
status | True | string |
Stato del ticket. |
|
TIPO
|
type | string |
Consente di classificare il ticket in base ai diversi tipi di problemi che il team di supporto gestisce. |
|
|
Scadenza
|
due_by | date-time |
Timestamp che indica quando il ticket è dovuto alla risoluzione (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
|
Prima risposta dovuta da
|
fr_due_by | date-time |
Timestamp che indica quando la prima risposta è dovuta (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
|
Agente
|
responder_id | integer |
Agente del ticket. |
|
|
Prodotto
|
product_id | integer |
Il prodotto di cui il ticket deve far parte (solo per l'uso da parte dell'amministratore). |
Restituisce
- Corpo
- CreateTicket200Response
Ottieni ticket
Ottenere un ticket in base all'ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | string |
ID ticket. |
Restituisce
- Corpo
- CreateTicket200Response
Trigger
| Quando lo stato di un ticket cambia |
Quando lo stato del ticket cambia. |
| Quando un ticket assegnato a un agente viene aggiornato |
Quando viene aggiornato un ticket assegnato all'agente selezionato. |
| Quando un ticket viene aggiornato |
Quando un ticket viene aggiornato. |
| Quando viene aggiunto un agente |
Quando viene aggiunto un agente (solo per l'uso da parte dell'amministratore). Questo trigger funziona solo se l'account Freshdesk ha meno di 100 agenti. |
| Quando viene aggiunto un contatto |
Quando viene aggiunto un contatto. Questo trigger funziona solo se l'account Freshdesk ha meno di 100 contatti. |
| Quando viene creato un ticket |
Quando viene creato un ticket. |
Quando lo stato di un ticket cambia
Quando lo stato del ticket cambia.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID ticket. |
|
Nuovo stato
|
status | string |
Nuovo stato del ticket. |
Restituisce
- Corpo
- CreateTicket200Response
Quando un ticket assegnato a un agente viene aggiornato
Quando viene aggiornato un ticket assegnato all'agente selezionato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID agente
|
agentId | True | integer |
ID agente. |
|
Includi descrizione
|
includeDescription | boolean |
Se la risposta del trigger include la descrizione. |
Restituisce
- Corpo
- CreateTicket200Response
Quando un ticket viene aggiornato
Quando un ticket viene aggiornato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | integer |
ID ticket. |
|
|
Includi descrizione
|
includeDescription | boolean |
Se la risposta del trigger include la descrizione. |
Restituisce
- Corpo
- CreateTicket200Response
Quando viene aggiunto un agente
Quando viene aggiunto un agente (solo per l'uso da parte dell'amministratore). Questo trigger funziona solo se l'account Freshdesk ha meno di 100 agenti.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | integer |
id |
|
Ambito ticket
|
ticket_scope | integer |
Autorizzazione ticket dell'agente. |
|
Creato all'indirizzo
|
created_at | date-time |
Timestamp di creazione dell'agente (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Aggiornato all'indirizzo
|
updated_at | date-time |
Timestamp aggiornato dell'agente (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Active
|
contact.active | boolean |
Impostare su true se l'agente viene verificato. |
|
Email
|
contact.email | string |
Indirizzo di posta elettronica dell'agente. |
|
Posizione
|
contact.job_title | string |
Titolo di lavoro dell'agente. |
|
Language
|
contact.language | string |
Lingua dell'agente. |
|
Ultimo accesso all'indirizzo
|
contact.last_login_at | date-time |
Timestamp dell'ultimo accesso riuscito dell'agente (nel formato aaaa-MM-ggTHH:mm:ssZ). |
|
Dispositivo mobile
|
contact.mobile | string |
Numero di cellulare dell'agente. |
|
Nome
|
contact.name | string |
Nome dell'agente. |
|
Telefono
|
contact.phone | string |
Numero di telefono dell'agente. |
|
Fuso orario
|
contact.time_zone | string |
Fuso orario dell'agente. |
|
Creato all'indirizzo
|
contact.created_at | date-time |
Timestamp di creazione dell'agente (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Aggiornato all'indirizzo
|
contact.updated_at | date-time |
Timestamp dell'ultimo aggiornamento dell'agente (in formato aaaa-MM-ggTHH:mm:ssZ). |
Quando viene aggiunto un contatto
Quando viene aggiunto un contatto. Questo trigger funziona solo se l'account Freshdesk ha meno di 100 contatti.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Active
|
active | boolean |
Impostare su true se il contatto è stato verificato. |
|
Address
|
address | string |
Indirizzo del contatto. |
|
ID società
|
company_id | integer |
ID dell'azienda a cui appartiene il contatto. |
|
Description
|
description | string |
Breve descrizione del contatto. |
|
Email
|
string |
Indirizzo di posta elettronica principale del contatto. |
|
|
id
|
id | integer |
ID del contatto. |
|
Posizione
|
job_title | string |
Posizione del contatto. |
|
Language
|
language | string |
Lingua del contatto. |
|
Dispositivo mobile
|
mobile | string |
Numero di cellulare del contatto. |
|
Nome
|
name | string |
Nome del contatto. |
|
Telefono
|
phone | string |
Numero di telefono del contatto. |
|
Fuso orario
|
time_zone | string |
Fuso orario in cui risiede il contatto. |
|
Twitter Id
|
twitter_id | string |
Handle twitter del contatto. |
|
Creato all'indirizzo
|
created_at | date-time |
Timestamp di creazione contatto (in formato aa-MM-ggTHH:mm:ssZ). |
|
Aggiornato all'indirizzo
|
updated_at | date-time |
Timestamp aggiornato del contatto (in formato aaaa-MM-ggTHH:mm:ssZ). |
Quando viene creato un ticket
Quando viene creato un ticket.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Includi descrizione
|
includeDescription | boolean |
Se la risposta del trigger include la descrizione. |
Restituisce
- Corpo
- CreateTicket200Response
Definizioni
CreateTicket200Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Contenuti indesiderati
|
spam | boolean |
Impostare su true se il ticket è stato contrassegnato come posta indesiderata. |
|
Priority
|
priority | string |
Priorità del ticket. |
|
ID richiedente
|
requester_id | integer |
ID utente del richiedente. |
|
ID agente
|
responder_id | integer |
ID dell'agente a cui è stato assegnato il ticket. |
|
Fonte
|
source | string |
Canale tramite il quale è stato creato il ticket. |
|
stato
|
status | string |
Stato del ticket. |
|
Oggetto
|
subject | string |
Oggetto del ticket. |
|
Ticket Id
|
id | integer |
ID univoco del ticket. |
|
TIPO
|
type | string |
Consente di classificare il ticket in base ai diversi tipi di problemi che il team di supporto gestisce. |
|
Scadenza
|
due_by | date-time |
Timestamp che indica quando il ticket è dovuto alla risoluzione (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Riassegnato
|
is_escalated | boolean |
Impostare su true se il ticket è stato inoltrato per qualsiasi motivo. |
|
Description
|
description | string |
Contenuto HTML del ticket. |
|
Testo descrizione
|
description_text | string |
Contenuto del ticket in testo normale. |
|
Creato all'indirizzo
|
created_at | date-time |
Timestamp di creazione del ticket (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Aggiornato all'indirizzo
|
updated_at | date-time |
Timestamp aggiornato del ticket (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Cancellato
|
deleted | boolean |
Impostare su true se il ticket è stato eliminato. |
AddNote200Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Privato
|
private | boolean |
Impostare su true se la nota è privata. |
|
Content
|
body | string |
Contenuto della nota in HTML. |
|
Testo contenuto
|
body_text | string |
Contenuto della nota in testo normale. |
|
Ticket Id
|
ticket_id | integer |
ID del ticket a cui viene aggiunta la nota. |
|
Creato all'indirizzo
|
created_at | date-time |
Timestamp di creazione note (in formato aaaa-MM-ggTHH:mm:ssZ). |
|
Aggiorna all'indirizzo
|
updated_at | date-time |
Nota timestamp aggiornato (in formato aaaa-MM-ggTHH:mm:ssZ). |