Freshservice (préversion)
Freshservice est une solution de service informatique basée sur le cloud et une solution de gestion des services qui est facile à configurer et à utiliser pour transformer l’expérience des employés au sein de l’organisation.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge des applications Freshworks |
| URL | https://www.freshworks.com |
| Messagerie électronique | appsupport-ex@freshworks.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site web | https://www.freshworks.com/freshservice/lp/home/ |
| Politique de confidentialité | https://www.freshworks.com/privacy |
| Catégories | Opérations informatiques |
Authentication
Important
L’authentification par nom d’utilisateur et mot de passe n’est plus prise en charge par FreshService. Le connecteur ne prend désormais en charge qu’un seul type d’authentification - Clé API. Documentation sur la migration d’API FreshService
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Clé API | Type d’authentification par clé API | Toutes les régions | Non partageable |
| Valeur par défaut [DÉCONSEILLÉE] | Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante. | Toutes les régions | Non partageable |
Clé d’API
ID d’authentification : De base
Applicable : Toutes les régions
Type d’authentification par clé API
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | ficelle | Clé API pour cette API | Vrai |
| URL du site | ficelle | URL du site racine (exemple : https://sample.freshservice.com ) | Vrai |
Valeur par défaut [DÉCONSEILLÉE]
Applicable : Toutes les régions
Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Nom d’utilisateur | ficelle | Nom d’utilisateur de cette API | Vrai |
| Mot de passe | securestring | Mot de passe de cette API | Vrai |
| URL du site | ficelle | URL du site racine (exemple : https://sample.freshservice.com ) | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
| Fréquence des sondages déclencheurs | 1 | 120 secondes |
Actions
| Ajouter une note à un ticket (V2) |
Ajoutez une note privée ou publique à un ticket. |
| Ajouter une note à un ticket [DÉCONSEILLÉ] |
Ajoutez une note privée ou publique à un ticket. |
| Créer un ticket (V2) |
Créez un ticket. |
| Créer un ticket [DÉCONSEILLÉ] |
Créez un ticket. |
| Mettre à jour un ticket (V2) |
Mettez à jour un ticket (seules les valeurs spécifiées seront mises à jour). |
| Mettre à jour un ticket [DÉCONSEILLÉ] |
Mettez à jour un ticket (seules les valeurs spécifiées seront mises à jour). |
Ajouter une note à un ticket (V2)
Ajoutez une note privée ou publique à un ticket.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID de ticket à mettre à jour. |
|
Note
|
body | True | string |
Note à ajouter au ticket. |
|
Est privé
|
private | boolean |
Défini sur true si le message est privé. |
Retours
- Corps
- AddNote_ResponseV2
Ajouter une note à un ticket [DÉCONSEILLÉ]
Ajoutez une note privée ou publique à un ticket.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID de ticket à mettre à jour. |
|
Note
|
body | True | string |
Note à ajouter au ticket. |
|
Est privé
|
private | boolean |
Défini sur true si le message est privé. |
Retours
- Corps
- AddNote_Response
Créer un ticket (V2)
Créez un ticket.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du demandeur
|
requester_id | integer |
ID utilisateur du demandeur. L’un des ID demandeurs, l’e-mail demandeur et le téléphone demandeur sont requis |
|
|
E-mail du demandeur
|
string |
E-mail du demandeur. L’un des ID demandeurs, l’e-mail demandeur et le téléphone demandeur sont requis |
||
|
Téléphone demandeur
|
phone | string |
Numéro de téléphone du demandeur. L’un des ID demandeurs, l’e-mail demandeur et le téléphone demandeur sont requis |
|
|
Nom du demandeur
|
name | string |
Nom du demandeur. Il s’agit d’un champ obligatoire uniquement si la valeur téléphone du demandeur est fournie |
|
|
Sujet
|
subject | True | string |
Objet du ticket. |
|
Statut
|
status | True | string |
État du ticket. |
|
Priority
|
priority | True | string |
Priorité du ticket (par exemple, Faible, Moyen ou Élevé). |
|
Descriptif
|
description | True | string |
Description du ticket. |
|
Urgence
|
urgency | string |
Urgence du problème (par exemple Faible, Moyen ou Élevé). |
|
|
Impact
|
impact | string |
Impact du problème (par exemple, Faible, Moyen ou Élevé). |
|
|
Origine
|
source | string |
Canal par lequel le ticket a été créé. |
Retours
Créer un ticket [DÉCONSEILLÉ]
Créez un ticket.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du demandeur
|
requester_id | True | integer |
ID utilisateur du demandeur. Pour les contacts existants, requester_id pouvez être transmis au lieu de l’e-mail. |
|
Sujet
|
subject | True | string |
Objet du ticket. |
|
Statut
|
status | True | string |
État du ticket. |
|
Priority
|
priority | True | string |
Priorité du ticket (par exemple, Faible, Moyen ou Élevé). |
|
Descriptif
|
description | True | string |
Description du ticket. |
|
Urgence
|
urgency | string |
Urgence du problème (par exemple Faible, Moyen ou Élevé). |
|
|
Impact
|
impact | string |
Impact du problème (par exemple, Faible, Moyen ou Élevé). |
|
|
Origine
|
source | string |
Canal par lequel le ticket a été créé. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
helpdesk_ticket
|
item.helpdesk_ticket | Ticket_Response |
Mettre à jour un ticket (V2)
Mettez à jour un ticket (seules les valeurs spécifiées seront mises à jour).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID de ticket à mettre à jour. |
|
ID du demandeur
|
requester_id | integer |
ID utilisateur du demandeur. Pour les contacts existants, requester_id pouvez être transmis au lieu de l’e-mail. |
|
|
Sujet
|
subject | string |
Objet du ticket. |
|
|
Statut
|
status | string |
État du ticket. |
|
|
Priority
|
priority | string |
Priorité du ticket (par exemple, Faible, Moyen ou Élevé). |
|
|
Urgence
|
urgency | string |
Urgence du problème (par exemple Faible, Moyen ou Élevé). |
|
|
Impact
|
impact | string |
Impact du problème (par exemple, Faible, Moyen ou Élevé). |
|
|
Origine
|
source | string |
Canal par lequel le ticket a été créé. |
Retours
Mettre à jour un ticket [DÉCONSEILLÉ]
Mettez à jour un ticket (seules les valeurs spécifiées seront mises à jour).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | integer |
ID de ticket à mettre à jour. |
|
ID du demandeur
|
requester_id | integer |
ID utilisateur du demandeur. Pour les contacts existants, requester_id pouvez être transmis au lieu de l’e-mail. |
|
|
Sujet
|
subject | string |
Objet du ticket. |
|
|
Statut
|
status | string |
État du ticket. |
|
|
Priority
|
priority | string |
Priorité du ticket (par exemple, Faible, Moyen ou Élevé). |
|
|
Urgence
|
urgency | string |
Urgence du problème (par exemple Faible, Moyen ou Élevé). |
|
|
Impact
|
impact | string |
Impact du problème (par exemple, Faible, Moyen ou Élevé). |
|
|
Origine
|
source | string |
Canal par lequel le ticket a été créé. |
Retours
- Corps
- UpdateTicket_Response
Déclencheurs
| Lorsqu’un ticket est créé (V2) |
Se déclenche lorsqu’un nouveau ticket est créé. |
| Lorsqu’un ticket est créé [DÉPRÉCIÉ] |
Se déclenche lorsqu’un nouveau ticket est créé. |
Lorsqu’un ticket est créé (V2)
Lorsqu’un ticket est créé [DÉPRÉCIÉ]
Définitions
Ticket_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Créé à Date-Time
|
created_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Est supprimé
|
deleted | boolean |
Définissez la valeur true si le ticket est supprimé/corbeille. Les tickets supprimés ne seront pas pris en compte dans les vues, à l’exception du filtre « supprimé ». |
|
ID du service
|
department_id_value | integer | |
|
Ticket Id
|
display_id | integer |
ID de ticket spécifique à votre compte. |
|
Due By Date-Time
|
due_by | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
ID de groupe
|
group_id | integer |
ID du groupe auquel le ticket est affecté. |
|
Id
|
id | integer |
ID unique du ticket. |
|
Impact
|
impact | integer |
Nombre représentant l’impact du problème. |
|
Est réaffecté
|
isescalated | boolean |
Défini sur true si une escalade a été envoyée. |
|
ID du propriétaire
|
owner_id | string |
ID de l’agent auquel le problème est attribué. |
|
Priority
|
priority | integer |
Nombre représentant la priorité du ticket. |
|
ID du demandeur
|
requester_id | integer |
ID utilisateur du demandeur. Pour les contacts existants, requester_id pouvez être transmis au lieu de l’e-mail. |
|
ID du répondeur
|
responder_id | integer |
ID de l’agent auquel le ticket est attribué. |
|
Origine
|
source | integer |
Nombre représentant le canal par lequel le ticket a été créé. |
|
Spam
|
spam | boolean |
Définissez la valeur true si le ticket est marqué comme courrier indésirable. |
|
Statut
|
status | integer |
Nombre représentant l’état du ticket. |
|
Sujet
|
subject | string |
Objet du ticket. |
|
Ticket Type
|
ticket_type | string |
Type de champ de propriété tel que défini dans les champs de ticket. |
|
Pour envoyer un e-mail
|
to_email | string |
Adresse e-mail à laquelle l’e-mail de ticket entrant a été envoyé. |
|
Mise à jour à Date-Time
|
updated_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Urgence
|
urgency | integer |
Nombre représentant l’urgence du problème. |
|
Descriptif
|
description | string |
Description du problème. |
|
Description HTML
|
description_html | string |
Contenu HTML du ticket. Description et description_html ne doivent pas être passés ensemble. |
|
Nom du statut
|
status_name | string |
État du ticket. |
|
Nom de la priorité
|
priority_name | string |
Priorité du ticket. |
|
Nom de la source
|
source_name | string |
Canal par lequel le ticket a été créé. |
|
Nom du répondeur
|
responder_name | string |
Nom de l’agent auquel le ticket est attribué. |
|
Vers les e-mails
|
to_emails | array of string |
Adresses e-mail auxquelles l’e-mail de ticket entrant a été envoyé. |
|
Nom du service
|
department_name | string |
Nom du service. |
|
ID de problème associé
|
assoc_problem_id | integer |
ID du problème associé au ticket. |
|
ID de modification associé
|
assoc_change_id | integer |
ID de la modification associée au problème. |
|
ID de la cause de modification associée
|
assoc_change_cause_id | integer |
ID de la modification à l’origine du ticket. |
|
ID de ressource associé
|
assoc_asset_id | integer |
ID de la ressource associée au ticket. |
|
Nom de l’urgence
|
urgency_name | string |
Urgence du problème. |
|
Nom de l’impact
|
impact_name | string |
Impact du problème. |
CreateUpdateTicket_ResponseV2
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Créé à Date-Time
|
ticket.created_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
ID du service
|
ticket.department_id | integer | |
|
Due By Date-Time
|
ticket.due_by | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
ID de groupe
|
ticket.group_id | integer |
ID du groupe auquel le ticket est affecté. |
|
Id
|
ticket.id | integer |
ID unique du ticket. |
|
Est réaffecté
|
ticket.is_escalated | boolean |
Défini sur true si une escalade a été envoyée. |
|
Priority
|
ticket.priority | integer |
Nombre représentant la priorité du ticket. |
|
ID du demandeur
|
ticket.requester_id | integer |
ID utilisateur du demandeur. Pour les contacts existants, requester_id pouvez être transmis au lieu de l’e-mail. |
|
ID du répondeur
|
ticket.responder_id | integer |
ID de l’agent auquel le ticket est attribué. |
|
Origine
|
ticket.source | integer |
Nombre représentant le canal par lequel le ticket a été créé. |
|
Spam
|
ticket.spam | boolean |
Définissez la valeur true si le ticket est marqué comme courrier indésirable. |
|
Statut
|
ticket.status | integer |
Nombre représentant l’état du ticket. |
|
Sujet
|
ticket.subject | string |
Objet du ticket. |
|
Ticket Type
|
ticket.type | string |
Type de champ de propriété tel que défini dans les champs de ticket. |
|
Mise à jour à Date-Time
|
ticket.updated_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Descriptif
|
ticket.description_text | string |
Description du problème. |
|
Description HTML
|
ticket.description | string |
Contenu HTML du ticket. Description et description_html ne doivent pas être passés ensemble. |
|
Vers les e-mails
|
ticket.to_emails | array of string |
Adresses e-mail auxquelles l’e-mail de ticket entrant a été envoyé. |
ListTicket_ResponseV2
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Créé à Date-Time
|
created_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
ID du service
|
department_id | integer | |
|
Due By Date-Time
|
due_by | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
ID de groupe
|
group_id | integer |
ID du groupe auquel le ticket est affecté. |
|
Id
|
id | integer |
ID unique du ticket. |
|
Est réaffecté
|
is_escalated | boolean |
Défini sur true si une escalade a été envoyée. |
|
Priority
|
priority | integer |
Nombre représentant la priorité du ticket. |
|
ID du demandeur
|
requester_id | integer |
ID utilisateur du demandeur. Pour les contacts existants, requester_id pouvez être transmis au lieu de l’e-mail. |
|
ID du répondeur
|
responder_id | integer |
ID de l’agent auquel le ticket est attribué. |
|
Origine
|
source | integer |
Nombre représentant le canal par lequel le ticket a été créé. |
|
Spam
|
spam | boolean |
Définissez la valeur true si le ticket est marqué comme courrier indésirable. |
|
Statut
|
status | integer |
Nombre représentant l’état du ticket. |
|
Sujet
|
subject | string |
Objet du ticket. |
|
Ticket Type
|
type | string |
Type de champ de propriété tel que défini dans les champs de ticket. |
|
Mise à jour à Date-Time
|
updated_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Descriptif
|
description_text | string |
Description du problème. |
|
Description HTML
|
description | string |
Contenu HTML du ticket. Description et description_html ne doivent pas être passés ensemble. |
|
Vers les e-mails
|
to_emails | array of string |
Adresses e-mail auxquelles l’e-mail de ticket entrant a été envoyé. |
UpdateTicket_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Est supprimé
|
ticket.deleted | boolean |
Définissez la valeur true si le ticket est supprimé/corbeille. Les tickets supprimés ne seront pas pris en compte dans les vues, à l’exception du filtre « supprimé ». |
|
Ticket Id
|
ticket.display_id | integer |
ID de ticket spécifique à votre compte. |
|
Sujet
|
ticket.subject | string |
Objet du ticket. |
|
Descriptif
|
ticket.description | string |
Description du ticket. |
|
Description HTML
|
ticket.description_html | string |
Contenu HTML du ticket. Description et description_html ne doivent pas être passés ensemble. |
|
Nom du statut
|
ticket.status_name | string |
État du ticket. |
|
Nom de la priorité
|
ticket.priority_name | string |
Priorité du ticket. |
|
Nom de la source
|
ticket.source_name | string |
Canal par lequel le ticket a été créé. |
|
Nom du répondeur
|
ticket.responder_name | string |
Nom de l’agent auquel le ticket est attribué. |
|
Vers les e-mails
|
ticket.to_emails | array of string |
Adresses e-mail auxquelles l’e-mail de ticket entrant a été envoyé. |
|
Nom du service
|
ticket.department_name | string |
Nom du service. |
|
ID de problème associé
|
ticket.assoc_problem_id | integer |
ID du problème associé au ticket. |
|
ID de modification associé
|
ticket.assoc_change_id | integer |
ID de la modification associée au problème. |
|
ID de la cause de modification associée
|
ticket.assoc_change_cause_id | integer |
ID de la modification à l’origine du ticket. |
|
ID de ressource associé
|
ticket.assoc_asset_id | integer |
ID de la ressource associée au ticket. |
|
Nom de l’urgence
|
ticket.urgency_name | string |
Urgence du problème. |
|
Nom de l’impact
|
ticket.impact_name | string |
Impact du problème. |
AddNote_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Créé à Date-Time
|
note.created_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Est supprimé
|
note.deleted | boolean |
Définissez la valeur true si le ticket est supprimé/corbeille. Les tickets supprimés ne seront pas pris en compte dans les vues, à l’exception du filtre « supprimé ». |
|
Id
|
note.id | integer |
ID unique de la note. |
|
Privé
|
note.private | boolean |
Définissez la valeur true si la note est privée. |
|
Origine
|
note.source | integer |
Nombre représentant le canal par lequel le ticket a été créé. |
|
Mise à jour à Date-Time
|
note.updated_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Identifiant
|
note.user_id | integer |
User_id de l’agent qui ajoute la note. |
|
Corps
|
note.body | string |
Contenu de la note en texte brut. |
|
Corps HTML
|
note.body_html | string |
Contenu de la note au format HTML. Corps ou body_html doit être passé. |
|
attachments
|
note.attachments | array of string |
AddNote_ResponseV2
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Créé à Date-Time
|
conversation.created_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Id
|
conversation.id | integer |
ID unique de la note. |
|
Privé
|
conversation.private | boolean |
Définissez la valeur true si la note est privée. |
|
Mise à jour à Date-Time
|
conversation.updated_at | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Identifiant
|
conversation.user_id | integer |
User_id de l’agent qui ajoute la note. |
|
Corps
|
conversation.body_text | string |
Contenu de la note en texte brut. |
|
Corps HTML
|
conversation.body | string |
Contenu de la note au format HTML. Corps ou body_html doit être passé. |
|
attachments
|
conversation.attachments | array of string | |
|
Ticket Id
|
conversation.ticket_id | integer |
ID unique du ticket. |