Delen via


Plumsail HelpDesk

Met de API kunt u communiceren met het Plumsail HelpDesk-ticketingsysteem. Bezoek https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html voor meer informatie.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Standaard Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Standaard Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Standaard Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Plumsail
URL https://plumsail.com/sharepoint-helpdesk
E-mailen support@plumsail.com
Connectormetagegevens
Uitgever Plumsail Inc.
Webpagina https://plumsail.com
Privacybeleid https://plumsail.com/privacy-policy/
Categorieën Samenwerking; Bedrijfsbeheer

Deze connector helpt u bij het bewerken van gegevens in uw HelpDesk met behulp van Power Automate.

Bezoek https://plumsail.com/helpdesk voor meer informatie.

Plumsail HelpDesk Power Automate Video

Vereiste voorwaarden

Als u deze wilt gaan gebruiken, moet u de volgende vereisten voltooien:

Wanneer u vervolgens een API-sleutel hebt gemaakt, bent u klaar om uw eerste Flow te maken.

Zoek naar 'Plumsail HelpDesk' in uw Flow en voeg een geschikte actie toe:

Lijst met HelpDesk-acties

Wanneer u een actie toevoegt voor de eerste keer dat u wordt gevraagd Connection Name en om Access Key. U kunt elke naam voor de verbinding typen. Bijvoorbeeld: Plumsail HelpDesk.

Plak vervolgens de API-sleutel die u in de eerste stap hebt gemaakt om in te Access Key voeren.

Stroomverbinding maken

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard Parameters voor het maken van verbinding. Alle regio's Deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs

Naam Typologie Description Verplicht
API-sleutel beveiligde string De API-sleutel voor deze API Klopt
Datacentrumregio touw Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Alle opmerkingen voor een ticket ophalen

Hiermee haalt u alle opmerkingen voor een ticket met de opgegeven id op.

Bijlage downloaden

Retourneert een bijlagebestand voor een specifiek ticket op naam of retourneert foutcode

Contactpersonen ophalen

Lijst met contactpersonen ophalen

Een contactpersoon bijwerken

Hiermee zoekt u een contactpersoon op id en werkt u deze bij. Retourneert bijgewerkte contactpersoon.

Een contactpersoon bijwerken via e-mail

Hiermee vindt u een contactpersoon via e-mail en werkt u deze bij. Retourneert bijgewerkte contactpersoon.

Een contactpersoon maken

Hiermee maakt u een nieuwe contactpersoon en retourneert u deze.

Een contactpersoon verwijderen

Hiermee verwijdert u de contactpersoon op id

Een opmerking maken

Hiermee maakt u een nieuwe opmerking voor een ticket met de opgegeven id en retourneert u deze.

Een organisatie bijwerken

Hiermee haalt u een organisatie op basis van id op en retourneert u deze.

Een organisatie bijwerken op titel

Hiermee haalt u een organisatie op titel op en werkt u deze bij. Retourneert bijgewerkte organisatie.

Een organisatie maken

Hiermee maakt u een nieuw item in de lijst Organisaties en retourneert u het

Een organisatie verwijderen

Hiermee verwijdert u de organisatie op id.

Een organisatie verwijderen op titel

Organisatie verwijderen op titel

Een ticket bijwerken

Hiermee haalt u een ticket op basis van id op en werkt u het bij. Retourneert een bijgewerkt ticket.

Een ticket maken

Hiermee maakt u een nieuw ticket en retourneert u een gemaakt ticket.

Een ticket verwijderen

Hiermee verwijdert u ticket op id.

Eén contactpersoon per e-mail ophalen

Hiermee haalt u een contactpersoon per e-mail op en retourneert u deze.

Eén contactpersoon per id ophalen

Hiermee haalt u een contactpersoon op basis van id op en herstelt u deze.

Eén opmerking ophalen

Hiermee haalt u een opmerking op basis van id op en retourneert u deze.

Eén organisatie ophalen

Organisatie ophalen op id en retourneert deze

Eén organisatie ophalen op titel

Hiermee haalt u een organisatie op titel op en retourneert deze.

Eén ticket ophalen

Haalt een ticket op id op en retourneert het

Organisaties ophalen

Lijst met organisaties ophalen

Tickets ophalen

Retourneert een lijst met TicketRead-objecten, elk TicketRead-object heeft de volgende velden: Categorie, Gemaakt, TicketID, Status, Aanvrager, enzovoort. Controleer de objectdefinitie TicketRead voor meer informatie

Alle opmerkingen voor een ticket ophalen

Hiermee haalt u alle opmerkingen voor een ticket met de opgegeven id op.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
ticketId True integer

Ticket-id

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

$filter
$filter string

Een ODATA-$filter-queryoptie om de geretourneerde vermeldingen te beperken

$orderBy
$orderBy string

Een ODATA-$orderBy-queryoptie voor het opgeven van de volgorde van vermeldingen.

Retouren

Bijlage downloaden

Retourneert een bijlagebestand voor een specifiek ticket op naam of retourneert foutcode

Parameters

Name Sleutel Vereist Type Description
Ticket-id
id True integer

Ticket-id

Bestandsnaam van bijlage
filename True string

Bestandsnaam van bijlage

Retouren

Resultaatbestand
binary

Contactpersonen ophalen

Lijst met contactpersonen ophalen

Parameters

Name Sleutel Vereist Type Description
$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren. Gebruik $select=PhoneNumber,Title,Email,ID om het telefoonnummer op te nemen.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

$filter
$filter string

Gebruik de optie ODATA $filter om de vereiste contactpersoon te zoeken. Gebruik bijvoorbeeld $filter=Title eq 'Bill Gates' om de persoon op volledige naam te vinden. Gebruik $filter=subtekenreeksvan('@DOMAIN', E-mail) om een persoon te zoeken met e-mail uit het domein (DOMEIN)

$orderBy
$orderBy string

Een ODATA-$orderBy-queryoptie voor het opgeven van de volgorde van vermeldingen.

$top
$top integer

Een ODATA-$top queryoptie om de eerste n items van de geretourneerde set voor retour te selecteren (standaard = 50, maximum = 100).

$skiptoken
$skiptoken string

Een ODATA-$skiptoken-queryoptie om items over te slaan totdat het opgegeven item is bereikt en de rest retourneert.

Retouren

Een contactpersoon bijwerken

Hiermee zoekt u een contactpersoon op id en werkt u deze bij. Retourneert bijgewerkte contactpersoon.

Parameters

Name Sleutel Vereist Type Description
Contactpersoon-ID
id True integer

Contactpersoon-ID

Aangepaste velden contactpersonen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres van contactpersoon
email True string
Alternatieve e-mail contact opnemen
emailAlternate string
Rol van contactpersoon
role string
Contact SPUserId
spUserId integer
Naam van contactpersoon
title True string

Retouren

Een contactpersoon bijwerken via e-mail

Hiermee vindt u een contactpersoon via e-mail en werkt u deze bij. Retourneert bijgewerkte contactpersoon.

Parameters

Name Sleutel Vereist Type Description
E-mailadres van contactpersoon
email True string

E-mailadres van contactpersoon

Aangepaste velden contactpersonen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres van contactpersoon
email True string
Alternatieve e-mail contact opnemen
emailAlternate string
Rol van contactpersoon
role string
Contact SPUserId
spUserId integer
Naam van contactpersoon
title True string

Retouren

Een contactpersoon maken

Hiermee maakt u een nieuwe contactpersoon en retourneert u deze.

Parameters

Name Sleutel Vereist Type Description
Aangepaste velden contactpersonen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres van contactpersoon
email True string
Alternatieve e-mail contact opnemen
emailAlternate string
Rol van contactpersoon
role string
Contact SPUserId
spUserId integer
Naam van contactpersoon
title True string
Contactpersoon bijwerken indien aanwezig
updateIfExists boolean

Contactpersoon bijwerken als deze al bestaat

Retouren

Een contactpersoon verwijderen

Hiermee verwijdert u de contactpersoon op id

Parameters

Name Sleutel Vereist Type Description
Contactpersoon-ID
id True integer

Contactpersoon-ID

Een opmerking maken

Hiermee maakt u een nieuwe opmerking voor een ticket met de opgegeven id en retourneert u deze.

Parameters

Name Sleutel Vereist Type Description
AttachmentContent
AttachmentContent True binary

Bestandsinhoud

Bestandsnaam van bijlage
Name True string
Hoofdtekst van opmerking
body True string
Aangepaste velden toevoegen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres auteur van opmerking
fromEmail True string
Opmerking MessageId
messageId string
Ticket-id
ticketId True integer

Ticket-id

Retouren

Een organisatie bijwerken

Hiermee haalt u een organisatie op basis van id op en retourneert u deze.

Parameters

Name Sleutel Vereist Type Description
Organisatie-id
id True integer

Organisatie-id

Aangepaste organisatievelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Titel van organisatie
title True string

Retouren

Een organisatie bijwerken op titel

Hiermee haalt u een organisatie op titel op en werkt u deze bij. Retourneert bijgewerkte organisatie.

Parameters

Name Sleutel Vereist Type Description
Titel van organisatie
title True string

Titel van organisatie

Aangepaste organisatievelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Titel van organisatie
title True string

Retouren

Een organisatie maken

