Freshservice (preview)
Freshservice is een cloudgebaseerde IT-servicedesk en servicebeheeroplossing die eenvoudig in te stellen en te gebruiken is om de ervaring van werknemers in de hele organisatie te transformeren.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - 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 Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Ondersteuning voor Freshworks-apps |
| URL | https://www.freshworks.com |
| E-mailen | appsupport-ex@freshworks.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://www.freshworks.com/freshservice/lp/home/ |
| Privacybeleid | https://www.freshworks.com/privacy |
| Categorieën | IT-bewerkingen |
Authenticatie
Belangrijk
De verificatie op basis van gebruikersnaam en wachtwoord wordt niet meer ondersteund door de FreshService. De connector ondersteunt nu slechts één verificatietype - API-sleutel. Migratiedocumenten voor FreshService-API
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| API-sleutel | Verificatietype API-sleutel | Alle regio's | Niet deelbaar |
| Standaard [AFGESCHAFT] | Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. | Alle regio's | Niet deelbaar |
API-sleutel
Verificatie-id: Basic
Van toepassing: Alle regio's
Verificatietype API-sleutel
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| API-sleutel | touw | De API-sleutel voor deze API | Klopt |
| Site-URL | touw | URL van hoofdsite (voorbeeld: https://sample.freshservice.com ) | Klopt |
Standaard [AFGESCHAFT]
Van toepassing: Alle regio's
Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Gebruikersnaam | touw | De gebruikersnaam voor deze API | Klopt |
| Wachtwoord | beveiligde string | Het wachtwoord voor deze API | Klopt |
| Site-URL | touw | URL van hoofdsite (voorbeeld: https://sample.freshservice.com ) | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
| Frequentie van trigger-polls | 1 | 120 seconden |
Acties
| Een notitie toevoegen aan een ticket (V2) |
Voeg een persoonlijke of openbare notitie toe aan een ticket. |
| Een notitie toevoegen aan een ticket [AFGESCHAFT] |
Voeg een persoonlijke of openbare notitie toe aan een ticket. |
| Een ticket bijwerken (V2) |
Een ticket bijwerken (alleen opgegeven waarden worden bijgewerkt). |
| Een ticket bijwerken [AFGESCHAFT] |
Een ticket bijwerken (alleen opgegeven waarden worden bijgewerkt). |
| Een ticket maken (V2) |
Maak een ticket. |
| Een ticket maken [AFGESCHAFT] |
Maak een ticket. |
Een notitie toevoegen aan een ticket (V2)
Voeg een persoonlijke of openbare notitie toe aan een ticket.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | integer |
De ticket-id die moet worden bijgewerkt. |
|
Opmerking
|
body | True | string |
De notitie die moet worden toegevoegd aan het ticket. |
|
Is privé
|
private | boolean |
Ingesteld op waar als het bericht privé is. |
Retouren
- Body
- AddNote_ResponseV2
Een notitie toevoegen aan een ticket [AFGESCHAFT]
Voeg een persoonlijke of openbare notitie toe aan een ticket.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | integer |
De ticket-id die moet worden bijgewerkt. |
|
Opmerking
|
body | True | string |
De notitie die moet worden toegevoegd aan het ticket. |
|
Is privé
|
private | boolean |
Ingesteld op waar als het bericht privé is. |
Retouren
- Body
- AddNote_Response
Een ticket bijwerken (V2)
Een ticket bijwerken (alleen opgegeven waarden worden bijgewerkt).
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | integer |
De ticket-id die moet worden bijgewerkt. |
|
Aanvrager-id
|
requester_id | integer |
Gebruikers-id van de aanvrager. Voor bestaande contactpersonen kan requester_id worden doorgegeven in plaats van e-mail. |
|
|
Onderwerp
|
subject | string |
Het onderwerp van het ticket. |
|
|
Toestand
|
status | string |
Status van het ticket. |
|
|
Priority
|
priority | string |
De prioriteit van het ticket (zoals Laag, Gemiddeld of Hoog). |
|
|
Urgentie
|
urgency | string |
Urgentie van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Impact
|
impact | string |
Impact van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Bron
|
source | string |
Het kanaal waarmee het ticket is gemaakt. |
Retouren
Een ticket bijwerken [AFGESCHAFT]
Een ticket bijwerken (alleen opgegeven waarden worden bijgewerkt).
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | integer |
De ticket-id die moet worden bijgewerkt. |
|
Aanvrager-id
|
requester_id | integer |
Gebruikers-id van de aanvrager. Voor bestaande contactpersonen kan requester_id worden doorgegeven in plaats van e-mail. |
|
|
Onderwerp
|
subject | string |
Het onderwerp van het ticket. |
|
|
Toestand
|
status | string |
Status van het ticket. |
|
|
Priority
|
priority | string |
De prioriteit van het ticket (zoals Laag, Gemiddeld of Hoog). |
|
|
Urgentie
|
urgency | string |
Urgentie van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Impact
|
impact | string |
Impact van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Bron
|
source | string |
Het kanaal waarmee het ticket is gemaakt. |
Retouren
Een ticket maken (V2)
Maak een ticket.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
requester_id | integer |
Gebruikers-id van de aanvrager. Een van de aanvrager-id, de e-mail van de aanvrager en de telefoon van de aanvrager is vereist |
|
|
E-mail aanvrager
|
string |
E-mail van de aanvrager. Een van de aanvrager-id, de e-mail van de aanvrager en de telefoon van de aanvrager is vereist |
||
|
Telefoon aanvrager
|
phone | string |
Telefoonnummer van de aanvrager. Een van de aanvrager-id, de e-mail van de aanvrager en de telefoon van de aanvrager is vereist |
|
|
Naam van aanvrager
|
name | string |
Naam van de aanvrager. Dit is alleen een verplicht veld als de aanvraagertelefoonwaarde is opgegeven |
|
|
Onderwerp
|
subject | True | string |
Het onderwerp van het ticket. |
|
Toestand
|
status | True | string |
Status van het ticket. |
|
Priority
|
priority | True | string |
De prioriteit van het ticket (zoals Laag, Gemiddeld of Hoog). |
|
Description
|
description | True | string |
De beschrijving van het ticket. |
|
Urgentie
|
urgency | string |
Urgentie van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Impact
|
impact | string |
Impact van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Bron
|
source | string |
Het kanaal waarmee het ticket is gemaakt. |
Retouren
Een ticket maken [AFGESCHAFT]
Maak een ticket.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Aanvrager-id
|
requester_id | True | integer |
Gebruikers-id van de aanvrager. Voor bestaande contactpersonen kan requester_id worden doorgegeven in plaats van e-mail. |
|
Onderwerp
|
subject | True | string |
Het onderwerp van het ticket. |
|
Toestand
|
status | True | string |
Status van het ticket. |
|
Priority
|
priority | True | string |
De prioriteit van het ticket (zoals Laag, Gemiddeld of Hoog). |
|
Description
|
description | True | string |
De beschrijving van het ticket. |
|
Urgentie
|
urgency | string |
Urgentie van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Impact
|
impact | string |
Impact van het probleem (zoals Laag, Gemiddeld of Hoog). |
|
|
Bron
|
source | string |
Het kanaal waarmee het ticket is gemaakt. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
helpdesk_ticket
|
item.helpdesk_ticket | Ticket_Response |
Triggers
| Wanneer een ticket wordt gemaakt (V2) |
Triggers wanneer een nieuw ticket wordt gemaakt. |
| Wanneer een ticket wordt gemaakt [AFGESCHAFT] |
Triggers wanneer een nieuw ticket wordt gemaakt. |
Wanneer een ticket wordt gemaakt (V2)
Wanneer een ticket wordt gemaakt [AFGESCHAFT]
Definities
Ticket_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gemaakt op Date-Time
|
created_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Wordt verwijderd
|
deleted | boolean |
Stel in als waar als het ticket wordt verwijderd/verwijderd. Verwijderde tickets worden niet meegenomen in weergaven behalve 'verwijderd'-filter. |
|
Afdelings-id
|
department_id_value | integer | |
|
Ticket-id
|
display_id | integer |
Ticket-id die specifiek is voor uw account. |
|
Einddatum Date-Time
|
due_by | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Groeps-id
|
group_id | integer |
Id van groep waaraan het ticket is toegewezen. |
|
Identiteitsbewijs
|
id | integer |
Unieke id van het ticket. |
|
Impact
|
impact | integer |
Een getal dat de impact van het probleem aangeeft. |
|
Is geëscaleerd
|
isescalated | boolean |
Ingesteld op Waar als er een escalatie is verzonden. |
|
Eigenaar Id
|
owner_id | string |
Id van de agent aan wie het probleem is toegewezen. |
|
Priority
|
priority | integer |
Een getal dat de prioriteit van het ticket aangeeft. |
|
Aanvrager-id
|
requester_id | integer |
Gebruikers-id van de aanvrager. Voor bestaande contactpersonen kan requester_id worden doorgegeven in plaats van e-mail. |
|
Antwoord-id
|
responder_id | integer |
Id van de agent aan wie het ticket is toegewezen. |
|
Bron
|
source | integer |
Een getal dat het kanaal aangeeft waarmee het ticket is gemaakt. |
|
Spam
|
spam | boolean |
Stel in als waar als het ticket is gemarkeerd als spam. |
|
Toestand
|
status | integer |
Een getal dat de status van het ticket aangeeft. |
|
Onderwerp
|
subject | string |
Ticketonderwerp. |
|
Tickettype
|
ticket_type | string |
Typ het eigenschapsveld zoals gedefinieerd in ticketvelden. |
|
Naar e-mail
|
to_email | string |
E-mailadres waarnaar de e-mail van het binnenkomende ticket is verzonden. |
|
Bijgewerkt op Date-Time
|
updated_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Urgentie
|
urgency | integer |
Een getal dat de urgentie van het probleem aangeeft. |
|
Description
|
description | string |
Beschrijving van het probleem. |
|
Beschrijving HTML
|
description_html | string |
HTML-inhoud van het ticket. Beschrijving en description_html mogen niet worden doorgegeven. |
|
Statusnaam
|
status_name | string |
Status van het ticket. |
|
Prioriteitsnaam
|
priority_name | string |
Prioriteit van het ticket. |
|
Bronnaam
|
source_name | string |
Het kanaal waarmee het ticket is gemaakt. |
|
Naam van de responder
|
responder_name | string |
Naam van de agent aan wie het ticket is toegewezen. |
|
Naar e-mailberichten
|
to_emails | array of string |
E-mailadressen waarnaar de e-mail van het binnenkomende ticket is verzonden. |
|
Afdelingsnaam
|
department_name | string |
Naam van de afdeling. |
|
Gekoppelde probleem-id
|
assoc_problem_id | integer |
Id van het gekoppelde probleem aan het ticket. |
|
Gekoppelde wijzigings-id
|
assoc_change_id | integer |
Id van de gekoppelde wijziging in het probleem. |
|
Gekoppelde wijzigingsoorzaak-id
|
assoc_change_cause_id | integer |
Id van de wijziging die het ticket veroorzaakt. |
|
Gekoppelde asset-id
|
assoc_asset_id | integer |
Id van de asset die aan het ticket is gekoppeld. |
|
Naam van urgentie
|
urgency_name | string |
Urgentie van het probleem. |
|
Naam van impact
|
impact_name | string |
Impact van het probleem. |
CreateUpdateTicket_ResponseV2
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gemaakt op Date-Time
|
ticket.created_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Afdelings-id
|
ticket.department_id | integer | |
|
Einddatum Date-Time
|
ticket.due_by | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Groeps-id
|
ticket.group_id | integer |
Id van groep waaraan het ticket is toegewezen. |
|
Identiteitsbewijs
|
ticket.id | integer |
Unieke id van het ticket. |
|
Is geëscaleerd
|
ticket.is_escalated | boolean |
Ingesteld op Waar als er een escalatie is verzonden. |
|
Priority
|
ticket.priority | integer |
Een getal dat de prioriteit van het ticket aangeeft. |
|
Aanvrager-id
|
ticket.requester_id | integer |
Gebruikers-id van de aanvrager. Voor bestaande contactpersonen kan requester_id worden doorgegeven in plaats van e-mail. |
|
Antwoord-id
|
ticket.responder_id | integer |
Id van de agent aan wie het ticket is toegewezen. |
|
Bron
|
ticket.source | integer |
Een getal dat het kanaal aangeeft waarmee het ticket is gemaakt. |
|
Spam
|
ticket.spam | boolean |
Stel in als waar als het ticket is gemarkeerd als spam. |
|
Toestand
|
ticket.status | integer |
Een getal dat de status van het ticket aangeeft. |
|
Onderwerp
|
ticket.subject | string |
Ticketonderwerp. |
|
Tickettype
|
ticket.type | string |
Typ het eigenschapsveld zoals gedefinieerd in ticketvelden. |
|
Bijgewerkt op Date-Time
|
ticket.updated_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Description
|
ticket.description_text | string |
Beschrijving van het probleem. |
|
Beschrijving HTML
|
ticket.description | string |
HTML-inhoud van het ticket. Beschrijving en description_html mogen niet worden doorgegeven. |
|
Naar e-mailberichten
|
ticket.to_emails | array of string |
E-mailadressen waarnaar de e-mail van het binnenkomende ticket is verzonden. |
ListTicket_ResponseV2
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gemaakt op Date-Time
|
created_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Afdelings-id
|
department_id | integer | |
|
Einddatum Date-Time
|
due_by | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Groeps-id
|
group_id | integer |
Id van groep waaraan het ticket is toegewezen. |
|
Identiteitsbewijs
|
id | integer |
Unieke id van het ticket. |
|
Is geëscaleerd
|
is_escalated | boolean |
Ingesteld op Waar als er een escalatie is verzonden. |
|
Priority
|
priority | integer |
Een getal dat de prioriteit van het ticket aangeeft. |
|
Aanvrager-id
|
requester_id | integer |
Gebruikers-id van de aanvrager. Voor bestaande contactpersonen kan requester_id worden doorgegeven in plaats van e-mail. |
|
Antwoord-id
|
responder_id | integer |
Id van de agent aan wie het ticket is toegewezen. |
|
Bron
|
source | integer |
Een getal dat het kanaal aangeeft waarmee het ticket is gemaakt. |
|
Spam
|
spam | boolean |
Stel in als waar als het ticket is gemarkeerd als spam. |
|
Toestand
|
status | integer |
Een getal dat de status van het ticket aangeeft. |
|
Onderwerp
|
subject | string |
Ticketonderwerp. |
|
Tickettype
|
type | string |
Typ het eigenschapsveld zoals gedefinieerd in ticketvelden. |
|
Bijgewerkt op Date-Time
|
updated_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Description
|
description_text | string |
Beschrijving van het probleem. |
|
Beschrijving HTML
|
description | string |
HTML-inhoud van het ticket. Beschrijving en description_html mogen niet worden doorgegeven. |
|
Naar e-mailberichten
|
to_emails | array of string |
E-mailadressen waarnaar de e-mail van het binnenkomende ticket is verzonden. |
UpdateTicket_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Wordt verwijderd
|
ticket.deleted | boolean |
Stel in als waar als het ticket wordt verwijderd/verwijderd. Verwijderde tickets worden niet meegenomen in weergaven behalve 'verwijderd'-filter. |
|
Ticket-id
|
ticket.display_id | integer |
Ticket-id die specifiek is voor uw account. |
|
Onderwerp
|
ticket.subject | string |
Ticketonderwerp. |
|
Description
|
ticket.description | string |
Beschrijving van het ticket. |
|
Beschrijving HTML
|
ticket.description_html | string |
HTML-inhoud van het ticket. Beschrijving en description_html mogen niet worden doorgegeven. |
|
Statusnaam
|
ticket.status_name | string |
Status van het ticket. |
|
Prioriteitsnaam
|
ticket.priority_name | string |
Prioriteit van het ticket. |
|
Bronnaam
|
ticket.source_name | string |
Het kanaal waarmee het ticket is gemaakt. |
|
Naam van de responder
|
ticket.responder_name | string |
Naam van de agent aan wie het ticket is toegewezen. |
|
Naar e-mailberichten
|
ticket.to_emails | array of string |
E-mailadressen waarnaar de e-mail van het binnenkomende ticket is verzonden. |
|
Afdelingsnaam
|
ticket.department_name | string |
Naam van de afdeling. |
|
Gekoppelde probleem-id
|
ticket.assoc_problem_id | integer |
Id van het gekoppelde probleem aan het ticket. |
|
Gekoppelde wijzigings-id
|
ticket.assoc_change_id | integer |
Id van de gekoppelde wijziging in het probleem. |
|
Gekoppelde wijzigingsoorzaak-id
|
ticket.assoc_change_cause_id | integer |
Id van de wijziging die het ticket veroorzaakt. |
|
Gekoppelde asset-id
|
ticket.assoc_asset_id | integer |
Id van de asset die aan het ticket is gekoppeld. |
|
Naam van urgentie
|
ticket.urgency_name | string |
Urgentie van het probleem. |
|
Naam van impact
|
ticket.impact_name | string |
Impact van het probleem. |
AddNote_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gemaakt op Date-Time
|
note.created_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Wordt verwijderd
|
note.deleted | boolean |
Stel in als waar als het ticket wordt verwijderd/verwijderd. Verwijderde tickets worden niet meegenomen in weergaven behalve 'verwijderd'-filter. |
|
Identiteitsbewijs
|
note.id | integer |
Unieke id van de notitie. |
|
Privé
|
note.private | boolean |
Stel in als waar als de notitie privé is. |
|
Bron
|
note.source | integer |
Een getal dat het kanaal aangeeft waarmee het ticket is gemaakt. |
|
Bijgewerkt op Date-Time
|
note.updated_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Gebruikersnaam
|
note.user_id | integer |
User_id van de agent die de notitie toevoegt. |
|
Body
|
note.body | string |
Inhoud van de notitie in tekst zonder opmaak. |
|
Hoofdtekst-HTML
|
note.body_html | string |
Inhoud van de notitie in HTML-indeling. Lichaam of body_html moet worden doorgegeven. |
|
attachments
|
note.attachments | array of string |
AddNote_ResponseV2
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gemaakt op Date-Time
|
conversation.created_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Identiteitsbewijs
|
conversation.id | integer |
Unieke id van de notitie. |
|
Privé
|
conversation.private | boolean |
Stel in als waar als de notitie privé is. |
|
Bijgewerkt op Date-Time
|
conversation.updated_at | date-time |
jjjj-MM-ddTHH:mm:ss.fffZ |
|
Gebruikersnaam
|
conversation.user_id | integer |
User_id van de agent die de notitie toevoegt. |
|
Body
|
conversation.body_text | string |
Inhoud van de notitie in tekst zonder opmaak. |
|
Hoofdtekst-HTML
|
conversation.body | string |
Inhoud van de notitie in HTML-indeling. Lichaam of body_html moet worden doorgegeven. |
|
attachments
|
conversation.attachments | array of string | |
|
Ticket-id
|
conversation.ticket_id | integer |
Unieke id van het ticket. |