Partager via


Support technique Plumsail

L’API permet d’interagir avec le système de tickets Plumsail HelpDesk. Pour plus d’informations, consultez cette page https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html .

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Norme Toutes les régions Power Automate , à l’exception des éléments suivants :
     - 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 Chine
     - Us Department of Defense (DoD)
Power Apps Norme Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Norme Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Plumsail
URL https://plumsail.com/sharepoint-helpdesk
Messagerie électronique support@plumsail.com
Métadonnées du connecteur
Éditeur Plumsail Inc.
Site internet https://plumsail.com
Politique de confidentialité https://plumsail.com/privacy-policy/
Catégories Collaboration; Gestion de l’entreprise

Ce connecteur vous aide à manipuler des données dans votre support technique à l’aide de Power Automate.

Pour plus d’informations, consultez cette page https://plumsail.com/helpdesk .

HelpDesk Plumsail HelpDesk Power Automate Video

Prerequisites

Pour commencer à l’utiliser, vous devez remplir les conditions préalables suivantes :

Ensuite, une fois que vous avez créé une clé API, vous êtes prêt à créer votre premier flux.

Recherchez simplement « Plumsail HelpDesk » dans vous Flow et ajoutez une action appropriée :

Liste des actions du support technique

Lorsque vous ajoutez une action pour la première fois que vous serez demandé Connection Name et pour Access Key. Vous pouvez taper n’importe quel nom pour la connexion. Par exemple : Plumsail HelpDesk.

Collez ensuite la clé API que vous avez créée à la première étape pour Access Key entrer.

Créer une connexion de flux

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom Type Descriptif Obligatoire
Clé d’API securestring Clé API pour cette API Vrai
Région du centre de données ficelle Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un commentaire

Crée un commentaire pour un ticket avec l’ID spécifié et le retourne.

Créer un contact

Crée un contact et le retourne.

Créer un ticket

Crée un ticket et retourne un ticket créé.

Créer une organisation

Crée un élément dans la liste Organisations et le retourne

Mettre à jour un contact

Recherche un contact par ID et le met à jour. Retourne le contact mis à jour.

Mettre à jour un contact par e-mail

Recherche un contact par e-mail et le met à jour. Retourne le contact mis à jour.

Mettre à jour un ticket

Obtient un ticket par ID et le met à jour. Retourne un ticket mis à jour.

Mettre à jour une organisation

Obtient une organisation par ID et la retourne.

Mettre à jour une organisation par titre

Obtient une organisation par titre et la met à jour. Retourne l’organisation mise à jour.

Obtenir des contacts

Obtenir la liste des contacts

Obtenir des organisations

Obtenir la liste des organisations

Obtenir des tickets

Renvoie la liste des objets TicketRead, chaque objet TicketRead a les champs suivants : Catégorie, Créé, TicketID, État, Demandeur, etc. Consultez la définition de l’objet TicketRead pour plus d’informations.

Obtenir tous les commentaires d’un ticket

Obtient tous les commentaires d’un ticket avec l’ID spécifié.

Obtenir un commentaire unique

Obtient un commentaire par ID et le retourne.

Obtenir un contact unique par e-mail

Obtient un contact par e-mail et le retourne.

Obtenir un contact unique par ID

Obtient un contact par ID et le réture.

Obtenir un ticket unique

Obtient un ticket par ID et le retourne

Obtenir une organisation unique par titre

Obtient une organisation par titre et la retourne.

Obtenir une seule organisation

Obtient l’organisation par ID et la renvoie

Supprimer un contact

Supprime le contact par ID

Supprimer un ticket

Supprime le ticket par ID.

Supprimer une organisation

Supprime l’organisation par ID.

Supprimer une organisation par titre

Supprime l’organisation par titre

Télécharger la pièce jointe

Retourne le fichier de pièce jointe pour un ticket spécifique par son nom ou retourne le code d’erreur

Créer un commentaire

Crée un commentaire pour un ticket avec l’ID spécifié et le retourne.

Paramètres

Nom Clé Obligatoire Type Description
AttachmentContent
AttachmentContent True binary

Contenu du fichier

Nom du fichier de pièce jointe
Name True string
Corps du commentaire
body True string
Commenter des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail de l’auteur de commentaires
fromEmail True string
Commentaire MessageId
messageId string
Ticket Id
ticketId True integer

Ticket ID

Retours

Corps
CommentRead

Créer un contact

Crée un contact et le retourne.

Paramètres

Nom Clé Obligatoire Type Description
Contacter des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail de contact
email True string
Contacter un autre e-mail
emailAlternate string
Rôle de contact
role string
Contacter SPUserId
spUserId integer
Nom du contact
title True string
Mettre à jour le contact s’il existe
updateIfExists boolean

Mettre à jour le contact s’il existe déjà

Retours

Corps
ContactRead

Créer un ticket

Crée un ticket et retourne un ticket créé.

Paramètres

Nom Clé Obligatoire Type Description
Adresse e-mail du destinataire de ticket ou nom du groupe SharePoint
assignedToEmail string
AttachmentContent
AttachmentContent True binary

Contenu du fichier

Nom du fichier de pièce jointe
Name True string
Corps du ticket
body True string
Catégorie de ticket
category string
E-mails Cc de ticket
ccEmails array of string
Champs personnalisés de ticket
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Ticket DueDate
dueDate date-time
Priorité du ticket
priority string
E-mail du demandeur de ticket
requesterEmail True string
État du ticket
status string
Objet du ticket
subject True string
Ticket SupportChannel
supportChannel string
Titres des balises de ticket
tagTitles array of string

Retours

Corps
TicketRead

Créer une organisation

Crée un élément dans la liste Organisations et le retourne

Paramètres

Nom Clé Obligatoire Type Description
Champs personnalisés de l’organisation
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Titre de l’organisation
title True string

Retours

Mettre à jour un contact

Recherche un contact par ID et le met à jour. Retourne le contact mis à jour.

Paramètres

Nom Clé Obligatoire Type Description
Contact Id
id True integer

Contact Id

Contacter des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail de contact
email True string
Contacter un autre e-mail
emailAlternate string
Rôle de contact
role string
Contacter SPUserId
spUserId integer
Nom du contact
title True string

Retours

Corps
ContactRead

Mettre à jour un contact par e-mail

Recherche un contact par e-mail et le met à jour. Retourne le contact mis à jour.

Paramètres

Nom Clé Obligatoire Type Description
E-mail de contact
email True string

E-mail de contact

Contacter des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail de contact
email True string
Contacter un autre e-mail
emailAlternate string
Rôle de contact
role string
Contacter SPUserId
spUserId integer
Nom du contact
title True string

Retours

Corps
ContactRead

Mettre à jour un ticket

Obtient un ticket par ID et le met à jour. Retourne un ticket mis à jour.

Paramètres

Nom Clé Obligatoire Type Description
Ticket Id
id True integer

Ticket Id

Adresse e-mail du destinataire de ticket ou nom du groupe SharePoint
assignedToEmail string
AttachmentContent
AttachmentContent True binary

Contenu du fichier

Nom du fichier de pièce jointe
Name True string
Corps du ticket
body True string
Catégorie de ticket
category string
E-mails Cc de ticket
ccEmails array of string
Champs personnalisés de ticket
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Ticket DueDate
dueDate date-time
Priorité du ticket
priority string
E-mail du demandeur de ticket
requesterEmail True string
État du ticket
status string
Objet du ticket
subject True string
Ticket SupportChannel
supportChannel string
Titres des balises de ticket
tagTitles array of string

Retours

Corps
TicketRead

Mettre à jour une organisation

Obtient une organisation par ID et la retourne.

Paramètres

Nom Clé Obligatoire Type Description
ID d’organisation
id True integer

ID d’organisation

Champs personnalisés de l’organisation
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Titre de l’organisation
title True string

Retours

Mettre à jour une organisation par titre

Obtient une organisation par titre et la met à jour. Retourne l’organisation mise à jour.

Paramètres

Nom Clé Obligatoire Type Description
Titre de l’organisation
title True string

Titre de l’organisation

Champs personnalisés de l’organisation
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Titre de l’organisation
title True string

Retours

Obtenir des contacts

Obtenir la liste des contacts

Paramètres

Nom Clé Obligatoire Type Description
$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles. Utilisez $select=PhoneNumber,Title,Email,ID pour inclure le numéro de téléphone.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

$filtre
$filter string

Utilisez l’option de $filter ODATA pour rechercher le contact requis. Par exemple, utilisez $filter=Title eq 'Bill Gates' pour trouver une personne par nom complet. Utilisez $filter=substringof('@DOMAIN', Email) pour rechercher une personne avec un e-mail à partir du domaine (DOMAINE)

