Freigeben über


Freshservice (Vorschau)

Freshservice ist eine cloudbasierte IT-Service Desk- und Dienstverwaltungslösung, die einfach eingerichtet und verwendet werden kann, um die Mitarbeitererfahrung in der gesamten Organisation zu transformieren.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - 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 Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Freshworks-App-Unterstützung
URL https://www.freshworks.com
Email appsupport-ex@freshworks.com
Connectormetadaten
Herausgeber Microsoft
Webseite https://www.freshworks.com/freshservice/lp/home/
Datenschutzrichtlinie https://www.freshworks.com/privacy
Kategorien IT-Vorgänge

Authentifizierung

Von Bedeutung

Die benutzername- und kennwortbasierte Authentifizierung wird vom FreshService nicht mehr unterstützt. Der Connector unterstützt jetzt nur einen Authentifizierungstyp – API-Schlüssel. FreshService-API-Migrationsdokumente

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

API-Schlüssel API-Schlüsselauthentifizierungstyp Alle Regionen Nicht teilbar
Standard [VERALTET] Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Alle Regionen Nicht teilbar

API-Schlüssel

Authentifizierungs-ID: Einfach

Anwendbar: Alle Regionen

API-Schlüsselauthentifizierungstyp

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
API-Schlüssel Schnur Der API-Schlüssel für diese API Richtig
Website-URL Schnur Stammwebsite-URL (Beispiel: https://sample.freshservice.com ) Richtig

Standard [VERALTET]

Anwendbar: Alle Regionen

Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.

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
Nutzername Schnur Der Benutzername für diese API Richtig
Kennwort securestring Das Kennwort für diese API Richtig
Website-URL Schnur Stammwebsite-URL (Beispiel: https://sample.freshservice.com ) Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden
Häufigkeit der Triggerumfragen 1 120 Sekunden

Aktionen

Aktualisieren eines Tickets (V2)

Aktualisieren eines Tickets (nur angegebene Werte werden aktualisiert).

Aktualisieren eines Tickets [VERALTET]

Aktualisieren eines Tickets (nur angegebene Werte werden aktualisiert).

Erstellen eines Tickets (V2)

Erstellen Sie ein Ticket.

Erstellen eines Tickets [VERALTET]

Erstellen Sie ein Ticket.

Hinzufügen einer Notiz zu einem Ticket (V2)

Fügen Sie einem Ticket eine private oder öffentliche Notiz hinzu.

Hinzufügen einer Notiz zu einem Ticket [VERALTET]

Fügen Sie einem Ticket eine private oder öffentliche Notiz hinzu.

Aktualisieren eines Tickets (V2)

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.

Anforderungs-ID
requester_id integer

Benutzer-ID des Anforderers. Bei vorhandenen Kontakten können requester_id anstelle von E-Mails übergeben werden.

Betreff
subject string

Der Betreff des Tickets.

Der Status
status string

Status des Tickets.

Priority
priority string

Die Priorität des Tickets (z. B. Niedrig, Mittel oder Hoch).

Dringlichkeit
urgency string

Dringlichkeit des Problems (z. B. Niedrig, Mittel oder Hoch).

Auswirkung
impact string

Auswirkungen des Problems (z. B. Niedrig, Mittel oder Hoch).

Quelle
source string

Der Kanal, über den das Ticket erstellt wurde.

Gibt zurück

Aktualisieren eines Tickets [VERALTET]

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.

Anforderungs-ID
requester_id integer

Benutzer-ID des Anforderers. Bei vorhandenen Kontakten können requester_id anstelle von E-Mails übergeben werden.

Betreff
subject string

Der Betreff des Tickets.

Der Status
status string

Status des Tickets.

Priority
priority string

Die Priorität des Tickets (z. B. Niedrig, Mittel oder Hoch).

Dringlichkeit
urgency string

Dringlichkeit des Problems (z. B. Niedrig, Mittel oder Hoch).

Auswirkung
impact string

Auswirkungen des Problems (z. B. Niedrig, Mittel oder Hoch).

Quelle
source string

Der Kanal, über den das Ticket erstellt wurde.

Gibt zurück

Erstellen eines Tickets (V2)

Erstellen Sie ein Ticket.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anforderungs-ID
requester_id integer

Benutzer-ID des Anforderers. Eine der Anforderungs-ID, E-Mail- und Anforderungstelefon des Antragstellers ist erforderlich.

E-Mail-Adresse des Antragstellers
email string

E-Mail des Antragstellers. Eine der Anforderungs-ID, E-Mail- und Anforderungstelefon des Antragstellers ist erforderlich.

Requester Phone
phone string

Telefonnummer des Antragstellers. Eine der Anforderungs-ID, E-Mail- und Anforderungstelefon des Antragstellers ist erforderlich.

Antragstellername
name string

Name des Anforderers. Dies ist nur ein Pflichtfeld, wenn der Wert "Requester Phone" angegeben wird.

Betreff
subject True string

Der Betreff des Tickets.

Der Status
status True string

Status des Tickets.

Priority
priority True string

Die Priorität des Tickets (z. B. Niedrig, Mittel oder Hoch).

Description
description True string

Die Beschreibung des Tickets.

Dringlichkeit
urgency string

Dringlichkeit des Problems (z. B. Niedrig, Mittel oder Hoch).

Auswirkung
impact string

Auswirkungen des Problems (z. B. Niedrig, Mittel oder Hoch).

Quelle
source string

Der Kanal, über den das Ticket erstellt wurde.

Gibt zurück

Erstellen eines Tickets [VERALTET]

Erstellen Sie ein Ticket.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Anforderungs-ID
requester_id True integer

Benutzer-ID des Anforderers. Bei vorhandenen Kontakten können requester_id anstelle von E-Mails übergeben werden.

Betreff
subject True string

Der Betreff des Tickets.

Der Status
status True string

Status des Tickets.

Priority
priority True string

Die Priorität des Tickets (z. B. Niedrig, Mittel oder Hoch).

Description
description True string

Die Beschreibung des Tickets.

Dringlichkeit
urgency string

Dringlichkeit des Problems (z. B. Niedrig, Mittel oder Hoch).

Auswirkung
impact string

Auswirkungen des Problems (z. B. Niedrig, Mittel oder Hoch).

Quelle
source string

Der Kanal, über den das Ticket erstellt wurde.

Gibt zurück

Name Pfad Typ Beschreibung
helpdesk_ticket
item.helpdesk_ticket Ticket_Response

Hinzufügen einer Notiz zu einem Ticket (V2)

Fügen Sie einem Ticket eine private oder öffentliche Notiz hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ticket-ID
ticketId True integer

Die zu aktualisierende Ticket-ID.

Hinweis
body True string

Die Notiz, die dem Ticket hinzugefügt werden soll.

Ist privat
private boolean

Auf "true" festgelegt, wenn die Nachricht privat ist.

Gibt zurück

Hinzufügen einer Notiz zu einem Ticket [VERALTET]

Fügen Sie einem Ticket eine private oder öffentliche Notiz hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ticket-ID
ticketId True integer

Die zu aktualisierende Ticket-ID.

Hinweis
body True string

Die Notiz, die dem Ticket hinzugefügt werden soll.

Ist privat
private boolean

Auf "true" festgelegt, wenn die Nachricht privat ist.

Gibt zurück

Trigger

Beim Erstellen eines Tickets (V2)

Wird ausgelöst, wenn ein neues Ticket erstellt wird.

Wenn ein Ticket erstellt wird [VERALTET]

Wird ausgelöst, wenn ein neues Ticket erstellt wird.

Beim Erstellen eines Tickets (V2)

Wird ausgelöst, wenn ein neues Ticket erstellt wird.

Gibt zurück

Wenn ein Ticket erstellt wird [VERALTET]

Wird ausgelöst, wenn ein neues Ticket erstellt wird.

Gibt zurück

Definitionen

Ticket_Response

Name Pfad Typ Beschreibung
Erstellt am Date-Time
created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Ist gelöscht
deleted boolean

Legen Sie "true" fest, wenn das Ticket gelöscht/in den Papierkorb verschoben wird. Gelöschte Tickets werden in keiner Ansicht mit Ausnahme des Filters "gelöscht" berücksichtigt.

Abteilungs-ID
department_id_value integer
Ticket-ID
display_id integer

Ticket-ID, die für Ihr Konto spezifisch ist.

Fällig von Date-Time
due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Gruppen-ID
group_id integer

ID der Gruppe, der das Ticket zugewiesen ist.

Id
id integer

Eindeutige ID des Tickets.

Auswirkung
impact integer

Eine Zahl, die die Auswirkungen des Problems darstellt.

Wurde eskaliert
isescalated boolean

Auf "true" festgelegt, wenn eine Eskalation gesendet wurde.

Inhaber-ID
owner_id string

ID des Agents, dem das Problem zugewiesen ist.

Priority
priority integer

Eine Zahl, die die Priorität des Tickets darstellt.

Anforderungs-ID
requester_id integer

Benutzer-ID des Anforderers. Bei vorhandenen Kontakten können requester_id anstelle von E-Mails übergeben werden.

Responder-ID
responder_id integer

ID des Agenten, dem das Ticket zugewiesen ist.

Quelle
source integer

Eine Nummer, die den Kanal darstellt, über den das Ticket erstellt wurde.

Spam-Nachricht
spam boolean

Legen Sie "true" fest, wenn das Ticket als Spam gekennzeichnet ist.

Der Status
status integer

Eine Zahl, die den Status des Tickets darstellt.

Betreff
subject string

Ticketbetreff.

Tickettyp
ticket_type string

Type property field as defined in ticket fields.

An E-Mail
to_email string

E-Mail-Adresse, an die die eingehende Ticket-E-Mail gesendet wurde.

Aktualisiert am Date-Time
updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Dringlichkeit
urgency integer

Eine Zahl, die die Dringlichkeit des Problems darstellt.

Description
description string

Beschreibung des Problems.

Beschreibungs-HTML
description_html string

HTML-Inhalt des Tickets. Beschreibung und description_html sollten nicht zusammengepasst werden.

Statusname
status_name string

Status des Tickets.

Prioritätsname
priority_name string

Priorität des Tickets.

Quellenname
source_name string

Der Kanal, über den das Ticket erstellt wurde.

Name des Antwortenden
responder_name string

Name des Agenten, dem das Ticket zugewiesen ist.

An E-Mails
to_emails array of string

E-Mail-Adressen, an die die eingehende Ticket-E-Mail gesendet wurde.

Abteilungsname
department_name string

Name der Abteilung.

Zugeordnete Problem-ID
assoc_problem_id integer

ID des zugehörigen Problems für das Ticket.

Zugeordnete Änderungs-ID
assoc_change_id integer

ID der zugeordneten Änderung an dem Problem.

Zugeordnete Änderungsursachen-ID
assoc_change_cause_id integer

ID der Änderung, die das Ticket verursacht.

Zugeordnete Objekt-ID
assoc_asset_id integer

DIE ID der Ressource, die dem Ticket zugeordnet ist.

Dringlichkeitsname
urgency_name string

Dringlichkeit des Problems.

Auswirkungsname
impact_name string

Auswirkungen des Problems.

CreateUpdateTicket_ResponseV2

Name Pfad Typ Beschreibung
Erstellt am Date-Time
ticket.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Abteilungs-ID
ticket.department_id integer
Fällig von Date-Time
ticket.due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Gruppen-ID
ticket.group_id integer

ID der Gruppe, der das Ticket zugewiesen ist.

Id
ticket.id integer

Eindeutige ID des Tickets.

Wurde eskaliert
ticket.is_escalated boolean

Auf "true" festgelegt, wenn eine Eskalation gesendet wurde.

Priority
ticket.priority integer

Eine Zahl, die die Priorität des Tickets darstellt.

Anforderungs-ID
ticket.requester_id integer

Benutzer-ID des Anforderers. Bei vorhandenen Kontakten können requester_id anstelle von E-Mails übergeben werden.

Responder-ID
ticket.responder_id integer

ID des Agenten, dem das Ticket zugewiesen ist.

Quelle
ticket.source integer

Eine Nummer, die den Kanal darstellt, über den das Ticket erstellt wurde.

Spam-Nachricht
ticket.spam boolean

Legen Sie "true" fest, wenn das Ticket als Spam gekennzeichnet ist.

Der Status
ticket.status integer

Eine Zahl, die den Status des Tickets darstellt.

Betreff
ticket.subject string

Ticketbetreff.

Tickettyp
ticket.type string

Type property field as defined in ticket fields.

Aktualisiert am Date-Time
ticket.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Description
ticket.description_text string

Beschreibung des Problems.

Beschreibungs-HTML
ticket.description string

HTML-Inhalt des Tickets. Beschreibung und description_html sollten nicht zusammengepasst werden.

An E-Mails
ticket.to_emails array of string

E-Mail-Adressen, an die die eingehende Ticket-E-Mail gesendet wurde.

ListTicket_ResponseV2

Name Pfad Typ Beschreibung
Erstellt am Date-Time
created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Abteilungs-ID
department_id integer
Fällig von Date-Time
due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Gruppen-ID
group_id integer

ID der Gruppe, der das Ticket zugewiesen ist.

Id
id integer

Eindeutige ID des Tickets.

Wurde eskaliert
is_escalated boolean

Auf "true" festgelegt, wenn eine Eskalation gesendet wurde.

Priority
priority integer

Eine Zahl, die die Priorität des Tickets darstellt.

Anforderungs-ID
requester_id integer

Benutzer-ID des Anforderers. Bei vorhandenen Kontakten können requester_id anstelle von E-Mails übergeben werden.

Responder-ID
responder_id integer

ID des Agenten, dem das Ticket zugewiesen ist.

Quelle
source integer

Eine Nummer, die den Kanal darstellt, über den das Ticket erstellt wurde.

Spam-Nachricht
spam boolean

Legen Sie "true" fest, wenn das Ticket als Spam gekennzeichnet ist.

Der Status
status integer

Eine Zahl, die den Status des Tickets darstellt.

Betreff
subject string

Ticketbetreff.

Tickettyp
type string

Type property field as defined in ticket fields.

Aktualisiert am Date-Time
updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Description
description_text string

Beschreibung des Problems.

Beschreibungs-HTML
description string

HTML-Inhalt des Tickets. Beschreibung und description_html sollten nicht zusammengepasst werden.

An E-Mails
to_emails array of string

E-Mail-Adressen, an die die eingehende Ticket-E-Mail gesendet wurde.

UpdateTicket_Response

Name Pfad Typ Beschreibung
Ist gelöscht
ticket.deleted boolean

Legen Sie "true" fest, wenn das Ticket gelöscht/in den Papierkorb verschoben wird. Gelöschte Tickets werden in keiner Ansicht mit Ausnahme des Filters "gelöscht" berücksichtigt.

Ticket-ID
ticket.display_id integer

Ticket-ID, die für Ihr Konto spezifisch ist.

Betreff
ticket.subject string

Ticketbetreff.

Description
ticket.description string

Beschreibung des Tickets.

Beschreibungs-HTML
ticket.description_html string

HTML-Inhalt des Tickets. Beschreibung und description_html sollten nicht zusammengepasst werden.

Statusname
ticket.status_name string

Status des Tickets.

Prioritätsname
ticket.priority_name string

Priorität des Tickets.

Quellenname
ticket.source_name string

Der Kanal, über den das Ticket erstellt wurde.

Name des Antwortenden
ticket.responder_name string

Name des Agenten, dem das Ticket zugewiesen ist.

An E-Mails
ticket.to_emails array of string

E-Mail-Adressen, an die die eingehende Ticket-E-Mail gesendet wurde.

Abteilungsname
ticket.department_name string

Name der Abteilung.

Zugeordnete Problem-ID
ticket.assoc_problem_id integer

ID des zugehörigen Problems für das Ticket.

Zugeordnete Änderungs-ID
ticket.assoc_change_id integer

ID der zugeordneten Änderung an dem Problem.

Zugeordnete Änderungsursachen-ID
ticket.assoc_change_cause_id integer

ID der Änderung, die das Ticket verursacht.

Zugeordnete Objekt-ID
ticket.assoc_asset_id integer

DIE ID der Ressource, die dem Ticket zugeordnet ist.

Dringlichkeitsname
ticket.urgency_name string

Dringlichkeit des Problems.

Auswirkungsname
ticket.impact_name string

Auswirkungen des Problems.

AddNote_Response

Name Pfad Typ Beschreibung
Erstellt am Date-Time
note.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Ist gelöscht
note.deleted boolean

Legen Sie "true" fest, wenn das Ticket gelöscht/in den Papierkorb verschoben wird. Gelöschte Tickets werden in keiner Ansicht mit Ausnahme des Filters "gelöscht" berücksichtigt.

Id
note.id integer

Eindeutige ID der Notiz.

Privat
note.private boolean

Legen Sie "true" fest, wenn die Notiz privat ist.

Quelle
note.source integer

Eine Nummer, die den Kanal darstellt, über den das Ticket erstellt wurde.

Aktualisiert am Date-Time
note.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Benutzer-ID
note.user_id integer

User_id des Agenten, der die Notiz hinzufügt.

Body
note.body string

Inhalt der Notiz in Nur-Text.

Textkörper-HTML
note.body_html string

Inhalt der Notiz im HTML-Format. Textkörper oder body_html müssen übergeben werden.

attachments
note.attachments array of string

AddNote_ResponseV2

Name Pfad Typ Beschreibung
Erstellt am Date-Time
conversation.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Id
conversation.id integer

Eindeutige ID der Notiz.

Privat
conversation.private boolean

Legen Sie "true" fest, wenn die Notiz privat ist.

Aktualisiert am Date-Time
conversation.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Benutzer-ID
conversation.user_id integer

User_id des Agenten, der die Notiz hinzufügt.

Body
conversation.body_text string

Inhalt der Notiz in Nur-Text.

Textkörper-HTML
conversation.body string

Inhalt der Notiz im HTML-Format. Textkörper oder body_html müssen übergeben werden.

attachments
conversation.attachments array of string
Ticket-ID
conversation.ticket_id integer

Eindeutige ID des Tickets.