Hiermee maakt u een nieuw item in de lijst Organisaties en retourneert u het

Parameters

Name Sleutel Vereist Type Description
Aangepaste organisatievelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Titel van organisatie
title True string

Retouren

Een organisatie verwijderen

Hiermee verwijdert u de organisatie op id.

Parameters

Name Sleutel Vereist Type Description
Organisatie-id
id True integer

Organisatie-id

Een organisatie verwijderen op titel

Organisatie verwijderen op titel

Parameters

Name Sleutel Vereist Type Description
Titel van organisatie
title True string

Titel van organisatie

Een ticket bijwerken

Hiermee haalt u een ticket op basis van id op en werkt u het bij. Retourneert een bijgewerkt ticket.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
id True integer

Ticket-id

E-mailadres van toegewezen ticket of SharePoint-groepsnaam
assignedToEmail string
AttachmentContent
AttachmentContent True binary

Bestandsinhoud

Bestandsnaam van bijlage
Name True string
Hoofdtekst van ticket
body True string
Ticketcategorie
category string
Cc-e-mailberichten van ticket
ccEmails array of string
Aangepaste ticketvelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Ticket DueDate
dueDate date-time
Ticketprioriteit
priority string
E-mailadres ticketaanvraag
requesterEmail True string
Ticketstatus
status string
Onderwerp ticket
subject True string
Ticket SupportChannel
supportChannel string
Titels van tickettags
tagTitles array of string

Retouren

Body
TicketRead

Een ticket maken

Hiermee maakt u een nieuw ticket en retourneert u een gemaakt ticket.

Parameters

Name Sleutel Vereist Type Description
E-mailadres van toegewezen ticket of SharePoint-groepsnaam
assignedToEmail string
AttachmentContent
AttachmentContent True binary

Bestandsinhoud

Bestandsnaam van bijlage
Name True string
Hoofdtekst van ticket
body True string
Ticketcategorie
category string
Cc-e-mailberichten van ticket
ccEmails array of string
Aangepaste ticketvelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Ticket DueDate
dueDate date-time
Ticketprioriteit
priority string
E-mailadres ticketaanvraag
requesterEmail True string
Ticketstatus
status string
Onderwerp ticket
subject True string
Ticket SupportChannel
supportChannel string
Titels van tickettags
tagTitles array of string

Retouren

Body
TicketRead

Een ticket verwijderen

Hiermee verwijdert u ticket op id.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
id True integer

Ticket-id

Eén contactpersoon per e-mail ophalen

Hiermee haalt u een contactpersoon per e-mail op en retourneert u deze.

Parameters

Name Sleutel Vereist Type Description
E-mailadres van contactpersoon
email True string

E-mailadres van contactpersoon

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

Retouren

Eén contactpersoon per id ophalen

Hiermee haalt u een contactpersoon op basis van id op en herstelt u deze.

Parameters

Name Sleutel Vereist Type Description
Contactpersoon-ID
id True integer

Contactpersoon-ID

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

Retouren

Eén opmerking ophalen

Hiermee haalt u een opmerking op basis van id op en retourneert u deze.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
ticketId True integer

Ticket-id

Opmerking-id
id True integer

Opmerking-id

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

Retouren

Eén organisatie ophalen

Organisatie ophalen op id en retourneert deze

Parameters

Name Sleutel Vereist Type Description
Organisatie-id
id True integer

Organisatie-id

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

Retouren

Eén organisatie ophalen op titel

Hiermee haalt u een organisatie op titel op en retourneert deze.

Parameters

Name Sleutel Vereist Type Description
Titel van organisatie
title True string

Titel van organisatie

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

Retouren

Eén ticket ophalen

Haalt een ticket op id op en retourneert het

Parameters

Name Sleutel Vereist Type Description
Ticket-id
id True integer

Ticket-id

$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

Retouren

Body
TicketRead

Organisaties ophalen

Lijst met organisaties ophalen

Parameters

Name Sleutel Vereist Type Description
$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

$filter
$filter string

Een ODATA-$filter-queryoptie om de geretourneerde vermeldingen te beperken

$orderBy
$orderBy string

Een ODATA-$orderBy-queryoptie voor het opgeven van de volgorde van vermeldingen.

$top
$top integer

Een ODATA-$top queryoptie om de eerste n items van de geretourneerde set voor retour te selecteren (standaard = 50, maximum = 100).

$skiptoken
$skiptoken string

Een ODATA-$skiptoken-queryoptie om items over te slaan totdat het opgegeven item is bereikt en de rest retourneert.

Retouren

Tickets ophalen

Retourneert een lijst met TicketRead-objecten, elk TicketRead-object heeft de volgende velden: Categorie, Gemaakt, TicketID, Status, Aanvrager, enzovoort. Controleer de objectdefinitie TicketRead voor meer informatie

Parameters

Name Sleutel Vereist Type Description
$select
$select string

Een ODATA-$select queryoptie om op te geven welke velden moeten worden geretourneerd voor een lijstitem. U kunt * gebruiken om alle beschikbare velden te retourneren.

$expand
$expand string

Een ODATA-$expand-queryoptie om op te geven dat de aanvraag de waarden van zoekacties retourneert.

$filter
$filter string

Een ODATA-$filter-queryoptie. Gebruik bijvoorbeeld $filter=Status/Titel eq STATUS of $filter=Status/Titel ne STATUS (STATUS kan 'In behandeling', 'Nieuw', 'In uitvoering', 'Opgelost' enzovoort) zijn om tickets met een specifieke status op te halen, of $filter=Status/Titel ne Opgelost om actieve tickets te krijgen of $filter=Gemaakt gt '2023-08-18' om tickets te laten maken die na een specifieke datum zijn gemaakt. Gebruik het veld Categorie om te filteren op categorie, AssignedTo/Email om te filteren op toegewezen e-mail, AssignedTo/Title om te filteren op naam van toegewezen gebruiker. Gebruik $filter=subtekenreeksvan('@DOMAIN', Aanvrager/e-mail) om een persoon met e-mail van het domein (DOMAIN) te zoeken. Te laat tickets zijn alleen actieve tickets waarbij DueDate minder is dan vandaag.

$orderBy
$orderBy string

Een ODATA-$orderBy-queryoptie voor het opgeven van de volgorde van vermeldingen.

$top
$top integer

Een ODATA-$top queryoptie om de eerste n items van de geretourneerde set voor retour te selecteren (standaard = 50, maximum = 100).

$skiptoken
$skiptoken string

Een ODATA-$skiptoken-queryoptie om items over te slaan totdat het opgegeven item is bereikt en de rest retourneert.

Retouren

Definities

Cessionaris

Name Pad Type Description
Assignee CustomFields
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres van toegewezen gebruiker
email string
Alternatieve e-mail toewijzen
emailAlternate string
Id van toegewezen gebruiker
id integer
Rol van toegewezen gebruiker
role string
Assignee SPUserId
spUserId integer
Volledige naam van toegewezen gebruiker
title string

CC

Name Pad Type Description
Cc CustomFields
customFields object

JSON-tekenreeks met aangepaste veldwaarden

CC-e-mail
email string
Alternatief e-mailadres cc
emailAlternate string
CC-id
id integer
CC-rol
role string
Cc SPUserId
spUserId integer
Volledige naam van CC
title string

CommentRead

Name Pad Type Description
Hoofdtekst van opmerking
body string
Datum voor het maken van opmerkingen
created date-time
Aangepaste velden toevoegen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres auteur van opmerking
fromEmail string
Naam van auteur van opmerking
fromName string
Opmerking-id
id integer
Opmerking MessageId
messageId string

ContactRead

Name Pad Type Description
Aangepaste velden contactpersonen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mailadres van contactpersoon
email string
Alternatieve e-mail contact opnemen
emailAlternate string
Contactpersoon-id
id integer
Rol van contactpersoon
role string
Contact SPUserId
spUserId integer
Volledige naam van contactpersoon
title string

OrganizationRead

Name Pad Type Description
Aangepaste organisatievelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Organisatie-id
id integer
Titel van organisatie
title string

Aanvrager

Name Pad Type Description
Requester CustomFields
customFields object

JSON-tekenreeks met aangepaste veldwaarden

E-mail aanvrager
email string
Alternatieve e-mail van aanvrager
emailAlternate string
Aanvrager-id
id integer
Rol aanvrager
role string
Requester SPUserId
spUserId integer
Volledige naam van aanvrager
title string

TagRead

Name Pad Type Description
Aangepaste velden taggen
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Tag-id
id integer
Titel van tag
title string

TicketRead

Name Pad Type Description
Ticket-toegewezen
assignedTo Assignee
Ticketbijlagen
attachments array of string
Ticketcategorie
category string
Ticket Cc
cc array of Cc
Aanmaakdatum van ticket
created date-time
Aangepaste ticketvelden
customFields object

JSON-tekenreeks met aangepaste veldwaarden

Einddatum van ticket
dueDate date-time
Ticket-id
id integer
Ticketprioriteit
priority string
Ticketaanvraag
requester Requester
Datum van oplossing van ticket
resolutionDate date-time
Ticketstatus
status string
Onderwerp ticket
subject string
Tickettags
tags array of TagRead
Aangepaste ticket-id
ticketID string

binair

Dit is het basisgegevenstype 'binair'.