$orderBy
$orderBy string

Une option de requête ODATA $orderBy pour spécifier l’ordre des entrées.

$top
$top integer

Une option de requête ODATA $top pour sélectionner les premiers n éléments du jeu de retours (valeur par défaut = 50, maximum = 100).

$skiptoken
$skiptoken string

Une option de requête ODATA $skiptoken pour ignorer les éléments jusqu’à ce que l’élément spécifié soit atteint et retourne le reste.

Retours

Obtenir des organisations

Obtenir la liste des organisations

Paramètres

Nom Clé Obligatoire Type Description
$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

$filtre
$filter string

Option de requête ODATA $filter pour restreindre les entrées retournées

$orderBy
$orderBy string

Une option de requête ODATA $orderBy pour spécifier l’ordre des entrées.

$top
$top integer

Une option de requête ODATA $top pour sélectionner les premiers n éléments du jeu de retours (valeur par défaut = 50, maximum = 100).

$skiptoken
$skiptoken string

Une option de requête ODATA $skiptoken pour ignorer les éléments jusqu’à ce que l’élément spécifié soit atteint et retourne le reste.

Retours

Obtenir des tickets

Renvoie la liste des objets TicketRead, chaque objet TicketRead a les champs suivants : Catégorie, Créé, TicketID, État, Demandeur, etc. Consultez la définition de l’objet TicketRead pour plus d’informations.

Paramètres

Nom Clé Obligatoire Type Description
$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

$filtre
$filter string

Option de requête ODATA $filter. Par exemple, utilisez $filter=Status/Title eq STATUS ou $filter=Status/Title ne STATUS (STATUS peut être « En attente », « Nouveau », « En cours », « Résolu », etc. ) pour obtenir des tickets avec un état spécifique ou $filter=Status/Title ne Solved pour obtenir des tickets actifs ou $filter=Created gt ' 2023-08-18 » pour obtenir des tickets créés après une date spécifique. Utilisez le champ Catégorie pour filtrer par catégorie, AssignedTo/Email pour filtrer par e-mail affecté, AssignedTo/Title pour filtrer par nom du bénéficiaire. Utilisez $filter=substringof('@DOMAIN', Requester/Email) pour rechercher une personne avec un e-mail à partir du domaine (DOMAINE). Les tickets en retard sont uniquement des tickets actifs où DueDate est inférieur à aujourd’hui.

$orderBy
$orderBy string

Une option de requête ODATA $orderBy pour spécifier l’ordre des entrées.

$top
$top integer

Une option de requête ODATA $top pour sélectionner les premiers n éléments du jeu de retours (valeur par défaut = 50, maximum = 100).

$skiptoken
$skiptoken string

Une option de requête ODATA $skiptoken pour ignorer les éléments jusqu’à ce que l’élément spécifié soit atteint et retourne le reste.

Retours

Obtenir tous les commentaires d’un ticket

Obtient tous les commentaires d’un ticket avec l’ID spécifié.

Paramètres

Nom Clé Obligatoire Type Description
Ticket Id
ticketId True integer

Ticket ID

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

$filtre
$filter string

Option de requête ODATA $filter pour restreindre les entrées retournées

$orderBy
$orderBy string

Une option de requête ODATA $orderBy pour spécifier l’ordre des entrées.

Retours

Obtenir un commentaire unique

Obtient un commentaire par ID et le retourne.

Paramètres

Nom Clé Obligatoire Type Description
Ticket Id
ticketId True integer

Ticket Id

ID de commentaire
id True integer

ID de commentaire

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

Retours

Corps
CommentRead

Obtenir un contact unique par e-mail

Obtient un contact par e-mail et le retourne.

Paramètres

Nom Clé Obligatoire Type Description
E-mail de contact
email True string

E-mail de contact

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

Retours

Corps
ContactRead

Obtenir un contact unique par ID

Obtient un contact par ID et le réture.

Paramètres

Nom Clé Obligatoire Type Description
Contact Id
id True integer

Contact Id

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

Retours

Corps
ContactRead

Obtenir un ticket unique

Obtient un ticket par ID et le retourne

Paramètres

Nom Clé Obligatoire Type Description
Ticket Id
id True integer

Ticket Id

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

