Freshworks Freshservice
Integrationsversion: 14.0
Anwendungsbereiche
Integration mit dem Service Desk
Freshservice-Konfiguration
Die Freshservice-Integration von Google Security Operations basiert auf Freshservice-API-Schlüsseln.
API-Schlüssel des Kontos in Freshservice abrufen
- Im Freshservice-Supportportal anmelden
- Klicken Sie oben rechts im Portal auf das Profilbild Ihres Kontos.
- Zur Seite „Profileinstellungen“
- Der Konto-API-Schlüssel wird rechts unter dem Abschnitt „Passwort ändern“ angezeigt.
- Speichern Sie diesen API-Schlüssel. Sie benötigen ihn für die Konfiguration der Google SecOps-Integration.
Freshworks Freshservice-Integration in Google SecOps konfigurieren
Eine detaillierte Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.
Integrationsparameter
Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| API-Stamm | String | https://yourdomain.freshservice.com | Ja | Freshservice-Instanz-API-Stamm-URL. |
| API-Schlüssel | Passwort | – | Ja | Freshservice-API-Schlüssel für die Integration. |
| SSL überprüfen | Kästchen | Aktiviert | Nein | Wenn diese Option aktiviert ist, wird geprüft, ob für die Stamm-URL ein gültiges Zertifikat konfiguriert ist. |
Aktionen
Ping
Beschreibung
Testen Sie die Verbindung zur Freshservice-Instanz mit den Parametern, die auf der Seite mit der Integrationskonfiguration auf dem Tab „Google Security Operations Marketplace“ angegeben sind.
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden, wenn ein kritischer Fehler auftritt, z. B. falsche Anmeldedaten oder Verbindungsverlust: „Failed to connect to the Freshservice instance! Fehler: {0}".format(exception.stacktrace) |
Allgemein |
Tickets auflisten
Beschreibung
Listet Freshservice-Tickets basierend auf den angegebenen Suchkriterien auf. Aktionen funktionieren nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Tickettyp | DDL | Alle | Nein | Geben Sie den zurückzugebenden Tickettyp an. |
| Anforderer | String | – | Nein | Geben Sie die E-Mail-Adresse des Antragstellers der zurückzugebenden Tickets an. |
| Statistiken einbeziehen | Kästchen | Deaktiviert | Nein | Wenn diese Option aktiviert ist, werden zusätzliche Statistiken zu den Tickets zurückgegeben. |
| Nach den letzten X Stunden suchen | Ganzzahl | – | Nein | Geben Sie den Zeitraum an, in dem nach Tickets gesucht werden soll. |
| Zeilen pro Seite | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Tickets pro Seite für die Freshservice-Paginierung zurückgegeben werden sollen. |
| Beginnen auf Seite | Ganzzahl | 1 | Nein | Geben Sie an, ab welcher Seite Tickets mit der Freshservice-Paginierung zurückgegeben werden sollen. |
| Maximale Anzahl zurückzugebender Zeilen | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Tickets insgesamt zurückgegeben werden sollen. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"tickets": [
{
"subject": "Support Needed...",
"group_id": null,
"department_id": null,
"category": null,
"sub_category": null,
"item_category": null,
"requester_id": 17000032840,
"responder_id": null,
"due_by": "2021-07-08T21:00:00Z",
"fr_escalated": false,
"deleted": false,
"spam": false,
"email_config_id": null,
"fwd_emails": [],
"reply_cc_emails": [],
"cc_emails": [],
"is_escalated": false,
"fr_due_by": "2021-07-01T18:00:00Z",
"id": 7,
"priority": 1,
"status": 2,
"source": 2,
"created_at": "2021-06-29T08:56:24Z",
"updated_at": "2021-06-29T10:04:51Z",
"to_emails": null,
"type": "Incident",
"description": "<div>Details about the issue...</div>",
"description_text": "Details about the issue...",
"custom_fields": {},
"requester": {
"email": "dana@example.com",
"id": 17000032840,
"mobile": "dana@example.com",
"name": "Dana",
"phone": null
}
}
]
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegenden Fehlern wie falschen Anmeldedaten, keiner Verbindung zum Server oder anderen: „Fehler beim Ausführen der Aktion ‚Tickets auflisten‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
| Tabelle | Tabellenname:Gefundene Freshservice-Tickets Tabellenspalten: ID Typ Betreff Beschreibung E-Mail-Adresse des anfordernden Nutzers Kategorie Status Priorität Quelle Erstellungsdatum Datum der Aktualisierung Fälligkeitsdatum Eskaliert Gelöscht |
Allgemein |
Ticket erstellen
Beschreibung
Freshservice-Ticket erstellen
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Betreff | String | – | Ja | Geben Sie das Betrefffeld für das erstellte Ticket an. |
| Beschreibung | String | – | Ja | Geben Sie das Beschreibungsfeld für das erstellte Ticket an. |
| E-Mail-Adresse des anfordernden Nutzers | String | – | Ja | Geben Sie die E-Mail-Adresse des Antragstellers für das erstellte Ticket an. |
| Agent Assign To | String | – | Nein | Geben Sie die E-Mail-Adresse des Kundenservicemitarbeiters an, dem das Ticket zugewiesen werden soll. |
| Gruppe zuweisen an | String | – | Nein | Geben Sie den Gruppennamen an, dem das Ticket zugewiesen werden soll. |
| Priorität | DDL | Mittel | Ja | Geben Sie die Priorität an, die dem Ticket zugewiesen werden soll. |
| Dringlichkeit | DDL | Mittel | Nein | Geben Sie die Dringlichkeit an, die dem Ticket zugewiesen werden soll. |
| Auswirkungen | DDL | Mittel | Nein | Geben Sie die Auswirkungen an, die dem Ticket zugewiesen werden sollen. |
| Tags | String | – | Nein | Geben Sie die Tags an, die dem Ticket zugewiesen werden sollen. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Ticket hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
| Anzuhängende Dateien | String (CSV) | – | Nein | Geben Sie den vollständigen Pfad für die Datei an, die mit dem Ticket hochgeladen werden soll. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. Die Gesamtgröße der Anhänge darf 15 MB nicht überschreiten. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"ticket": {
"cc_emails": [],
"fwd_emails": [],
"reply_cc_emails": [],
"fr_escalated": false,
"spam": false,
"email_config_id": null,
"group_id": null,
"priority": 2,
"requester_id": 17000032840,
"responder_id": null,
"source": 2,
"status": 2,
"subject": "Support Needed 4...",
"to_emails": null,
"department_id": null,
"id": 10,
"type": "Incident",
"due_by": "2021-07-02T18:00:00Z",
"fr_due_by": "2021-06-30T20:00:00Z",
"is_escalated": false,
"description": "<div>Details about the issue...</div>",
"description_text": "Details about the issue...",
"category": null,
"sub_category": null,
"item_category": null,
"custom_fields": {
"test": "very_test"
},
"created_at": "2021-06-30T08:01:30Z",
"updated_at": "2021-06-30T08:01:30Z",
"tags": [
"test"
],
"attachments": []
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ticket erstellen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Ticket aktualisieren
Beschreibung
Aktualisieren Sie ein Freshservice-Ticket basierend auf den bereitgestellten Aktions-Eingabeparametern. Wenn neue Tags für das Ticket angegeben werden, werden aufgrund der Einschränkungen der Freshservice API vorhandene Tags im Ticket ersetzt und nicht an vorhandene angehängt.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, die aktualisiert werden soll. |
| Status | DDL | Unverändert | Nein | Geben Sie einen neuen Status für das Ticket an. |
| Betreff | String | – | Nein | Geben Sie das zu aktualisierende Betrefffeld an. |
| Beschreibung | String | – | Nein | Geben Sie das zu aktualisierende Beschreibungsfeld an. |
| E-Mail-Adresse des anfordernden Nutzers | String | – | Nein | Geben Sie die E-Mail-Adresse des Antragstellers an, die aktualisiert werden soll. |
| Agent Assign To | String | – | Nein | Geben Sie die E-Mail-Adresse des Agenten an, die aktualisiert werden soll. |
| Gruppe zuweisen an | String | – | Nein | Geben Sie den Namen der Gruppe an, die aktualisiert werden soll. |
| Priorität | DDL | Nicht geändert | Nein | Geben Sie die zu aktualisierende Priorität an. |
| Dringlichkeit | DDL | Nicht geändert | Nein | Geben Sie die Dringlichkeit für die Aktualisierung an. |
| Auswirkungen | DDL | Nicht geändert | Nein | Geben Sie die Auswirkungen an, die aktualisiert werden sollen. |
| Tags | String | – | Nein | Geben Sie die Tags an, die im Ticket ersetzt werden sollen. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. Aufgrund der Freshservice API-Einschränkungen werden vorhandene Tags im Ticket durch die Aktion ersetzt und nicht neue Tags an vorhandene angehängt. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Ticket hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
| Anzuhängende Dateien | String (CSV) | – | Nein | Geben Sie den vollständigen Pfad für die Datei an, die mit dem Ticket hochgeladen werden soll. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. Die Gesamtgröße der Anhänge darf 15 MB nicht überschreiten. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"ticket": {
"cc_emails": [],
"fwd_emails": [],
"reply_cc_emails": [],
"spam": false,
"email_config_id": null,
"fr_escalated": false,
"group_id": 17000034192,
"priority": 1,
"requester_id": 17002188556,
"responder_id": 17002188556,
"source": 2,
"status": 2,
"subject": "Support Needed 9...",
"description": "Details about the issue...",
"description_text": "Details about the issue...",
"category": null,
"sub_category": null,
"item_category": null,
"custom_fields": {
"test": "very_test"
},
"id": 12,
"type": "Incident",
"to_emails": null,
"department_id": 17000016543,
"is_escalated": false,
"tags": [
"test"
],
"due_by": "2021-07-09T17:00:00-04:00",
"fr_due_by": "2021-07-02T14:00:00-04:00",
"created_at": "2021-06-30T08:36:43Z",
"updated_at": "2021-06-30T09:39:12Z",
"attachments": []
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ticket aktualisieren‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Ticketunterhaltungen auflisten
Beschreibung
Listet Freshservice-Tickets-Konversationen basierend auf den angegebenen Suchkriterien auf. Diese Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, für die Unterhaltungen zurückgegeben werden sollen. |
| Zeilen pro Seite | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Ticketunterhaltungen pro Seite für die Freshservice-Paginierung zurückgegeben werden sollen. |
| Beginnen auf Seite | Ganzzahl | 1 | Nein | Geben Sie an, ab welcher Seite Ticketunterhaltungen mit der Freshservice-Paginierung zurückgegeben werden sollen. |
| Maximale Anzahl zurückzugebender Zeilen | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Ticketkonversationen insgesamt zurückgegeben werden sollen. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"conversations": [
{
"id": 17014994010,
"user_id": 17000032840,
"to_emails": [],
"body": "<div>This is a test note!</div>",
"body_text": "This is a test note!",
"ticket_id": 12,
"created_at": "2021-07-05T06:58:32Z",
"updated_at": "2021-07-05T06:58:32Z",
"incoming": false,
"private": false,
"support_email": null,
"source": 2,
"from_email": null,
"cc_emails": [],
"bcc_emails": null,
"attachments": []
},
{
"id": 17014993985,
"user_id": 17000032840,
"to_emails": [
"dana@example.com"
],
"body": "<div>We are working on this issue. Will keep you posted.</div>",
"body_text": "We are working on this issue. Will keep you posted.",
"ticket_id": 12,
"created_at": "2021-07-05T06:57:27Z",
"updated_at": "2021-07-05T06:57:27Z",
"incoming": false,
"private": false,
"support_email": "helpdesk@siemplifyservicedesk.freshservice.com",
"source": 0,
"from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
"cc_emails": [],
"bcc_emails": [],
"attachments": []
}
],
"meta": {
"count": 2
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Tickets anzeigen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
| Tabelle | Tabellenname:Freshservice-Ticket <ticket id> – Unterhaltungen Tabellenspalten: ID Typ Sichtbarkeit E-Mail-Adresse des Nutzers Text From Email E‑Mail-Adresse des Empfängers Cc-E-Mail-Adresse BCC-E-Mail-Adresse |
Allgemein |
Ticketantwort hinzufügen
Beschreibung
Eine Antwort zu einem Freshservice-Ticket hinzufügen Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, für die Unterhaltungen zurückgegeben werden sollen. |
| Antworttext | String | – | Ja | Geben Sie den Antworttext an, der dem Ticket hinzugefügt werden soll. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
"conversation": {
"id": 17014998560,
"user_id": 17000032840,
"from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
"cc_emails": [],
"bcc_emails": [],
"body": "<div>We are working on this issue. Will keep you posted.2</div>",
"body_text": "We are working on this issue. Will keep you posted.2",
"ticket_id": 12,
"to_emails": [
"dana@example.com"
],
"attachments": [],
"created_at": "2021-07-05T09:19:02Z",
"updated_at": "2021-07-05T09:19:02Z"
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ticketantwort hinzufügen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Ticketnotiz hinzufügen
Beschreibung
Freshservice-Ticket eine Notiz hinzufügen Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, für die Unterhaltungen zurückgegeben werden sollen. |
| Notiztyp | DDL | Privat | Nein | Geben Sie an, welche Art von Notizaktion dem Ticket hinzugefügt werden soll. |
| Notiztext | String | – | Ja | Geben Sie den Notiztext an, der dem Ticket hinzugefügt werden soll. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"conversation": {
"id": 17014999107,
"incoming": false,
"private": false,
"user_id": 17000032840,
"support_email": null,
"body": "<div>This is a test note2!</div>",
"body_text": "This is a test note2!",
"ticket_id": 12,
"to_emails": [],
"attachments": [],
"created_at": "2021-07-05T09:35:28Z",
"updated_at": "2021-07-05T09:35:28Z"
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ticketanmerkung hinzufügen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Agents auflisten
Beschreibung
Listet Freshservice-Kundenservicemitarbeiter basierend auf den angegebenen Suchkriterien auf. Aktionen funktionieren nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| E‑Mail-Adresse des Kundenservicemitarbeiters | String | – | Nein | Geben Sie die E‑Mail-Adresse an, für die Agent-Datensätze zurückgegeben werden sollen. |
| Agentenstatus | DDL | ALLE | Nein | Geben Sie die zurückzugebenden Agent-Status an. |
| Inaktive Kundenservicemitarbeiter einbeziehen | Kästchen | Deaktiviert | Nein | Wenn diese Option aktiviert ist, enthalten die Ergebnisse auch Datensätze für inaktive Agents. |
| Zeilen pro Seite | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Agent-Datensätze pro Seite für die Freshservice-Paginierung zurückgegeben werden sollen. |
| Beginnen auf Seite | Ganzzahl | 1 | Nein | Geben Sie an, ab welcher Seite Agent-Datensätze mit der Freshservice-Paginierung zurückgegeben werden sollen. |
| Maximale Anzahl zurückzugebender Zeilen | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Agent-Datensätze insgesamt zurückgegeben werden sollen. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"agents": [
{
"active": true,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2021-06-29T10:37:36Z",
"custom_fields": {},
"department_ids": [
17000016543
],
"email": "dana@example.com",
"external_id": null,
"first_name": "dmitry",
"has_logged_in": false,
"id": 17002188556,
"job_title": null,
"language": "en",
"last_active_at": null,
"last_login_at": null,
"last_name": "s",
"location_id": null,
"mobile_phone_number": null,
"occasional": true,
"reporting_manager_id": null,
"role_ids": [
17000023339
],
"roles": [
{
"role_id": 17000023339,
"assignment_scope": "entire_helpdesk",
"groups": []
}
],
"scopes": {
"ticket": null,
"problem": null,
"change": null,
"asset": null,
"solution": null,
"contract": null
},
"scoreboard_level_id": 1,
"signature": "<p> </p>\n",
"time_format": "12h",
"time_zone": "American Samoa",
"updated_at": "2021-06-29T10:37:36Z",
"work_phone_number": null,
"group_ids": [
17000034192
],
"member_of": [
17000034192
],
"observer_of": []
},
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚List Agents‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Tabelle |
Tabellenname:Freshservice-Kundenservicemitarbeiter gefunden Tabellenspalten: ID Vorname Nachname Rollen Gruppen Abteilungen Standort Aktiv Gelegentlich Benutzerdefinierte Felder Erstellungsdatum Datum der Aktualisierung Datum der letzten Aktivität Datum der letzten Anmeldung |
Allgemein |
Antragsteller auflisten
Beschreibung
Listet Anfragesteller auf, die in Freshservice registriert sind, basierend auf den angegebenen Suchkriterien. Diese Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| E-Mail-Adresse des anfordernden Nutzers | String | – | Nein | Geben Sie die E-Mail-Adresse an, für die Anfragestellerdatensätze zurückgegeben werden sollen. |
| Zeilen pro Seite | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Agent-Datensätze pro Seite für die Freshservice-Paginierung zurückgegeben werden sollen. |
| Beginnen auf Seite | Ganzzahl | 1 | Nein | Geben Sie an, ab welcher Seite Agent-Datensätze mit der Freshservice-Paginierung zurückgegeben werden sollen. |
| Maximale Anzahl zurückzugebender Zeilen | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Agent-Datensätze insgesamt zurückgegeben werden sollen. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"requesters": [
{
"active": true,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2020-07-06T08:07:30Z",
"custom_fields": {
"test": null
},
"department_ids": [],
"external_id": null,
"first_name": "Dana",
"has_logged_in": false,
"id": 17000038164,
"job_title": null,
"language": "en",
"last_name": "Doe",
"location_id": null,
"mobile_phone_number": null,
"primary_email": "dana@example.com",
"reporting_manager_id": null,
"secondary_emails": [],
"time_format": "12h",
"time_zone": "Eastern Time (US & Canada)",
"updated_at": "2020-07-06T08:07:30Z",
"work_phone_number": null
}
]
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚List Requesters‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Tabelle |
Tabellenname:Freshservice-Antragsteller gefunden Tabellenspalten: ID Vorname Nachname Abteilungen Standort Aktiv Benutzerdefinierte Felder Erstellungsdatum Datum der Aktualisierung |
Allgemein |
KI-Agenten erstellen
Beschreibung
Erstellen Sie einen neuen Freshservice-Agenten. Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| String | – | Ja | Geben Sie die E-Mail-Adresse des KI-Agenten an, den Sie erstellen möchten. | |
| Vorname | String | – | Ja | Geben Sie den Vornamen des zu erstellenden Kundenservicemitarbeiters an. |
| Nachname | String | – | Nein | Geben Sie den Nachnamen des zu erstellenden Kundenservicemitarbeiters an. |
| Gelegentlich | Kästchen | Deaktiviert | Nein | Wenn diese Option aktiviert ist, wird der Agent als gelegentlicher Agent erstellt. Andernfalls wird ein Vollzeit-Agent erstellt. |
| Alle Tickets der zugehörigen Abteilungen sehen | Kästchen | Deaktiviert | Nein | Wenn aktiviert, kann der Kundenservicemitarbeiter alle Tickets der zugehörigen Abteilungen sehen. |
| Abteilungen | CSV | – | Nein | Geben Sie die Abteilungsnamen an, die dem Agent zugeordnet sind. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. |
| Standort | String | – | Nein | Geben Sie den mit dem Agent verknüpften Standortnamen an. |
| Gruppenmitgliedschaften | CSV | – | Nein | Geben Sie die Gruppennamen an, denen der Kundenservicemitarbeiter angehören soll. |
| Rollen | CSV | – | Ja | Geben Sie die Rollen an, die dem Agent hinzugefügt werden sollen. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. Beispiel: {"role_id":17000023338,"assignment_scope": ""} |
| Position | String | – | Nein | Geben Sie die Berufsbezeichnung des Kundenservicemitarbeiters an. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Agent hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"agent": {
"active": true,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2021-07-06T05:40:41Z",
"custom_fields": {
"test": "testvalue"
},
"department_ids": [],
"email": "rolanda.hooch@hogwarts.edu",
"external_id": null,
"first_name": "Rolanda",
"has_logged_in": false,
"id": 17002198254,
"job_title": "Flying Instructor",
"language": "en",
"last_active_at": null,
"last_login_at": null,
"last_name": "Hooch",
"location_id": null,
"mobile_phone_number": "553632",
"occasional": true,
"reporting_manager_id": null,
"role_ids": [
17000023338
],
"roles": [
{
"role_id": 17000023338,
"assignment_scope": "entire_helpdesk",
"groups": []
}
],
"scopes": {
"ticket": null,
"problem": null,
"change": null,
"asset": null,
"solution": null,
"contract": null
},
"scoreboard_level_id": 1,
"signature": null,
"time_format": "12h",
"time_zone": "Eastern Time (US & Canada)",
"updated_at": "2021-07-06T05:40:41Z",
"work_phone_number": "443532",
"group_ids": [
17000034192
],
"member_of": [
17000034192
],
"observer_of": []
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Create Agent‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Agent aktualisieren
Beschreibung
Aktualisieren Sie einen vorhandenen Freshservice-Agenten. Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Agent-ID | Ganzzahl | – | Ja | Geben Sie die Agent-ID an, die aktualisiert werden soll. |
| String | – | Nein | Geben Sie die E-Mail-Adresse des zu aktualisierenden Kundenservicemitarbeiters an. | |
| Vorname | String | – | Nein | Geben Sie den Vornamen des zu aktualisierenden Kundenservicemitarbeiters an. |
| Nachname | String | – | Nein | Geben Sie den Nachnamen des zu aktualisierenden Kundenservicemitarbeiters an. |
| Gelegentlich | Kästchen | Deaktiviert | Nein | Wenn diese Option aktiviert ist, wird der Agent als gelegentlicher Agent aktualisiert. Andernfalls ist er ein Vollzeit-Agent. |
| Alle Tickets der zugehörigen Abteilungen sehen | Kästchen | Deaktiviert | Nein | Wenn aktiviert, kann der Kundenservicemitarbeiter alle Tickets der zugehörigen Abteilungen sehen. |
| Abteilungen | CSV | – | Nein | Geben Sie die Abteilungsnamen an, die dem Agent zugeordnet sind. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. |
| Standort | String | – | Nein | Geben Sie den mit dem Agent verknüpften Standortnamen an. |
| Gruppenmitgliedschaften | CSV | – | Nein | Geben Sie die Gruppennamen an, denen der Kundenservicemitarbeiter angehören soll. |
| Rollen | CSV | – | Nein | Geben Sie die Rollen an, die dem Agent hinzugefügt werden sollen. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. Beispiel: {"role_id":17000023338,"assignment_scope": "entire_helpdesk"} |
| Position | String | – | Nein | Geben Sie die Berufsbezeichnung des Kundenservicemitarbeiters an. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Agent hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"agent": {
"active": true,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2021-07-06T05:40:41Z",
"custom_fields": {
"test": "testvalue"
},
"department_ids": [],
"email": "rolanda.hooch@hogwarts.edu",
"external_id": null,
"first_name": "Rolanda",
"has_logged_in": false,
"id": 17002198254,
"job_title": "Flying Instructor",
"language": "en",
"last_active_at": null,
"last_login_at": null,
"last_name": "Hooch",
"location_id": null,
"mobile_phone_number": "553632",
"occasional": true,
"reporting_manager_id": null,
"role_ids": [
17000023338
],
"roles": [
{
"role_id": 17000023338,
"assignment_scope": "entire_helpdesk",
"groups": []
}
],
"scopes": {
"ticket": null,
"problem": null,
"change": null,
"asset": null,
"solution": null,
"contract": null
},
"scoreboard_level_id": 1,
"signature": null,
"time_format": "12h",
"time_zone": "Eastern Time (US & Canada)",
"updated_at": "2021-07-06T05:40:41Z",
"work_phone_number": "443532",
"group_ids": [
17000034192
],
"member_of": [
17000034192
],
"observer_of": []
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Update Agent‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Agent deaktivieren
Beschreibung
Deaktivieren Sie den Freshservice-Agent. Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Agent-ID | Ganzzahl | – | Ja | Geben Sie die Agent-ID an, die deaktiviert werden soll. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"agent": {
"active": false,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2021-07-06T05:40:41Z",
"custom_fields": {
"test": "testvalue3"
},
"department_ids": [],
"email": "rolanda.hooch@hogwarts.edu",
"external_id": null,
"first_name": "Rolanda",
"has_logged_in": false,
"id": 17002198254,
"job_title": "Flying Instructor",
"language": "en",
"last_active_at": null,
"last_login_at": null,
"last_name": "Hooch",
"location_id": null,
"mobile_phone_number": "553632",
"occasional": true,
"reporting_manager_id": null,
"role_ids": [
17000023338
],
"roles": [
{
"role_id": 17000023338,
"assignment_scope": "entire_helpdesk",
"groups": []
}
],
"scopes": {
"ticket": null,
"problem": null,
"change": null,
"asset": null,
"solution": null,
"contract": null
},
"scoreboard_level_id": 2,
"signature": "<p> </p>\n",
"time_format": "24h",
"time_zone": "Eastern Time (US & Canada)",
"updated_at": "2021-07-06T06:26:59Z",
"work_phone_number": "443532",
"group_ids": [],
"member_of": [],
"observer_of": []
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Agent deaktivieren‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Antragsteller erstellen
Beschreibung
Neuen Freshservice-Antragsteller erstellen Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| String | – | Ja | Geben Sie die E-Mail-Adresse des zu erstellenden Antragstellers an. | |
| Vorname | String | – | Ja | Geben Sie den Vornamen des zu erstellenden Antragstellers an. |
| Nachname | String | – | Nein | Geben Sie den Nachnamen des zu erstellenden Antragstellers an. |
| Alle Tickets der zugehörigen Abteilungen sehen | Kästchen | Deaktiviert | Nein | Wenn diese Option aktiviert ist, kann der Antragsteller alle Tickets der zugehörigen Abteilungen sehen. |
| Abteilungen | CSV | – | Nein | Geben Sie die Abteilungsnamen an, die dem Antragsteller zugeordnet sind . Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. |
| Standort | String | – | Nein | Geben Sie den mit dem Antragsteller verknüpften Ortsnamen an . |
| Position | String | – | Nein | Geben Sie die Berufsbezeichnung des Antragstellers an. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Antragsteller hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"requester": {
"active": true,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2021-07-06T08:12:47Z",
"custom_fields": {
"test": "testvalue"
},
"department_ids": [],
"external_id": null,
"first_name": "Rolanda",
"has_logged_in": false,
"id": 17002198308,
"job_title": "Flying Instructor",
"language": "en",
"last_name": "Hooch",
"location_id": null,
"mobile_phone_number": null,
"primary_email": "rolanda.hooch2@hogwarts.edu",
"reporting_manager_id": null,
"secondary_emails": [],
"time_format": "12h",
"time_zone": "Eastern Time (US & Canada)",
"updated_at": "2021-07-06T08:12:47Z",
"work_phone_number": null
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Antragsteller erstellen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Antragsteller aktualisieren
Beschreibung
Bestehenden Freshservice-Antragsteller aktualisieren. Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Antragsteller-ID | Ganzzahl | – | Ja | Geben Sie die ID des Antragstellers an, die aktualisiert werden soll. |
| String | – | Nein | Geben Sie die E-Mail-Adresse des Antragstellers an, die aktualisiert werden soll. | |
| Vorname | String | – | Nein | Geben Sie den Vornamen des Antragstellers an, der aktualisiert werden soll. |
| Nachname | String | – | Nein | Geben Sie den Nachnamen des Antragstellers an, der aktualisiert werden soll. |
| Alle Tickets der zugehörigen Abteilungen sehen | Kästchen | Deaktiviert | Nein | Wenn diese Option aktiviert ist, kann der Antragsteller alle Tickets der zugehörigen Abteilungen sehen. |
| Abteilungen | CSV | – | Nein | Geben Sie die Abteilungsnamen an, die dem Antragsteller zugeordnet sind. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. |
| Standort | String | – | Nein | Geben Sie den mit dem Antragsteller verknüpften Ortsnamen an. |
| Position | String | – | Nein | Geben Sie die Berufsbezeichnung des Antragstellers an. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Antragsteller hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"agent": {
"active": true,
"address": null,
"background_information": null,
"can_see_all_tickets_from_associated_departments": false,
"created_at": "2021-07-06T05:40:41Z",
"custom_fields": {
"test": "testvalue"
},
"department_ids": [],
"email": "rolanda.hooch@hogwarts.edu",
"external_id": null,
"first_name": "Rolanda",
"has_logged_in": false,
"id": 17002198254,
"job_title": "Flying Instructor",
"language": "en",
"last_active_at": null,
"last_login_at": null,
"last_name": "Hooch",
"location_id": null,
"mobile_phone_number": "553632",
"occasional": true,
"reporting_manager_id": null,
"role_ids": [
17000023338
],
"roles": [
{
"role_id": 17000023338,
"assignment_scope": "entire_helpdesk",
"groups": []
}
],
"scopes": {
"ticket": null,
"problem": null,
"change": null,
"asset": null,
"solution": null,
"contract": null
},
"scoreboard_level_id": 1,
"signature": null,
"time_format": "12h",
"time_zone": "Eastern Time (US & Canada)",
"updated_at": "2021-07-06T05:40:41Z",
"work_phone_number": "443532",
"group_ids": [
17000034192
],
"member_of": [
17000034192
],
"observer_of": []
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Antragsteller aktualisieren‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Anforderer deaktivieren
Beschreibung
Freshservice-Antragsteller deaktivieren. Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Antragsteller-ID | Ganzzahl | – | Ja | Geben Sie die ID des Antragstellers an, die deaktiviert werden soll. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Antragsteller deaktivieren‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Ticketzeiteinträge auflisten
Beschreibung
Listet Freshservice-Tickets und Zeiteinträge basierend auf den angegebenen Suchkriterien auf. Diese Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, für die Zeiteinträge zurückgegeben werden sollen. |
| E‑Mail-Adresse des Kundenservicemitarbeiters | String | – | Ja | Geben Sie die E-Mail-Adresse des Kundenservicemitarbeiters an, für den die Zeiteinträge des Tickets aufgeführt werden sollen. |
| Zeilen pro Seite | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Zeiteinträge pro Seite für die Freshservice-Paginierung zurückgegeben werden sollen. |
| Beginnen auf Seite | Ganzzahl | 1 | Nein | Geben Sie an, ab welcher Seite die Zeiteinträge für Tickets mit der Freshservice-Paginierung zurückgegeben werden sollen. |
| Maximale Anzahl zurückzugebender Zeilen | Ganzzahl | 30 | Nein | Geben Sie an, wie viele Einträge für Ticketzeiten insgesamt zurückgegeben werden sollen. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"time_entries": [
{
"id": 17000399635,
"created_at": "2021-07-08T06:26:47Z",
"updated_at": "2021-07-08T06:26:47Z",
"start_time": "2021-07-08T06:26:47Z",
"timer_running": false,
"billable": true,
"time_spent": "01:00",
"executed_at": "2021-07-08T06:26:47Z",
"task_id": null,
"note": "test_entry2",
"agent_id": 17002188556,
"custom_fields": {}
}
]
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚List Ticket Time Entries‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
| Tabelle | Tabellenname:Freshservice-Ticket <ticket id> Time Entries Tabellenspalten: ID des Zeiteintrags E‑Mail-Adresse des Kundenservicemitarbeiters Hinweis Abrechenbar Zeit Aufgaben-ID Benutzerdefinierte Felder Timer läuft Erstellt um Aktualisiert am Beginn Ausführungszeit |
Allgemein |
Ticketzeiteintrag hinzufügen
Beschreibung
Einem Freshservice-Ticket einen Zeiteintrag hinzufügen Die Aktion funktioniert nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, für die ein Zeiteintrag hinzugefügt werden soll. |
| E‑Mail-Adresse des Kundenservicemitarbeiters | String | – | Ja | Geben Sie die E‑Mail-Adresse des Kundenservicemitarbeiters an, für den ein Zeiteintrag für das Ticket hinzugefügt werden soll. |
| Hinweis | String | – | Nein | Geben Sie eine Notiz an, die dem Zeiteintrag des Tickets hinzugefügt werden soll. |
| Zeit | String | – | Ja | Geben Sie die für den Zeiteintrag des Tickets aufgewendete Zeit an. Format: {hh:mm} |
| Abrechenbar | Kästchen | Falsch | Nein | Wenn diese Option aktiviert ist, wird der Zeiteintrag für das Ticket als abrechenbar markiert. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Zeiteintrag für das Ticket hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"time_entry": {
"id": 17000405061,
"created_at": "2021-07-10T18:22:18Z",
"updated_at": "2021-07-10T18:22:18Z",
"start_time": "2021-07-10T18:22:18Z",
"timer_running": false,
"billable": true,
"time_spent": "01:00",
"executed_at": "2021-07-10T18:22:18Z",
"task_id": null,
"note": "test_entry3",
"agent_id": 17002188556,
"custom_fields": {
"test": "very_test"
}
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Eintrag für Ticketzeit hinzufügen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Zeiteintrag für Ticket aktualisieren
Beschreibung
Aktualisieren Sie einen Zeiteintrag für ein Freshservice-Ticket. Aktionen funktionieren nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, um einen Zeiteintrag zu aktualisieren. |
| ID des Zeiteintrags | Ganzzahl | – | Ja | Geben Sie die ID des zu aktualisierenden Zeiteintrags an. |
| E‑Mail-Adresse des Kundenservicemitarbeiters | String | – | Nein | Geben Sie die E-Mail-Adresse des Kundenservicemitarbeiters an, für den ein Zeiteintrag für ein Ticket geändert werden soll. |
| Hinweis | String | – | Nein | Geben Sie eine Notiz für den Zeiteintrag des Tickets an. |
| Zeit | String | – | Nein | Geben Sie die für den Zeiteintrag des Tickets aufgewendete Zeit an. Format: {hh:mm} |
| Abrechenbar | Kästchen | Falsch (nicht geprüft) | Nein | Wenn diese Option aktiviert ist, wird der Zeiteintrag für das Ticket als abrechenbar markiert. |
| Benutzerdefinierte Felder | JSON | – | Nein | Geben Sie ein JSON-Objekt an, das benutzerdefinierte Felder enthält, die dem Zeiteintrag für das Ticket hinzugefügt werden sollen. Acton hängt neue benutzerdefinierte Felder an alle vorhandenen Felder für ein Ticket an. Beispielformat: {"key1":"value1", "key2":"value2"} |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
JSON-Ergebnis
{
"time_entry": {
"id": 17000405061,
"created_at": "2021-07-10T18:22:18Z",
"updated_at": "2021-07-10T18:30:54Z",
"start_time": "2021-07-10T18:22:18Z",
"timer_running": false,
"billable": false,
"time_spent": "03:30",
"executed_at": "2021-07-10T18:22:18Z",
"task_id": null,
"note": "test_entry_updated",
"agent_id": 17002188556,
"custom_fields": {
"test": "very_test2"
}
}
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Update Ticket Time Entry‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Zeiteintrag für Ticket löschen
Beschreibung
Löschen Sie einen Zeiteintrag für ein Freshservice-Ticket. Aktionen funktionieren nicht für Google SecOps-Entitäten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| Ticket-ID | Ganzzahl | – | Ja | Geben Sie die Ticket-ID an, für die ein Zeiteintrag gelöscht werden soll. |
| ID des Zeiteintrags | Ganzzahl | – | Ja | Geben Sie die ID des zu löschenden Zeiteintrags an. |
Ausführen am
Diese Aktion wird nicht für Elemente ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Scriptergebnisses | Wertoptionen |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabemeldung* | Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.
Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Bei schwerwiegendem Fehler oder SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Zeiteintrag für Ticket löschen‘. Grund: {0}''.format(error.Stacktrace) |
Allgemein |
Connector
Freshservice Tickets Connector
Beschreibung
Mit dem Connector können Freshservice-Tickets abgerufen werden, um Google SecOps-Benachrichtigungen zu erstellen. Mit der Connector-Whitelist können nur bestimmte Arten von Tickets aufgenommen werden, z. B. Vorfälle oder Serviceanfragen.
Freshservice Tickets Connector in Google SecOps konfigurieren
Eine ausführliche Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Connector konfigurieren.
Connector-Parameter
Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Produktfeldname | String | Freshworks Freshservice | Ja | |
| Name des Ereignisfelds | String | „type“ | Ja | |
| Name des Umgebungsfelds | String | "" | Nein | Nein |
| Regex-Muster für Umgebung | String | .* | Nein | Nein |
| API-Stamm | String | https://yourdomain.freshservice.com |
Ja | Freshservice-Instanz-API-Stamm-URL. |
| API-Schlüssel | Passwort | – | Ja | Freshservice-API-Schlüssel für die Integration. |
| SSL überprüfen | Kästchen | Aktiviert | Nein | Wenn diese Option aktiviert ist, wird versucht, zu prüfen, ob für die Stamm-URL ein gültiges Zertifikat konfiguriert ist. |
| Abweichungszeit in Stunden | Ganzzahl | 24 | Ja | Rufe Tickets für die letzten X Stunden ab. |
| Maximale Anzahl von Tickets pro Zyklus | Ganzzahl | 30 | Ja | Wie viele Tickets bei einem Connector-Lauf verarbeitet werden sollen. |
| Mindestpriorität für den Abruf | String | Mittel | Nein | Mindestpriorität des Tickets, das in Google SecOps aufgenommen werden soll, z. B. „Niedrig“ oder „Mittel“. Mögliche Werte: Niedrig, Mittel, Hoch, Dringend |
| Abzurufender Ticketstatus | CSV | Offen/Geschlossen | Nein | Ticketstatus, die in Google SecOps aufgenommen werden sollen. Der Parameter akzeptiert mehrere Werte als durch Kommas getrennten String. Mögliche Werte: Offen, Ausstehend, Behoben, Geschlossen |
| Zulassungsliste als Sperrliste verwenden | Kästchen | Deaktiviert | Ja | Wenn diese Option aktiviert ist, wird die Zulassungsliste als Sperrliste verwendet. |
Connector-Regeln
Proxyunterstützung
Der Connector unterstützt Proxys.
Jobs
Freshservice-Synchronisierungsauftrag zum Schließen von Tickets
Beschreibung
Schließen Sie Tickets in Freshservice, wenn entsprechende Google Security Operations SOAR-Benachrichtigungen geschlossen wurden.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| API-Stamm | String | https://yourdomain.freshservice.com | Ja | Freshservice-Instanz-API-Stamm-URL. |
| API-Schlüssel | Passwort | – | Ja | Freshservice-API-Schlüssel für die Integration. |
| SSL überprüfen | Kästchen | Aktiviert | Nein | Wenn diese Option aktiviert ist, wird versucht, zu prüfen, ob für die Stamm-URL ein gültiges Zertifikat konfiguriert ist. |
| Abweichungszeit in Stunden | Ganzzahl | 24 | Ja | Synchronisiere das Schließen von Tickets ab X Stunden in der Vergangenheit. |
| Standardbeschreibung für Tickets | String | Das Ticket wird vom Job „Siemplify Freshservice Sync Tickets Closure“ geschlossen. | Ja | Geben Sie die Beschreibung an, die dem Ticket hinzugefügt werden soll, wenn es keine Beschreibung hat. So kann das Ticket in Freshservice geschlossen werden, da das Beschreibungsfeld für Freshservice obligatorisch ist. |
Freshservice Sync Tickets Conversations Job
Beschreibung
Synchronisieren Sie Unterhaltungen (Antworten und Notizen) zwischen dem Fall der Google SecOps-Benachrichtigung und dem entsprechenden Freshservice-Ticket. Der Synchronisierungsmechanismus funktioniert in beide Richtungen: Google SecOps → Freshservice und Freshservice → Google SecOps.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Pflichtfeld | Beschreibung |
|---|---|---|---|---|
| API-Stamm | String | https://yourdomain.freshservice.com | Ja | Freshservice-Instanz-API-Stamm-URL. |
| API-Schlüssel | Passwort | – | Ja | Freshservice-API-Schlüssel für die Integration. |
| SSL überprüfen | Kästchen | Aktiviert | Nein | Wenn diese Option aktiviert ist, wird versucht, zu prüfen, ob für die Stamm-URL ein gültiges Zertifikat konfiguriert ist. |
| Abweichungszeit in Stunden | Ganzzahl | 24 | Ja | Ticketunterhaltungen ab X Stunden in der Vergangenheit synchronisieren |
| Siemplify-Kommentarpräfix | String | SIEMPLIFY: | Ja | Präfix, das vom Synchronisierungsjob zu Kommentaren hinzugefügt wird, die für Freshservice-Tickets erstellt wurden. |
| Freshservice-Kommentarpräfix | String | Synchronisierungsauftrag für Freshservice-Kommentare: | Ja | Präfix, das vom Synchronisierungsjob den Fallkommentaren der Google SecOps-Benachrichtigung hinzugefügt wird. |
| Zu synchronisierende Unterhaltungsarten | CSV | Antworten, Notizen | Ja | Geben Sie an, welche Freshservice-Konversationstypen synchronisiert werden sollen. Für den Parameter können mehrere Werte als durch Kommas getrennter String angegeben werden. |
| Private Notizen abrufen? | Kästchen | Kästchen nicht angeklickt (falsch) | Nein | Wenn diese Option aktiviert ist, werden sowohl öffentliche als auch private Notizen für zugehörige Freshservice-Tickets abgerufen. |
| Kommentar aus Siemplify als X synchronisieren | String | Private Notiz | Ja | Geben Sie an, welcher Konversationstyp für den Job verwendet werden soll, um einen Kommentar von Google SecOps hinzuzufügen. Mögliche Werte: „Private Note“ (Private Notiz), „Public Note“ (Öffentliche Notiz), „Reply“ (Antwort). |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten