Freshdesk
Freshdesk is een cloudgebaseerde klantondersteuningsoplossing die u helpt uw klantenservice te stroomlijnen en ervoor te zorgen dat uw klanten de ondersteuning krijgen die ze verdienen! De Freshdesk-connector is bedoeld voor Freshdesk-agenten voor het beheren van tickets en contactpersonen.
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 | Microsoft |
| URL |
Ondersteuning voor Microsoft LogicApps Ondersteuning voor Microsoft Power Automate Ondersteuning voor Microsoft Power Apps |
| Connector-metagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://freshdesk.com/ |
| Privacybeleid | https://www.freshworks.com/privacy/ |
Bekende problemen en beperkingen
- Voor triggers 'Wanneer een ticket wordt gemaakt', 'Wanneer een ticket is toegewezen aan een agent wordt bijgewerkt', wordt de beschrijving van het ticket niet standaard geretourneerd in het antwoord. U kunt het opnemen in het triggerantwoord opgeven door de parameter 'Beschrijving opnemen' in te stellen op Ja. Houd er echter rekening mee dat dit is gekoppeld aan extra kosten voor uw account aan de zijde van Freshdesk, omdat in dit geval insluiting wordt gebruikt. Als u de beschrijving van het ticket nodig hebt, wordt u aangeraden de trigger te gebruiken in combinatie met de actie Ticket ophalen, omdat het antwoord van deze actie standaard de beschrijving bevat.
- Het maken van tickettype 'Servicetaak' wordt momenteel niet ondersteund.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
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 |
|---|---|---|---|
| Account-URL | touw | Bijvoorbeeld: https://company.freshdesk.com | Klopt |
| E-mail of API-sleutel (https://aka.ms/ii9u75) | touw | Uw e-mailadres | Klopt |
| Wachtwoord | beveiligde string | Wachtwoord (als u API-sleutel gebruikt, kan elke waarde worden opgegeven) | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
| Frequentie van trigger-polls | 1 | 15 seconden |
Acties
| Een notitie toevoegen aan een ticket |
Voeg een persoonlijke of openbare notitie toe aan een ticket. |
| Een ticket bijwerken |
Een ticket bijwerken (alleen opgegeven waarden worden bijgewerkt). |
| Een ticket maken |
Maak een ticket. |
| Ticket ophalen |
Haal een ticket op id op. |
Een notitie toevoegen aan een ticket
Voeg een persoonlijke of openbare notitie toe aan een ticket.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | integer |
De ticket-id waaraan u een notitie wilt toevoegen. |
|
Content
|
body | True | string |
De inhoud van de notitie. |
|
Privé
|
private | boolean |
Geeft aan of dit een privénotitie is (de standaardwaarde is waar). |
Retouren
- Body
- AddNote200Response
Een ticket bijwerken
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. |
|
Description
|
description | string |
De beschrijving van het ticket. |
|
|
Onderwerp
|
subject | string |
Het onderwerp van het ticket. |
|
|
Priority
|
priority | string |
De prioriteit van het ticket. |
|
|
Toestand
|
status | string |
De status van het ticket. |
|
|
Typologie
|
type | string |
Helpt bij het categoriseren van het ticket op basis van de verschillende soorten problemen waarmee uw ondersteuningsteam te maken krijgt. |
|
|
Einddatum
|
due_by | date-time |
Tijdstempel die aangeeft wanneer het ticket moet worden omgezet (in indeling jjjj-MM-ddTHH:mm:ssZ). |
|
|
Vertegenwoordiger
|
responder_id | integer |
De agent van het ticket. |
Retouren
Een ticket maken
Maak een ticket.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerp
|
subject | True | string |
Het onderwerp voor het ticket. |
|
Description
|
description | True | string |
De beschrijving voor het ticket. |
|
E-mailen
|
True | string |
Het e-mailadres van de aanvrager. |
|
|
Priority
|
priority | True | string |
De prioriteit voor het ticket. |
|
Toestand
|
status | True | string |
De status van het ticket. |
|
Typologie
|
type | string |
Helpt bij het categoriseren van het ticket op basis van de verschillende soorten problemen waarmee uw ondersteuningsteam te maken krijgt. |
|
|
Einddatum
|
due_by | date-time |
Tijdstempel die aangeeft wanneer het ticket moet worden omgezet (in indeling jjjj-MM-ddTHH:mm:ssZ). |
|
|
Eerste reactie einddatum door
|
fr_due_by | date-time |
Tijdstempel die aangeeft wanneer het eerste antwoord moet worden voltooid (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
|
Vertegenwoordiger
|
responder_id | integer |
De agent van het ticket. |
|
|
Product
|
product_id | integer |
Het product waarvan het ticket deel uitmaakt (alleen voor beheerdersgebruik). |
Retouren
Ticket ophalen
Haal een ticket op id op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | string |
De ticket-id. |
Retouren
Triggers
| Wanneer de status van een ticket verandert |
Wanneer de status van het ticket wordt gewijzigd. |
| Wanneer een agent wordt toegevoegd |
Wanneer een agent wordt toegevoegd (alleen voor beheerdersgebruik). Deze trigger werkt alleen als het Freshdesk-account minder dan 100 agents heeft. |
| Wanneer een contactpersoon wordt toegevoegd |
Wanneer een contactpersoon wordt toegevoegd. Deze trigger werkt alleen als het Freshdesk-account minder dan 100 contactpersonen heeft. |
| Wanneer een ticket dat is toegewezen aan een agent wordt bijgewerkt |
Wanneer een ticket dat is toegewezen aan de geselecteerde agent, wordt bijgewerkt. |
| Wanneer een ticket wordt bijgewerkt |
Wanneer een ticket wordt bijgewerkt. |
| Wanneer een ticket wordt gemaakt |
Wanneer er een ticket wordt gemaakt. |
Wanneer de status van een ticket verandert
Wanneer de status van het ticket wordt gewijzigd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | True | integer |
De ticket-id. |
|
Nieuwe status
|
status | string |
De nieuwe status van het ticket. |
Retouren
Wanneer een agent wordt toegevoegd
Wanneer een agent wordt toegevoegd (alleen voor beheerdersgebruik). Deze trigger werkt alleen als het Freshdesk-account minder dan 100 agents heeft.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | integer |
identiteitskaart |
|
Ticketbereik
|
ticket_scope | integer |
Ticketmachtiging van de agent. |
|
Gemaakt op
|
created_at | date-time |
Tijdstempel voor het maken van agents (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
Bijgewerkt op
|
updated_at | date-time |
Agent heeft de tijdstempel bijgewerkt (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
Active
|
contact.active | boolean |
Ingesteld op waar als de agent is geverifieerd. |
|
E-mailen
|
contact.email | string |
E-mailadres van de agent. |
|
Functietitel
|
contact.job_title | string |
Functie van de agent. |
|
Language
|
contact.language | string |
Taal van de agent. |
|
Laatste aanmelding bij
|
contact.last_login_at | date-time |
Tijdstempel van de laatste geslaagde aanmelding van de agent (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
Mobiel
|
contact.mobile | string |
Mobiel nummer van de agent. |
|
Naam
|
contact.name | string |
Naam van de agent. |
|
Telefoon
|
contact.phone | string |
Telefoonnummer van de agent. |
|
Tijdzone
|
contact.time_zone | string |
Tijdzone van de agent. |
|
Gemaakt op
|
contact.created_at | date-time |
Tijdstempel van agent maken (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
Bijgewerkt op
|
contact.updated_at | date-time |
Tijdstempel van de laatste update naar de agent (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
Wanneer een contactpersoon wordt toegevoegd
Wanneer een contactpersoon wordt toegevoegd. Deze trigger werkt alleen als het Freshdesk-account minder dan 100 contactpersonen heeft.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Active
|
active | boolean |
Ingesteld op waar als de contactpersoon is geverifieerd. |
|
Adres
|
address | string |
Adres van de contactpersoon. |
|
Bedrijfs-id
|
company_id | integer |
Id van het bedrijf waartoe deze contactpersoon behoort. |
|
Description
|
description | string |
Een korte beschrijving van de contactpersoon. |
|
E-mailen
|
string |
Primair e-mailadres van de contactpersoon. |
|
|
Identiteitsbewijs
|
id | integer |
Id van de contactpersoon. |
|
Functietitel
|
job_title | string |
Functie van de contactpersoon. |
|
Language
|
language | string |
Taal van de contactpersoon. |
|
Mobiel
|
mobile | string |
Mobiel nummer van de contactpersoon. |
|
Naam
|
name | string |
Naam van de contactpersoon. |
|
Telefoon
|
phone | string |
Telefoonnummer van de contactpersoon. |
|
Tijdzone
|
time_zone | string |
Tijdzone waarin de contactpersoon zich bevindt. |
|
Twitter-id
|
twitter_id | string |
Twitter-ingang van de contactpersoon. |
|
Gemaakt op
|
created_at | date-time |
Tijdstempel voor het maken van contactpersonen (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
Bijgewerkt op
|
updated_at | date-time |
Neem contact op met bijgewerkte tijdstempel (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
Wanneer een ticket dat is toegewezen aan een agent wordt bijgewerkt
Wanneer een ticket dat is toegewezen aan de geselecteerde agent, wordt bijgewerkt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Agent-id
|
agentId | True | integer |
De agent-id. |
|
Beschrijving opnemen
|
includeDescription | boolean |
Als het antwoord van de trigger de beschrijving bevat. |
Retouren
Wanneer een ticket wordt bijgewerkt
Wanneer een ticket wordt bijgewerkt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Ticket-id
|
ticketId | integer |
De ticket-id. |
|
|
Beschrijving opnemen
|
includeDescription | boolean |
Als het antwoord van de trigger de beschrijving bevat. |
Retouren
Wanneer een ticket wordt gemaakt
Wanneer er een ticket wordt gemaakt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Beschrijving opnemen
|
includeDescription | boolean |
Als het antwoord van de trigger de beschrijving bevat. |
Retouren
Definities
CreateTicket200Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Spam
|
spam | boolean |
Ingesteld op Waar als het ticket is gemarkeerd als spam. |
|
Priority
|
priority | string |
Prioriteit van het ticket. |
|
Aanvrager-id
|
requester_id | integer |
Gebruikers-id van de aanvrager. |
|
Agent-id
|
responder_id | integer |
Id van de agent aan wie het ticket is toegewezen. |
|
Bron
|
source | string |
Het kanaal waarmee het ticket is gemaakt. |
|
Toestand
|
status | string |
Status van het ticket. |
|
Onderwerp
|
subject | string |
Onderwerp van het ticket. |
|
Ticket-id
|
id | integer |
De unieke id van het ticket. |
|
Typologie
|
type | string |
Helpt bij het categoriseren van het ticket op basis van de verschillende soorten problemen waarmee uw ondersteuningsteam te maken krijgt. |
|
Einddatum
|
due_by | date-time |
Tijdstempel die aangeeft wanneer het ticket moet worden omgezet (in indeling jjjj-MM-ddTHH:mm:ssZ). |
|
Is geëscaleerd
|
is_escalated | boolean |
Ingesteld op Waar als het ticket om welke reden dan ook is geëscaleerd. |
|
Description
|
description | string |
HTML-inhoud van het ticket. |
|
Beschrijvingstekst
|
description_text | string |
Inhoud van het ticket in tekst zonder opmaak. |
|
Gemaakt op
|
created_at | date-time |
Tijdstempel voor het maken van tickets (in formaat jjjj-MM-ddTHH:mm:ssZ). |
|
Bijgewerkt op
|
updated_at | date-time |
Ticket bijgewerkt tijdstempel (in indeling jjjj-MM-ddTHH:mm:ssZ). |
|
Verwijderd
|
deleted | boolean |
Ingesteld op Waar als het ticket is verwijderd. |
AddNote200Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Privé
|
private | boolean |
Ingesteld op Waar als de notitie privé is. |
|
Content
|
body | string |
Inhoud van de notitie in HTML. |
|
Inhoudstekst
|
body_text | string |
Inhoud van de notitie in tekst zonder opmaak. |
|
Ticket-id
|
ticket_id | integer |
Id van het ticket waaraan deze notitie wordt toegevoegd. |
|
Gemaakt op
|
created_at | date-time |
Noteer tijdstempel voor het maken (in de notatie jjjj-MM-ddTHH:mm:ssZ). |
|
Bijwerken op
|
updated_at | date-time |
Noteer bijgewerkte tijdstempel (in notatie jjjj-MM-ddTHH:mm:ssZ). |