Retours

Corps
TicketRead

Obtenir une organisation unique par titre

Obtient une organisation par titre et la retourne.

Paramètres

Nom Clé Obligatoire Type Description
Titre de l’organisation
title True string

Titre de l’organisation

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

Retours

Obtenir une seule organisation

Obtient l’organisation par ID et la renvoie

Paramètres

Nom Clé Obligatoire Type Description
ID d’organisation
id True integer

ID d’organisation

$select
$select string

Une option de requête ODATA $select pour spécifier les champs à retourner pour un élément de liste. Vous pouvez utiliser * pour renvoyer tous les champs disponibles.

$expand
$expand string

Une option de requête ODATA $expand pour spécifier que la requête retourne les valeurs des recherches.

Retours

Supprimer un contact

Supprime le contact par ID

Paramètres

Nom Clé Obligatoire Type Description
Contact Id
id True integer

Contact Id

Supprimer un ticket

Supprime le ticket par ID.

Paramètres

Nom Clé Obligatoire Type Description
Ticket Id
id True integer

Ticket Id

Supprimer une organisation

Supprime l’organisation par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID d’organisation
id True integer

ID d’organisation

Supprimer une organisation par titre

Supprime l’organisation par titre

Paramètres

Nom Clé Obligatoire Type Description
Titre de l’organisation
title True string

Titre de l’organisation

Télécharger la pièce jointe

Retourne le fichier de pièce jointe pour un ticket spécifique par son nom ou retourne le code d’erreur

Paramètres

Nom Clé Obligatoire Type Description
Ticket Id
id True integer

Ticket Id

Nom de fichier de pièce jointe
filename True string

Nom de fichier de pièce jointe

Retours

Fichier de résultats
binary

Définitions

Assignee

Nom Chemin d’accès Type Description
Assignee CustomFields
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Adresse e-mail du destinataire
email string
Adresse e-mail de remplacement du destinataire
emailAlternate string
ID du bénéficiaire
id integer
Rôle de bénéficiaire
role string
Assignee SPUserId
spUserId integer
Nom complet du bénéficiaire
title string

Cc

Nom Chemin d’accès Type Description
Cc CustomFields
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail Cc
email string
E-mail alternatif Cc
emailAlternate string
Cc ID
id integer
Rôle Cc
role string
Cc SPUserId
spUserId integer
Nom complet cc
title string

CommentRead

Nom Chemin d’accès Type Description
Corps du commentaire
body string
Date de création de commentaire
created date-time
Commenter des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail de l’auteur de commentaires
fromEmail string
Nom de l’auteur de commentaire
fromName string
ID de commentaire
id integer
Commentaire MessageId
messageId string

ContactRead

Nom Chemin d’accès Type Description
Contacter des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail de contact
email string
Contacter un autre e-mail
emailAlternate string
Identifiant de contact
id integer
Rôle de contact
role string
Contacter SPUserId
spUserId integer
Nom complet du contact
title string

OrganizationRead

Nom Chemin d’accès Type Description
Champs personnalisés de l’organisation
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

ID d’organisation
id integer
Titre de l’organisation
title string

Demandeur

Nom Chemin d’accès Type Description
Demandeur CustomFields
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

E-mail du demandeur
email string
Autre e-mail demandeur
emailAlternate string
ID du demandeur
id integer
Rôle demandeur
role string
SPUserId du demandeur
spUserId integer
Nom complet du demandeur
title string

TagRead

Nom Chemin d’accès Type Description
Baliser des champs personnalisés
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

ID de balise
id integer
Titre de la balise
title string

TicketRead

Nom Chemin d’accès Type Description
Attribution de ticket
assignedTo Assignee
Pièces jointes de ticket
attachments array of string
Catégorie de ticket
category string
Ticket Cc
cc array of Cc
Date de création du ticket
created date-time
Champs personnalisés de ticket
customFields object

Chaîne JSON contenant des valeurs de champ personnalisées

Date d’échéance du ticket
dueDate date-time
Ticket ID
id integer
Priorité du ticket
priority string
Demandeur de tickets
requester Requester
Date de résolution des tickets
resolutionDate date-time
État du ticket
status string
Objet du ticket
subject string
Balises de ticket
tags array of TagRead
ID de ticket personnalisé
ticketID string

binaire

Il s’agit du type de données de base "binaire".