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

  1. Im Freshservice-Supportportal anmelden
  2. Klicken Sie oben rechts im Portal auf das Profilbild Ihres Kontos.
  3. Zur Seite „Profileinstellungen“
  4. Der Konto-API-Schlüssel wird rechts unter dem Abschnitt „Passwort ändern“ angezeigt.
  5. 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.

  • Bei Erfolg: „Die Verbindung zur Freshservice-Instanz wurde mit den angegebenen Verbindungsparametern hergestellt.“

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.

  • Wenn Tickets gefunden wurden (is_success = true): „Freshservice-Tickets wurden erfolgreich abgerufen.“
  • Wenn keine Tickets zurückgegeben werden (is_success = false): „Für die angegebenen Eingabeparameter wurden keine Tickets gefunden.“
  • Wenn beim Abrufen von Tickets ein API-Fehler aufgetreten ist (is_success = false): „Tickets konnten mit den angegebenen Eingabeparametern nicht aufgelistet werden. Fehler: {error from the API}

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true): Ein neues Freshservice-Ticket wurde erstellt.
  • Wenn die Ausführung der Aktion aufgrund der angegebenen Parameter fehlgeschlagen ist(is_success =false): Das Erstellen eines neuen Tickets mit den angegebenen Parametern ist fehlgeschlagen. Fehler: <error text>.

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Das Freshservice-Ticket <ticket id> wurde aktualisiert.
  • Wenn die Ausführung der Aktion aufgrund der bereitgestellten Parameter fehlgeschlagen ist(is_success =false)

    • Das Ticket <ticket_id> konnte mit den angegebenen Parametern nicht aktualisiert werden. Fehler: <error text>.

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.

  • Wenn Ticketunterhaltungen gefunden wurden (is_success = true):
    „Freshservice-Ticketunterhaltungen mit der Ticket-ID <ticket id> wurden erfolgreich abgerufen.“
  • Wenn keine Ticketunterhaltungen zurückgegeben werden (is_success = false):
    "No ticket conversations were found for the ticket <ticket id>" (Für das Ticket <ticket id> wurden keine Ticketunterhaltungen gefunden.)
  • Wenn die angegebene Ticket-ID nicht gefunden wurde (is_success = false):
    „Ticket <ticket id> was not found in Freshservice.
  • Wenn beim Abrufen von Tickets ein API-Fehler aufgetreten ist (is_success = false): „Failed to list ticket conversations with the provided input parameters. Fehler: {error from the API}

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Dem Ticket <ticket id> wurde eine neue Antwort hinzugefügt.
  • Wenn die angegebene Ticket-ID nicht gefunden wurde (is_success = false):

    • „Das Ticket <ticket id> wurde in Freshservice nicht gefunden.

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Dem Ticket <ticket id> wurde eine neue Notiz vom Typ <note type> hinzugefügt.
  • Wenn die angegebene Ticket-ID nicht gefunden wurde (is_success = false):

    • „Das Ticket <ticket id> wurde in Freshservice nicht gefunden.

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.

  • Wenn Agenten gefunden wurden (is_success = true): „Successfully fetched Freshservice agents.“ (Freshservice-Agenten wurden erfolgreich abgerufen.)
  • Wenn keine Agents zurückgegeben werden (is_success = false): „Für die angegebenen Eingabeparameter wurden keine Agents gefunden.“
  • Wenn beim Abrufen von KI-Agenten ein API-Fehler aufgetreten ist (is_success = false): „KI-Agenten konnten mit den angegebenen Eingabeparametern nicht aufgelistet werden. Fehler: {error from the API}

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

E-Mail

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.

  • Wenn Anfragesteller gefunden wurden (is_success = true):
    „Freshservice-registrierte Anfragesteller wurden erfolgreich abgerufen.“
  • Wenn keine Anfragenden zurückgegeben wurden (is_success = false):
    "No requesters were found for the provided input parameters."
  • Wenn beim Abrufen von Anfragestellern ein API-Fehler aufgetreten ist (is_success = false): „Das Auflisten von Anfragestellern mit den angegebenen Eingabeparametern ist fehlgeschlagen. Fehler: {error from the API}

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

E-Mail

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
E-Mail 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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Ein neuer Freshservice-Agent wurde erstellt.
  • Wenn die Ausführung der Aktion aufgrund der bereitgestellten Parameter fehlgeschlagen ist(is_success =false)

    • Neuer Agent konnte mit den angegebenen Parametern nicht erstellt werden. Fehler: <error text>.

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.
E-Mail 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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Der Freshservice-Agent <agent_id> wurde aktualisiert.
  • Wenn die Ausführung der Aktion aufgrund der bereitgestellten Parameter fehlgeschlagen ist(is_success =false)

    • Der Freshservice-Kundenservicemitarbeiter <agent_id> konnte mit den angegebenen Parametern nicht aktualisiert werden. Fehler: <error text>.

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Der Freshservice-Agent <agent_id> ist deaktiviert.
  • Wenn die Ausführung der Aktion aufgrund des 404-Fehlers fehlgeschlagen ist (is_success =false)

    • Der Freshservice-Agent <agent_id> konnte nicht gefunden werden, um ihn zu deaktivieren.
  • Wenn die Ausführung der Aktion aufgrund des 403-Fehlers fehlgeschlagen ist (is_success =false)

    • Fehler beim Deaktivieren des Freshservice-Agents <agent_id>. Möglicherweise wurde er bereits deaktiviert. API-Antwort: „code“: „access_denied“, „message“: „You are not authorized to perform this action.“

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
E-Mail 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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Neuer Freshservice-Antragsteller erstellt.
  • Wenn die Ausführung der Aktion aufgrund der bereitgestellten Parameter fehlgeschlagen ist(is_success =false)

    • Der neue Antragsteller konnte mit den angegebenen Parametern nicht erstellt werden. Fehler: <error text>.

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.
E-Mail 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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Der Freshservice-Antragsteller <requester_id> wurde aktualisiert.
  • Wenn die Ausführung der Aktion aufgrund der bereitgestellten Parameter fehlgeschlagen ist(is_success =false)

    • Der Freshservice-Antragsteller <requester_id> konnte mit den angegebenen Parametern nicht aktualisiert werden. Fehler: <error text>.

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Der Freshservice-Antragsteller <requester_id> ist deaktiviert.
  • Wenn die Ausführung der Aktion aufgrund des 404-Fehlers fehlgeschlagen ist (is_success =false)

    • Der Freshservice-Antragsteller <requester_id> konnte nicht gefunden werden, um ihn zu deaktivieren.
  • Wenn die Ausführung der Aktion aufgrund des 405-Fehlers fehlgeschlagen ist (is_success =false)

    • Die Deaktivierung des Freshservice-Antragstellers <requester_id> ist fehlgeschlagen. Er wurde möglicherweise bereits deaktiviert. API-Antwort: „message“: „DELETE method is not allowed. Es sollte eine dieser Methoden sein: GET“

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.

  • Wenn Zeiteinträge für das Ticket gefunden wurden (is_success = true):
    „Zeiteinträge für das Freshservice-Ticket <ticket id> wurden abgerufen.“
  • Wenn keine Zeiteinträge für Tickets zurückgegeben werden (is_success = false):
    „Für das Ticket <ticket id> wurden keine Zeiteinträge gefunden.“
  • Wenn die angegebene Ticket-ID nicht gefunden wurde (is_success = false):
    „Ticket <ticket id> was not found in Freshservice.
  • Wenn keine Agent-ID für die angegebene Agent-E-Mail-Adresse gefunden wurde (is_success = false):
    „Agent <agent_email> was not found in Freshservice.
  • Wenn beim Abrufen von Ticket-Zeiteinträgen ein API-Fehler aufgetreten ist (is_success = false): „Die Ticket-Zeiteinträge konnten mit den angegebenen Eingabeparametern nicht aufgelistet werden. Fehler: {error from the API}

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Dem Ticket <ticket id> wurde ein neuer Zeiteintrag hinzugefügt.
  • Wenn die angegebene Ticket-ID nicht gefunden wurde (is_success = false):

    • „Das Ticket <ticket id> wurde in Freshservice nicht gefunden.
  • Wenn die angegebene E‑Mail-Adresse des Kundenservicemitarbeiters nicht gefunden wurde (is_success = false):

    • „Agent with email <agent_email> was not found in Freshservice.
  • Wenn die angegebene Zeit im falschen Format ist (is_success = false):

    • „Der angegebene Wert für die Zeit, die mit der Kampagne verbracht wurde, <time_spent>, hat ein falsches Format. Er sollte im Format ‚hh:mm‘ angegeben werden.

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Der Zeiteintrag <time_entry_id> wurde für das Ticket <ticket id> aktualisiert.
  • Wenn die angegebene Ticket-ID oder Zeiteintrags-ID nicht gefunden wurde (is_success = false):

    • „Die angegebene Ticket-ID <ticket_id> oder Zeiteintrags-ID <time_entry id> wurde in Freshservice nicht gefunden.
  • Wenn die angegebene E‑Mail-Adresse des Kundenservicemitarbeiters nicht gefunden wurde (is_success = false):

    • „Agent with email <agent_email> was not found in Freshservice.
  • Wenn die angegebene Zeit im falschen Format ist (is_success = false):

    • „Der angegebene Wert für die Zeit, die mit der Kampagne verbracht wurde, <time_spent>, hat ein falsches Format. Er sollte im Format ‚hh:mm‘ angegeben werden.

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.

  • Wenn die Aktion erfolgreich ausgeführt wurde (is_success=true):

    • Der Zeiteintrag <time_entry_id> wurde für das Ticket <ticket id> gelöscht.
  • Wenn die angegebene Ticket-ID oder Zeiteintrags-ID nicht gefunden wurde (is_success = false):

    • „Die angegebene Ticket-ID <ticket_id> oder Zeiteintrags-ID <time_entry id> wurde in Freshservice nicht gefunden.“

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