Freshworks Freshservice

Versione integrazione: 14.0

Casi d'uso

Integrazione con il service desk.

Configurazione di Freshservice

L'integrazione di Freshservice Google Security Operations funziona in base alle chiavi API di Freshservice.

Come ottenere la chiave API dell'account in Freshservice

  1. Accedi al portale di assistenza Freshservice.
  2. Fai clic sull'immagine del profilo dell'account nell'angolo in alto a destra del portale.
  3. Vai alla pagina delle impostazioni del profilo
  4. La chiave API dell'account sarà disponibile sotto la sezione Modifica password, sulla destra.
  5. Salva questa chiave API, ti servirà per la configurazione dell'integrazione di Google SecOps.

Configura l'integrazione di Freshworks Freshservice in Google SecOps

Per istruzioni dettagliate su come configurare un'integrazione in Google SecOps, vedi Configurare le integrazioni.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa https://yourdomain.freshservice.com Sì URL root dell'API dell'istanza Freshservice.
Chiave API Password N/D Sì Chiave API Freshservice da utilizzare nell'integrazione.
Verifica SSL Casella di controllo Selezionata No Se attivata, l'integrazione verifica che l'URL radice sia configurato con un certificato valido.

Azioni

Dindin

Descrizione

Verifica la connettività all'istanza Freshservice con i parametri forniti nella pagina di configurazione dell'integrazione nella scheda Google Security Operations Marketplace.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'operazione va a buon fine: "Connessione all'istanza Freshservice riuscita con i parametri di connessione forniti."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:se si verifica un errore critico, ad esempio credenziali errate o perdita di connettività: "Failed to connect to the Freshservice instance! Error is {0}".format(exception.stacktrace)

 Generale

Elenca i ticket

Descrizione

Elenca i ticket Freshservice in base ai criteri di ricerca specificati. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di biglietto DDL Tutti No Specifica il tipo di biglietto da restituire.
Richiedente Stringa N/D No Specifica l'email del richiedente dei ticket da restituire.
Includi statistiche Casella di controllo Deselezionata No Se attivata, l'azione restituirà statistiche aggiuntive sui biglietti.
Cerca nelle ultime X ore Numero intero N/D No Specifica il periodo di tempo in cui cercare i biglietti.
Righe per pagina Numero intero 30 No Specifica quanti ticket devono essere restituiti per pagina per la paginazione di Freshservice.
Inizia dalla pagina Numero intero 1 No Specifica a partire da quale pagina devono essere restituiti i ticket con la paginazione di Freshservice.
Numero massimo di righe da restituire Numero intero 30 No Specifica quanti biglietti deve restituire l'azione in totale.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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
            }
        }
    ]
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se sono stati trovati ticket (is_success = true): "Recupero dei ticket Freshservice riuscito."
  • Se non vengono restituiti biglietti (is_success = false): "Non sono stati trovati biglietti per i parametri di input forniti."
  • Se si è verificato un errore dell'API durante il recupero dei biglietti (is_success = false): "Failed to list tickets with the provided input parameters. Errore: {error from the API}"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Elenca ticket". Motivo: {0}''.format(error.Stacktrace)

 Generale
Tabella

Nome tabella: Freshservice Tickets Found

Colonne della tabella:

ID

Tipo

Oggetto

Descrizione

Email richiedente

Categoria

Stato

Priorità

Origine

Data di creazione

Data ultimo aggiornamento

Data di scadenza

Riassegnazione

Eliminato

 Generale

Crea ticket

Descrizione

Crea un ticket Freshservice.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Oggetto Stringa N/D Sì Specifica il campo dell'oggetto per il ticket creato.
Descrizione Stringa N/D Sì Specifica il campo della descrizione per il ticket creato.
Email richiedente Stringa N/D Sì Specifica l'email del richiedente per il ticket creato.
Assegna a agente Stringa N/D No Specifica l'email dell'agente a cui assegnare il ticket.
Assegna a gruppo Stringa N/D No Specifica il nome del gruppo a cui assegnare il ticket.
Priorità DDL Media Sì Specifica la priorità da assegnare al ticket.
Urgenza DDL Media No Specifica l'urgenza da assegnare al ticket.
Impatto DDL Media No Specifica l'impatto da assegnare al ticket.
Tag Stringa N/D No Specifica i tag da assegnare al ticket. Il parametro accetta più valori come stringa separata da virgole.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere al ticket. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}
File allegati da aggiungere Stringa (CSV) N/D No Specifica il percorso completo del file da caricare con il ticket. Il parametro accetta più valori come stringa separata da virgole. Le dimensioni totali degli allegati non devono superare i 15 MB.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione viene eseguita correttamente (is_success=true): viene creato un nuovo ticket Freshservice.

  • Se l'azione non è stata eseguita a causa dei parametri forniti(is_success =false): Impossibile creare un nuovo ticket con i parametri forniti. Errore: <error text>.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Ticket". Motivo: {0}''.format(error.Stacktrace)

 Generale

Aggiorna biglietto

Descrizione

Aggiorna un ticket Freshservice in base ai parametri di input dell'azione forniti. Tieni presente che se vengono forniti nuovi tag per il ticket, a causa delle limitazioni dell'API Freshservice, l'azione sostituisce i tag esistenti nel ticket, non aggiungendo quelli nuovi a quelli esistenti.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket da aggiornare.
Stato DDL Non modificato No Specifica il nuovo stato del ticket.
Oggetto Stringa N/D No Specifica il campo dell'oggetto da aggiornare.
Descrizione Stringa N/D No Specifica il campo della descrizione da aggiornare.
Email richiedente Stringa N/D No Specifica l'email del richiedente da aggiornare.
Assegna a agente Stringa N/D No Specifica l'email dell'agente da aggiornare.
Assegna a gruppo Stringa N/D No Specifica il nome del gruppo da aggiornare.
Priorità DDL Non modificato No Specifica la priorità da aggiornare.
Urgenza DDL Non modificato No Specifica l'urgenza dell'aggiornamento.
Impatto DDL Non modificato No Specifica l'impatto da aggiornare.
Tag Stringa N/D No Specifica i tag da sostituire nel ticket. Il parametro accetta più valori come stringa separata da virgole. Tieni presente che, a causa delle limitazioni dell'API Freshservice, l'azione sostituisce i tag esistenti nel ticket, anziché aggiungerne di nuovi a quelli esistenti.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere al ticket. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}
File allegati da aggiungere Stringa (CSV) N/D No Specifica il percorso completo del file da caricare con il ticket. Il parametro accetta più valori come stringa separata da virgole. Le dimensioni totali degli allegati non devono superare i 15 MB.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • Il ticket Freshservice <ticket id> è stato aggiornato.

  • Se l'azione non è stata eseguita a causa dei parametri forniti(is_success =false)

    • Impossibile aggiornare il ticket <ticket_id> con i parametri forniti. Errore: <error text>.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Update Ticket". Motivo: {0}''.format(error.Stacktrace)

 Generale

Elenco conversazioni ticket

Descrizione

Elenca le conversazioni dei ticket Freshservice in base ai criteri di ricerca specificati. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket per restituire le conversazioni.
Righe per pagina Numero intero 30 No Specifica il numero di conversazioni sui ticket da restituire per pagina per la paginazione di Freshservice.
Inizia dalla pagina Numero intero 1 No Specifica a partire da quale pagina devono essere restituite le conversazioni dei ticket con la paginazione di Freshservice.
Numero massimo di righe da restituire Numero intero 30 No Specifica il numero totale di conversazioni sui ticket che l'azione deve restituire.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se sono state trovate conversazioni sui ticket (is_success = true):
    "Conversazioni sul ticket Freshservice <ticket id> recuperate correttamente."
  • Se non vengono restituite conversazioni del ticket (is_success = false):
    "Non sono state trovate conversazioni del ticket per il ticket <ID ticket>"
  • Se l'ID ticket fornito non è stato trovato (is_success = false):
    "Il ticket <ticket id> non è stato trovato in Freshservice.
  • Se si è verificato un errore dell'API durante il recupero dei ticket (is_success = false): "Failed to list ticket conversations with the provided input parameters. Errore: {error from the API}"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:

"Errore durante l'esecuzione dell'azione "Elenca conversazioni ticket". Motivo: {0}''.format(error.Stacktrace)

 Generali
Tabella

Nome tabella: Conversazioni sul ticket Freshservice <ticket id>

Colonne della tabella:

ID

Tipo

Visibilità

Indirizzo email dell'utente

Testo

Dall'email

A indirizzo email

Email cc

Email Ccn

 Generale

Aggiungere una risposta al ticket

Descrizione

Aggiungere una risposta a un ticket Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket per restituire le conversazioni.
Testo della risposta Stringa N/D Sì Specifica il testo della risposta da aggiungere al ticket.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
    "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"
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • È stata aggiunta una nuova risposta al ticket <ID ticket>.

  • Se l'ID ticket fornito non è stato trovato (is_success = false):

    • "Il ticket <ticket id> non è stato trovato in Freshservice.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add a Ticket Reply". Motivo: {0}''.format(error.Stacktrace)

 Generale

Aggiungere una nota al ticket

Descrizione

Aggiungi una nota a un ticket Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket per restituire le conversazioni.
Tipo di nota DDL Privato No Specifica il tipo di azione della nota da aggiungere al ticket.
Testo della nota Stringa N/D Sì Specifica il testo della nota da aggiungere al ticket.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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"
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • La nuova nota <tipo di nota> viene aggiunta al ticket <ID ticket>.

  • Se l'ID ticket fornito non è stato trovato (is_success = false):

    • "Il ticket <ticket id> non è stato trovato in Freshservice.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add a Ticket Note". Motivo: {0}''.format(error.Stacktrace)

 Generale

Elenco agenti

Descrizione

Elenca gli agenti Freshservice in base ai criteri di ricerca specificati. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Email dell'agente Stringa N/D No Specifica l'indirizzo email per cui restituire i record dell'agente.
Stato dell'agente DDL TUTTE No Specifica gli stati degli agenti da restituire.
Includi agenti non attivi Casella di controllo Deselezionata No Se abilitata, i risultati includeranno i record degli agenti non attivi.
Righe per pagina Numero intero 30 No Specifica quanti record di agenti devono essere restituiti per pagina per la paginazione di Freshservice.
Inizia dalla pagina Numero intero 1 No Specifica a partire da quale pagina devono essere restituiti i record dell'agente con la paginazione di Freshservice.
Numero massimo di righe da restituire Numero intero 30 No Specifica il numero totale di record dell'agente che deve restituire l'azione.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
        },
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • If found agents (is_success = true): "Successfully fetched Freshservice agents." (Se sono stati trovati agenti (is_success = true): "Successfully fetched Freshservice agents.")
  • Se non vengono restituiti agenti (is_success = false): "Non sono stati trovati agenti per i parametri di input forniti."
  • Se si è verificato un errore dell'API durante il recupero degli agenti (is_success = false): "Failed to list agents with the provided input parameters. Errore: {error from the API}"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:

"Errore durante l'esecuzione dell'azione "Elenca agenti". Motivo: {0}''.format(error.Stacktrace)

 Generale

Tabella

Nome tabella: Agenti Freshservice trovati

Colonne della tabella:

ID

Email

Nome

Cognome

Ruoli

Gruppi

Reparti

Località

Attivo

Occasionale

Campi personalizzati

Data di creazione

Data ultimo aggiornamento

Data ultima attività

Data dell'ultimo accesso

 Generale

Elenca richiedenti

Descrizione

Elenca i richiedenti registrati in Freshservice in base ai criteri di ricerca specificati. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Email richiedente Stringa N/D No Specifica l'indirizzo email per cui restituire i record dei richiedenti.
Righe per pagina Numero intero 30 No Specifica quanti record di agenti devono essere restituiti per pagina per la paginazione di Freshservice.
Inizia dalla pagina Numero intero 1 No Specifica a partire da quale pagina devono essere restituiti i record dell'agente con la paginazione di Freshservice.
Numero massimo di righe da restituire Numero intero 30 No Specifica il numero totale di record dell'agente che deve restituire l'azione.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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
        }
    ]
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se sono stati trovati richiedenti (is_success = true):
    "Recupero dei richiedenti registrati di Freshservice riuscito."
  • Se non vengono restituiti richiedenti (is_success = false):
    "Non sono stati trovati richiedenti per i parametri di input forniti."
  • Se si è verificato un errore dell'API durante il recupero dei richiedenti (is_success = false): "Impossibile elencare i richiedenti con i parametri di input forniti. Errore: {error from the API}"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:

"Errore durante l'esecuzione dell'azione "Elenca richiedenti". Motivo: {0}''.format(error.Stacktrace)

 Generale

Tabella

Nome tabella: Richiedente Freshservice trovato

Colonne della tabella:

ID

Email

Nome

Cognome

Reparti

Località

Attivo

Campi personalizzati

Data di creazione

Data ultimo aggiornamento

 Generale

Crea agente

Descrizione

Crea un nuovo agente Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Email Stringa N/D Sì Specifica l'email dell'agente da creare.
Nome Stringa N/D Sì Specifica il nome dell'agente da creare.
Cognome Stringa N/D No Specifica il cognome dell'agente da creare.
È occasionale Casella di controllo Deselezionata No Se questa opzione è abilitata, l'agente verrà creato come agente occasionale, altrimenti verrà creato un agente a tempo pieno.
Può visualizzare tutti i ticket dei reparti associati Casella di controllo Deselezionata No

Se abilitato, l'agente potrà visualizzare tutti i ticket dei reparti associati.
Reparti CSV N/D No Specifica i nomi dei reparti associati all'agente. Il parametro accetta più valori come stringa separata da virgole.
Località Stringa N/D No Specifica il nome della sede associata all'agente.
Appartenenze a gruppi CSV N/D No Specifica i nomi dei gruppi di cui deve far parte l'agente.
Ruoli CSV N/D Sì

Specifica i ruoli da aggiungere all'agente. Il parametro accetta più valori come stringa separata da virgole.

Esempio: {"role_id":17000023338,"assignment_scope": ""}
Qualifica Stringa N/D No Specifica la qualifica dell'agente.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere all'agente. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • È stato creato un nuovo agente Freshservice.

  • Se l'azione non è stata eseguita a causa dei parametri forniti(is_success =false)

    • Impossibile creare un nuovo agente con i parametri forniti. Errore: <error text>.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Agent". Motivo: {0}''.format(error.Stacktrace)

 Generale

Aggiorna agente

Descrizione

Aggiorna l'agente Freshservice esistente. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID agente Numero intero N/D Sì Specifica l'ID agente da aggiornare.
Email Stringa N/D No Specifica l'email dell'agente da aggiornare.
Nome Stringa N/D No Specifica il nome dell'agente da aggiornare.
Cognome Stringa N/D No Specifica il cognome dell'agente da aggiornare.
È occasionale Casella di controllo Deselezionata No Se abilitato, l'agente verrà aggiornato come agente occasionale, altrimenti sarà un agente a tempo pieno.
Può visualizzare tutti i ticket dei reparti associati Casella di controllo Deselezionata No

Se abilitato, l'agente potrà visualizzare tutti i ticket dei reparti associati.
Reparti CSV N/D No Specifica i nomi dei reparti associati all'agente. Il parametro accetta più valori come stringa separata da virgole.
Località Stringa N/D No Specifica il nome della sede associata all'agente.
Appartenenze a gruppi CSV N/D No Specifica i nomi dei gruppi di cui deve far parte l'agente.
Ruoli CSV N/D No

Specifica i ruoli da aggiungere all'agente. Il parametro accetta più valori come stringa separata da virgole.

Esempio: {"role_id":17000023338,"assignment_scope": "entire_helpdesk"}
Qualifica Stringa N/D No Specifica la qualifica dell'agente.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere all'agente. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • L'agente Freshservice <agent_id> è stato aggiornato.

  • Se l'azione non è stata eseguita a causa dei parametri forniti(is_success =false)

    • Impossibile aggiornare l'agente Freshservice <agent_id> con i parametri forniti. Errore: <error text>.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Update Agent". Motivo: {0}''.format(error.Stacktrace)

 Generale

Disattiva agente

Descrizione

Disattiva l'agente Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID agente Numero intero N/D Sì Specifica l'ID agente da disattivare.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • L'agente Freshservice <agent_id> è disattivato.

  • Se l'azione non è stata eseguita a causa dell'errore 404 (is_success =false)

    • Impossibile trovare l'agente Freshservice <agent_id> da disattivare.

  • Se l'azione non è stata eseguita a causa dell'errore 403 (is_success =false)

    • Impossibile disattivare l'agente Freshservice <agent_id>. Forse è già stato disattivato? Risposta API: "code": "access_denied","message": "You are not authorized to perform this action."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Deactivate Agent". Motivo: {0}''.format(error.Stacktrace)

 Generale

Crea richiedente

Descrizione

Crea un nuovo richiedente Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Email Stringa N/D Sì Specifica l'email del richiedente da creare.
Nome Stringa N/D Sì Specifica il nome del richiedente da creare.
Cognome Stringa N/D No Specifica il cognome del richiedente da creare.
Può visualizzare tutti i ticket dei reparti associati Casella di controllo Deselezionata No

Se abilitata, il richiedente potrà visualizzare tutti i ticket dei reparti associati.
Reparti CSV N/D No Specifica i nomi dei reparti associati al richiedente . Il parametro accetta più valori come stringa separata da virgole.
Località Stringa N/D No Specifica il nome della località associata al richiedente .
Qualifica Stringa N/D No Specifica la qualifica del richiedente.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere al richiedente. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • Nuovo richiedente Freshservice creato.

  • Se l'azione non è stata eseguita a causa dei parametri forniti(is_success =false)

    • Impossibile creare un nuovo richiedente con i parametri forniti. Errore: <error text>.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Requester". Motivo: {0}''.format(error.Stacktrace)

 Generale

Aggiorna richiedente

Descrizione

Aggiorna il richiedente Freshservice esistente. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID richiedente Numero intero N/D Sì Specifica l'ID richiedente da aggiornare.
Email Stringa N/D No Specifica l'email del richiedente da aggiornare.
Nome Stringa N/D No Specifica il nome del richiedente da aggiornare.
Cognome Stringa N/D No Specifica il cognome del richiedente da aggiornare.
Può visualizzare tutti i ticket dei reparti associati Casella di controllo Deselezionata No

Se abilitata, il richiedente potrà visualizzare tutti i ticket dei reparti associati.
Reparti CSV N/D No Specifica i nomi dei reparti associati al richiedente. Il parametro accetta più valori come stringa separata da virgole.
Località Stringa N/D No Specifica il nome della località associata al richiedente.
Qualifica Stringa N/D No Specifica la qualifica del richiedente.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere al richiedente. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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": []
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • Il richiedente Freshservice <requester_id> è stato aggiornato.

  • Se l'azione non è stata eseguita a causa dei parametri forniti(is_success =false)

    • Impossibile aggiornare il richiedente di Freshservice <requester_id> con i parametri forniti. Errore: <error text>.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Update Requester". Motivo: {0}''.format(error.Stacktrace)

 Generale

Disattiva richiedente

Descrizione

Disattiva il richiedente Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID richiedente Numero intero N/D Sì Specifica l'ID richiedente da disattivare.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • Il richiedente Freshservice <requester_id> è disattivato.

  • Se l'azione non è stata eseguita a causa dell'errore 404 (is_success =false)

    • Impossibile trovare il richiedente Freshservice <requester_id> da disattivare.

  • Se l'azione non è stata eseguita a causa dell'errore 405 (is_success =false)

    • Impossibile disattivare il richiedente Freshservice <requester_id>. Forse è già stato disattivato? Risposta API: "message": "DELETE method is not allowed. Deve essere uno di questi metodi: GET"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Deactivate Requester". Motivo: {0}''.format(error.Stacktrace)

 Generale

Elenca le voci dell'orario dei biglietti

Descrizione

Elenca le voci di tempo dei ticket Freshservice in base ai criteri di ricerca specificati. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket per cui restituire le voci di orario.
Email dell'agente Stringa N/D Sì Specifica l'email dell'agente per cui elencare le voci di tempo del ticket.
Righe per pagina Numero intero 30 No Specifica quante voci di tempo del ticket devono essere restituite per pagina per la paginazione di Freshservice.
Inizia dalla pagina Numero intero 1 No Specifica a partire da quale pagina devono essere restituite le voci di tempo del ticket con la paginazione di Freshservice.
Numero massimo di righe da restituire Numero intero 30 No Specifica il numero totale di voci di tempo del ticket che deve restituire l'azione.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
   "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": {}
       }
   ]
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • If found ticket time entries (is_success = true):
    "Successfully fetched Freshservice ticket <ticket id> time entries." (Se sono state trovate voci di tempo del ticket (is_success = true):
    "Sono state recuperate correttamente le voci di tempo del ticket Freshservice <ticket id>.")
  • Se non vengono restituite voci di tempo del ticket (is_success = false):
    "Non sono state trovate voci di tempo del ticket per il ticket <ticket id>"
  • Se l'ID ticket fornito non è stato trovato (is_success = false):
    "Il ticket <ticket id> non è stato trovato in Freshservice.
  • Se non è stato trovato alcun ID agente per l'email dell'agente fornita (is_success = false):
    "L'agente <agent_email> non è stato trovato in Freshservice.
  • Se hai ricevuto un errore API durante il recupero delle voci di tempo del ticket (is_success = false): "Impossibile elencare le voci di tempo del ticket con i parametri di input forniti. Errore: {error from the API}"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro:

"Errore durante l'esecuzione dell'azione "Elenca le voci di tempo del ticket". Motivo: {0}''.format(error.Stacktrace)

 Generale
Tabella

Nome tabella: Voci di tempo del ticket Freshservice <ticket id>

Colonne della tabella:

ID voce di orario

Email dell'agente

Nota

Fatturabile

Tempo di utilizzo

ID attività

Campi personalizzati

Timer attivo

Data/ora creazione

Data/ora aggiornamento

Ora di inizio

Ora di esecuzione

 Generale

Aggiungi voce Orario dei biglietti

Descrizione

Aggiungi una voce di tempo a un ticket Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket a cui aggiungere una voce di orario.
Email dell'agente Stringa N/D Sì Specifica l'email dell'agente per cui aggiungere una voce di tempo del ticket.
Nota Stringa N/D No Specifica una nota da aggiungere alla voce di tempo del ticket.
Tempo di utilizzo Stringa N/D Sì Specifica il tempo trascorso per la registrazione del tempo del ticket. Formato: {hh:mm}
Fatturabile Casella di controllo Falso No Se questa opzione è abilitata, la registrazione del tempo della richiesta verrà contrassegnata come fatturabile.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere alla voce di tempo del ticket. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
   "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"
       }
   }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • La nuova registrazione del tempo viene aggiunta al ticket <ID ticket>.

  • Se l'ID ticket fornito non è stato trovato (is_success = false):

    • "Il ticket <ticket id> non è stato trovato in Freshservice.

  • Se l'email dell'agente fornita non è stata trovata (is_success = false):

    • "L'agente con email <agent_email> non è stato trovato in Freshservice.

  • Se il tempo trascorso fornito ha un formato errato (is_success = false):

    • "Il valore del tempo trascorso specificato <time_spent> non è nel formato corretto, deve essere nel formato "hh:mm".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add Ticket Time Entry". Motivo: {0}''.format(error.Stacktrace)

 Generale

