Freshdesk
Freshdesk ist eine cloudbasierte Kundensupportlösung, die Ihnen hilft, Ihren Kundenservice zu optimieren und sicherzustellen, dass Ihre Kunden den gewünschten Support erhalten! Der Freshdesk-Connector ist für Freshdesk-Agents zum Verwalten von Tickets und Kontakten vorgesehen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps-Unterstützung Microsoft Power Automate-Support Microsoft Power Apps-Unterstützung |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://freshdesk.com/ |
| Datenschutzrichtlinie | https://www.freshworks.com/privacy/ |
Bekannte Probleme und Einschränkungen
- Für Trigger "Wenn ein Ticket erstellt wird", "Wenn ein Ticket, das einem Agent zugewiesen ist, aktualisiert wird", wird die Beschreibung des Tickets in der Antwort nicht standardmäßig zurückgegeben. Sie können angeben, dass sie in die Triggerantwort eingeschlossen wird, indem Sie den Parameter "Include description" auf "Yes" festlegen. Beachten Sie jedoch, dass dies mit zusätzlichen Kosten für Ihr Konto auf Freshdesk-Seite verbunden ist, da das Einbetten in diesem Fall verwendet wird. Wenn Sie die Beschreibung des Tickets benötigen, empfehlen wir die Verwendung des Triggers in Kombination mit der Aktion "Ticket abrufen", da die Antwort dieser Aktion standardmäßig die Beschreibung enthält.
- Die Erstellung des Tickettyps "Service Task" wird derzeit nicht unterstützt.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Konto-URL | Schnur | Beispiel: https://company.freshdesk.com | Richtig |
| E-Mail- oder API-Schlüssel (https://aka.ms/ii9u75) | Schnur | Ihre E-Mail-Adresse | Richtig |
| Kennwort | securestring | Kennwort (bei Verwendung des API-Schlüssels kann ein beliebiger Wert angegeben werden) | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
| Häufigkeit der Triggerumfragen | 1 | 15 Sekunden |
Aktionen
| Aktualisieren eines Tickets |
Aktualisieren eines Tickets (nur angegebene Werte werden aktualisiert). |
| Erstellen eines Tickets |
Erstellen Sie ein Ticket. |
| Hinzufügen einer Notiz zu einem Ticket |
Fügen Sie einem Ticket eine private oder öffentliche Notiz hinzu. |
| Ticket abrufen |
Rufen Sie ein Ticket nach ID ab. |
Aktualisieren eines Tickets
Aktualisieren eines Tickets (nur angegebene Werte werden aktualisiert).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | integer |
Die zu aktualisierende Ticket-ID. |
|
Description
|
description | string |
Die Ticketbeschreibung. |
|
|
Betreff
|
subject | string |
Der Betreff des Tickets. |
|
|
Priority
|
priority | string |
Die Priorität des Tickets. |
|
|
Der Status
|
status | string |
Der Status des Tickets. |
|
|
Typ
|
type | string |
Hilft beim Kategorisieren des Tickets gemäß den verschiedenen Arten von Problemen, mit denen Ihr Supportteam beschäftigt. |
|
|
Fällig am
|
due_by | date-time |
Zeitstempel, der angibt, wann das Ticket aufgelöst werden soll (im Format jjjj-MM-ddTHH:mm:ssZ). |
|
|
Vertreter
|
responder_id | integer |
Der Vertreter des Tickets. |
Gibt zurück
Erstellen eines Tickets
Erstellen Sie ein Ticket.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Betreff
|
subject | True | string |
Der Betreff für das Ticket. |
|
Description
|
description | True | string |
Die Beschreibung für das Ticket. |
|
Email
|
True | string |
Die E-Mail des Antragstellers. |
|
|
Priority
|
priority | True | string |
Die Priorität für das Ticket. |
|
Der Status
|
status | True | string |
Der Status des Tickets. |
|
Typ
|
type | string |
Hilft beim Kategorisieren des Tickets gemäß den verschiedenen Arten von Problemen, mit denen Ihr Supportteam beschäftigt. |
|
|
Fällig am
|
due_by | date-time |
Zeitstempel, der angibt, wann das Ticket aufgelöst werden soll (im Format jjjj-MM-ddTHH:mm:ssZ). |
|
|
First Response Due By
|
fr_due_by | date-time |
Zeitstempel, der angibt, wann die erste Antwort fällig ist (im Format jjjj-MM-ddTHH:mm:ssZ). |
|
|
Vertreter
|
responder_id | integer |
Der Vertreter des Tickets. |
|
|
Produkt
|
product_id | integer |
Das Produkt, in dem das Ticket enthalten sein sollte (nur für Administratorverwendung). |
Gibt zurück
Hinzufügen einer Notiz zu einem Ticket
Fügen Sie einem Ticket eine private oder öffentliche Notiz hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | integer |
Die Ticket-ID, der eine Notiz hinzugefügt werden soll. |
|
Content
|
body | True | string |
Der Inhalt der Notiz. |
|
Privat
|
private | boolean |
Gibt an, ob es sich um eine private Notiz handelt (Standard ist true). |
Gibt zurück
- Body
- AddNote200Response
Ticket abrufen
Rufen Sie ein Ticket nach ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | string |
Die Ticket-ID. |
Gibt zurück
Trigger
| Beim Erstellen eines Tickets |
Wenn ein Ticket erstellt wird. |
| Wenn ein Agent hinzugefügt wird |
Wenn ein Agent hinzugefügt wird (nur für Administratoren). Dieser Trigger funktioniert nur, wenn das Freshdesk-Konto weniger als 100 Agents hat. |
| Wenn ein Kontakt hinzugefügt wird |
Wenn ein Kontakt hinzugefügt wird. Dieser Trigger funktioniert nur, wenn das Freshdesk-Konto weniger als 100 Kontakte hat. |
| Wenn ein Ticket, das einem Agent zugewiesen ist, aktualisiert wird |
Wenn ein Ticket, das dem ausgewählten Agent zugewiesen ist, aktualisiert wird. |
| Wenn ein Ticket aktualisiert wird |
Wenn ein Ticket aktualisiert wird. |
| Wenn sich ein Ticketstatus ändert |
Wenn sich der Status des Tickets ändert. |
Beim Erstellen eines Tickets
Wenn ein Ticket erstellt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Beschreibung einschließen
|
includeDescription | boolean |
Sollte die Antwort des Triggers die Beschreibung enthalten. |
Gibt zurück
Wenn ein Agent hinzugefügt wird
Wenn ein Agent hinzugefügt wird (nur für Administratoren). Dieser Trigger funktioniert nur, wenn das Freshdesk-Konto weniger als 100 Agents hat.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | integer |
id |
|
Ticketbereich
|
ticket_scope | integer |
Ticketberechtigung des Agents. |
|
Erstellt unter
|
created_at | date-time |
Zeitstempel für die Agenterstellung (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualisiert unter
|
updated_at | date-time |
Agent aktualisiert Zeitstempel (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Active
|
contact.active | boolean |
Auf "true" festgelegt, wenn der Agent überprüft wird. |
|
Email
|
contact.email | string |
E-Mail-Adresse des Agents. |
|
Position
|
contact.job_title | string |
Position des Agenten. |
|
Language
|
contact.language | string |
Sprache des Agenten. |
|
Letzte Anmeldung bei
|
contact.last_login_at | date-time |
Zeitstempel der letzten erfolgreichen Anmeldung des Agenten (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Mobiltelefon
|
contact.mobile | string |
Mobiltelefonnummer des Agents. |
|
Name
|
contact.name | string |
Name des Agents. |
|
Telefonnummer
|
contact.phone | string |
Telefonnummer des Agenten. |
|
Zeitzone
|
contact.time_zone | string |
Zeitzone des Agents. |
|
Erstellt unter
|
contact.created_at | date-time |
Zeitstempel für die Agenterstellung (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualisiert unter
|
contact.updated_at | date-time |
Zeitstempel der letzten Aktualisierung an den Agent (im Format yyyy-MM-ddTHH:mm:ssZ). |
Wenn ein Kontakt hinzugefügt wird
Wenn ein Kontakt hinzugefügt wird. Dieser Trigger funktioniert nur, wenn das Freshdesk-Konto weniger als 100 Kontakte hat.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Active
|
active | boolean |
Auf "true" festgelegt, wenn der Kontakt überprüft wurde. |
|
Adresse
|
address | string |
Adresse des Kontakts. |
|
Firmen-ID
|
company_id | integer |
Id des Unternehmens, zu dem dieser Kontakt gehört. |
|
Description
|
description | string |
Eine kurze Beschreibung des Kontakts. |
|
Email
|
string |
Primäre E-Mail-Adresse des Kontakts. |
|
|
Id
|
id | integer |
ID des Kontakts. |
|
Position
|
job_title | string |
Position des Kontakts. |
|
Language
|
language | string |
Sprache des Kontakts. |
|
Mobiltelefon
|
mobile | string |
Mobiltelefonnummer des Kontakts. |
|
Name
|
name | string |
Name des Kontakts. |
|
Telefonnummer
|
phone | string |
Telefonnummer des Kontakts. |
|
Zeitzone
|
time_zone | string |
Zeitzone, in der sich der Kontakt befindet. |
|
Twitter-ID
|
twitter_id | string |
Twitter Handle des Kontakts. |
|
Erstellt unter
|
created_at | date-time |
Zeitstempel für die Kontakterstellung (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualisiert unter
|
updated_at | date-time |
Kontakt aktualisierten Zeitstempel (im Format yyyy-MM-ddTHH:mm:ssZ). |
Wenn ein Ticket, das einem Agent zugewiesen ist, aktualisiert wird
Wenn ein Ticket, das dem ausgewählten Agent zugewiesen ist, aktualisiert wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Agent-ID
|
agentId | True | integer |
Die Agent-ID. |
|
Beschreibung einschließen
|
includeDescription | boolean |
Sollte die Antwort des Triggers die Beschreibung enthalten. |
Gibt zurück
Wenn ein Ticket aktualisiert wird
Wenn ein Ticket aktualisiert wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | integer |
Die Ticket-ID. |
|
|
Beschreibung einschließen
|
includeDescription | boolean |
Sollte die Antwort des Triggers die Beschreibung enthalten. |
Gibt zurück
Wenn sich ein Ticketstatus ändert
Wenn sich der Status des Tickets ändert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | integer |
Die Ticket-ID. |
|
Neuer Status
|
status | string |
Der neue Status des Tickets. |
Gibt zurück
Definitionen
CreateTicket200Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Spam-Nachricht
|
spam | boolean |
Auf "true" festgelegt, wenn das Ticket als Spam gekennzeichnet wurde. |
|
Priority
|
priority | string |
Priorität des Tickets. |
|
Anforderungs-ID
|
requester_id | integer |
Benutzer-ID des Anforderers. |
|
Agent-ID
|
responder_id | integer |
ID des Agenten, dem das Ticket zugewiesen wurde. |
|
Quelle
|
source | string |
Der Kanal, über den das Ticket erstellt wurde. |
|
Der Status
|
status | string |
Status des Tickets. |
|
Betreff
|
subject | string |
Betreff des Tickets. |
|
Ticket-ID
|
id | integer |
Die eindeutige ID des Tickets. |
|
Typ
|
type | string |
Hilft beim Kategorisieren des Tickets gemäß den verschiedenen Arten von Problemen, mit denen Ihr Supportteam beschäftigt. |
|
Fällig am
|
due_by | date-time |
Zeitstempel, der angibt, wann das Ticket aufgelöst werden soll (im Format jjjj-MM-ddTHH:mm:ssZ). |
|
Wurde eskaliert
|
is_escalated | boolean |
Auf "true" festlegen, wenn das Ticket aus irgendeinem Grund eskaliert wurde. |
|
Description
|
description | string |
HTML-Inhalt des Tickets. |
|
Beschreibungstext
|
description_text | string |
Inhalt des Tickets in Nur-Text. |
|
Erstellt unter
|
created_at | date-time |
Zeitstempel für die Ticketerstellung (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualisiert unter
|
updated_at | date-time |
Ticket aktualisiert Zeitstempel (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Gelöscht
|
deleted | boolean |
Auf "true" festgelegt, wenn das Ticket gelöscht wurde. |
AddNote200Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Privat
|
private | boolean |
Auf "true" festgelegt, wenn die Notiz privat ist. |
|
Content
|
body | string |
Inhalt der Notiz in HTML. |
|
Inhaltstext
|
body_text | string |
Inhalt der Notiz in Nur-Text. |
|
Ticket-ID
|
ticket_id | integer |
ID des Tickets, dem diese Notiz hinzugefügt wird. |
|
Erstellt unter
|
created_at | date-time |
Zeitstempel für die Erstellung von Notizen (im Format yyyy-MM-ddTHH:mm:ssZ). |
|
Aktualisieren unter
|
updated_at | date-time |
Hinweis: Aktualisierter Zeitstempel (im Format yyyy-MM-ddTHH:mm:ssZ). |