Aggiorna inserimento orario del ticket

Descrizione

Aggiorna una voce di tempo per un ticket Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket per cui aggiornare una voce orario.
ID voce di orario Numero intero N/D Sì Specifica l'ID della voce di orario da aggiornare.
Email dell'agente Stringa N/D No Specifica l'email dell'agente per cui modificare una voce di tempo del ticket.
Nota Stringa N/D No Specifica una nota per la voce di tempo del ticket.
Tempo di utilizzo Stringa N/D No Specifica il tempo trascorso per la registrazione del tempo del ticket. Formato: {hh:mm}
Fatturabile Casella di controllo False (non selezionato) No Se questa opzione è abilitata, la registrazione del tempo della richiesta verrà contrassegnata come fatturabile.
Campi personalizzati JSON N/D No

Specifica un oggetto JSON contenente i campi personalizzati da aggiungere alla voce di tempo del ticket. L'azione aggiunge nuovi campi personalizzati a quelli esistenti per un ticket. Formato di esempio:

{"key1":"value1", "key2":"value2"}

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "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"
        }
    }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • La voce di tempo <time_entry_id> è stata aggiornata per il ticket <ticket id>.

  • Se l'ID ticket o l'ID voce orario fornito non è stato trovato (is_success = false):

    • "L'ID ticket <ticket_id> o l'ID voce di orario <time_entry id> fornito non è stato trovato in Freshservice.

  • Se l'email dell'agente fornita non è stata trovata (is_success = false):

    • "L'agente con email <agent_email> non è stato trovato in Freshservice.

  • Se il tempo trascorso fornito ha un formato errato (is_success = false):

    • "Il valore del tempo trascorso specificato <time_spent> non è nel formato corretto, deve essere nel formato "hh:mm".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Update Ticket Time Entry". Motivo: {0}''.format(error.Stacktrace)

 Generale

Elimina voce di orario del ticket

Descrizione

Elimina una voce di tempo per un ticket Freshservice. Tieni presente che l'azione non funziona sulle entità Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Numero intero N/D Sì Specifica l'ID ticket per eliminare una voce di orario.
ID voce di orario Numero intero N/D Sì Specifica l'ID della voce di orario da eliminare.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

  • Se l'azione è stata eseguita correttamente (is_success=true)

    • La voce di tempo <time_entry_id> è stata eliminata per il ticket <ticket id>.

  • Se l'ID ticket o l'ID voce orario fornito non è stato trovato (is_success = false):

    • "L'ID ticket <ticket_id> o l'ID voce di orario <time_entry id> fornito non è stato trovato in Freshservice

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Delete Ticket Time Entry". Motivo: {0}''.format(error.Stacktrace)

 Generale

Connettore

Connettore per ticket Freshservice

Descrizione

Il connettore può essere utilizzato per recuperare i ticket Freshservice per creare avvisi Google SecOps. L'elenco consentito dei connettori può essere utilizzato per importare solo tipi specifici di ticket: incidenti o richieste di assistenza.

Configurare il connettore dei ticket Freshservice in Google SecOps

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, vedi Configurazione del connettore.

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome campo prodotto Stringa Freshworks Freshservice Sì
Nome campo evento Stringa "type" Sì
Nome campo ambiente Stringa "" No No
Pattern regex ambiente Stringa .* No No
Root API Stringa

https://yourdomain.freshservice.com

 Sì URL root dell'API dell'istanza Freshservice.
Chiave API Password N/D Sì Chiave API Freshservice da utilizzare nell'integrazione.
Verifica SSL Casella di controllo Selezionata No Se attivata, l'integrazione tenterà di verificare che l'URL radice sia configurato con un certificato valido.
Tempo di offset in ore Numero intero 24 Sì Recupera i biglietti di X ore precedenti.
Numero massimo di biglietti per ciclo Numero intero 30 Sì Quanti biglietti devono essere elaborati durante l'esecuzione di un connettore.
Priorità minima per il recupero Stringa Media No Priorità minima del ticket da importare in Google SecOps, ad esempio Bassa o Media. Valori possibili: Bassa, Media, Alta, Urgente
Stato dei biglietti da recuperare CSV Aperta, chiusa No Stati dei ticket da importare in Google SecOps. Il parametro accetta più valori come stringa separata da virgole. Valori possibili: Open, Pending, Resolved, Closed
Utilizzare la lista consentita come lista nera Casella di controllo Deselezionata Sì Se questa opzione è abilitata, la lista consentita verrà utilizzata come lista bloccata.

Regole del connettore

Supporto proxy

Il connettore supporta il proxy.

Job

Freshservice Sync Tickets Closure Job

Descrizione

Chiudi i ticket in Freshservice se gli avvisi SOAR di Google Security Operations corrispondenti sono stati chiusi.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa https://yourdomain.freshservice.com Sì URL root dell'API dell'istanza Freshservice.
Chiave API Password N/D Sì Chiave API Freshservice da utilizzare nell'integrazione.
Verifica SSL Casella di controllo Selezionata No Se attivata, l'integrazione tenterà di verificare che l'URL radice sia configurato con un certificato valido.
Tempo di offset in ore Numero intero 24 Sì Sincronizza la chiusura dei ticket a partire da X ore prima.
Descrizione predefinita del ticket Stringa Il ticket viene chiuso dal job di chiusura dei ticket di sincronizzazione di Siemplify Freshservice. Sì Specifica la descrizione da aggiungere al ticket se non ne ha una, in modo che possa essere chiuso in Freshservice, poiché il campo della descrizione è obbligatorio per Freshservice.

Freshservice Sync Tickets Conversations Job

Descrizione

Sincronizza le conversazioni (considerate sia risposte che note) tra il caso dell'avviso di Google SecOps e il ticket Freshservice corrispondente. Il meccanismo di sincronizzazione funziona in entrambi i modi: Google SecOps → Freshservice e Freshservice → Google SecOps.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa https://yourdomain.freshservice.com Sì URL root dell'API dell'istanza Freshservice.
Chiave API Password N/D Sì Chiave API Freshservice da utilizzare nell'integrazione.
Verifica SSL Casella di controllo Selezionata No Se attivata, l'integrazione tenterà di verificare che l'URL radice sia configurato con un certificato valido.
Tempo di offset in ore Numero intero 24 Sì Sincronizza le conversazioni dei ticket dalle X ore precedenti
Prefisso del commento Siemplify Stringa SEMPLIFICA: Sì Prefisso che verrà aggiunto dal job di sincronizzazione ai commenti creati per i ticket Freshservice.
Prefisso commento Freshservice Stringa Processo di sincronizzazione dei commenti di Freshservice: Sì Prefisso che verrà aggiunto dal job di sincronizzazione ai commenti del caso dell'avviso Google SecOps.
Tipi di conversazione da sincronizzare CSV Risposte, Note Sì Specifica i tipi di conversazione Freshservice che il job deve sincronizzare. Il parametro accetta più valori come stringa separata da virgole.
Recuperare note private? Casella di controllo Casella di controllo deselezionata (false) No Se abilitata, recupera le note pubbliche e private per i ticket Freshservice correlati.
Sincronizza commento da Siemplify come X Stringa Nota privata Sì Specifica il tipo di conversazione che il job deve utilizzare per aggiungere un commento da Google SecOps. Valori possibili: Nota privata, Nota pubblica, Risposta.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.