Freshworks Freshservice

Versão da integração: 14.0

Casos de uso

Integração com a mesa de atendimento.

Configuração do Freshservice

A integração do Freshservice com o Google Security Operations funciona com base nas chaves de API do Freshservice.

Como conseguir a chave de API da conta no Freshservice

  1. Fazer login no portal de suporte do Freshservice
  2. Clique na foto do perfil da conta no canto superior direito do portal.
  3. Acessar a página de configurações de perfil
  4. A chave de API da conta vai estar disponível abaixo da seção "Mudar senha" à direita.
  5. Salve essa chave de API. Você vai precisar dela para a configuração de integração do Google SecOps.

Configurar a integração do Freshworks Freshservice no Google SecOps

Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Raiz da API String https://yourdomain.freshservice.com Sim URL raiz da API da instância do Freshservice.
Chave de API Senha N/A Sim Chave de API do Freshservice para usar na integração.
Verificar SSL Caixa de seleção Selecionado Não Se ativada, a integração verifica se o URL raiz está configurado com um certificado válido.

Ações

Ping

Descrição

Teste a conectividade com a instância do Freshservice usando os parâmetros fornecidos na página de configuração da integração na guia "Marketplace" do Google Security Operations.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a conexão for bem-sucedida: "Conexão concluída com a instância do Freshservice usando os parâmetros fornecidos"

A ação deve falhar e interromper a execução de um playbook:se houver um erro crítico, como credenciais incorretas ou perda de conectividade: "Não foi possível se conectar à instância do Freshservice. O erro é {0}".format(exception.stacktrace)

 Geral

Listar passagens

Descrição

Lista os tíquetes do Freshservice com base nos critérios de pesquisa especificados. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de ingresso DDL Todos Não Especifique o tipo de passagem a ser retornado.
Solicitante String N/A Não Especifique o e-mail do solicitante dos tíquetes a serem retornados.
Incluir estatísticas Caixa de seleção Desmarcado Não Se ativada, a ação vai retornar mais estatísticas sobre os ingressos.
Pesquisar nas últimas X horas Número inteiro N/A Não Especifique o período para pesquisar ingressos.
Linhas por página Número inteiro 30 Não Especifique quantos tíquetes devem ser retornados por página para a paginação do Freshservice.
Começar na página Número inteiro 1 Não Especifique a partir de qual página os tíquetes devem ser retornados com a paginação do Freshservice.
Número máximo de linhas a serem retornadas Número inteiro 30 Não Especifique quantos ingressos a ação deve retornar no total.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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
            }
        }
    ]
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se os tíquetes forem encontrados (is_success = true): "Tíquetes do Freshservice buscados com sucesso".
  • Se nenhum ingresso for retornado (is_success = false): "Nenhum ingresso foi encontrado para os parâmetros de entrada fornecidos".
  • Se você recebeu um erro de API ao receber ingressos (is_success = false): "Não foi possível listar os ingressos com os parâmetros de entrada fornecidos. O erro é: {error from the API}"

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "List Tickets". Motivo: {0}''.format(error.Stacktrace)

 Geral
Tabela

Nome da tabela:Freshservice Tickets Found

Colunas da tabela:

ID

Tipo

Assunto

Descrição

E-mail do solicitante

Categoria

Status

Prioridade

Origem

Data de criação

Data de atualização

Data de conclusão

Encaminhamento do problema

Excluído

 Geral

Criar tíquete

Descrição

Crie um tíquete do Freshservice.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Assunto String N/A Sim Especifique o campo de assunto para o tíquete criado.
Descrição String N/A Sim Especifique o campo de descrição para o tíquete criado.
E-mail do solicitante String N/A Sim Especificar o e-mail do solicitante para o tíquete criado.
Atribuir a agente String N/A Não Especifique o e-mail do agente para atribuir o tíquete.
Atribuir grupo a String N/A Não Especifique o nome do grupo a que o tíquete será atribuído.
Prioridade DDL Médio Sim Especifique a prioridade a ser atribuída ao tíquete.
Urgência DDL Médio Não Especifique a urgência a ser atribuída ao tíquete.
Impacto DDL Médio Não Especifique o impacto a ser atribuído ao tíquete.
Tags String N/A Não Especifique as tags a serem atribuídas ao tíquete. O parâmetro aceita vários valores como uma string separada por vírgulas.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados a serem adicionados ao tíquete. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

{"key1":"value1", "key2":"value2"}
Anexos de arquivo a serem adicionados String (CSV) N/A Não Especifique o caminho completo do arquivo a ser enviado com o tíquete. O parâmetro aceita vários valores como uma string separada por vírgulas. O tamanho total dos anexos não pode exceder 15 MB.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso (is_success=true): um novo tíquete do Freshservice será criado.

  • Se a ação não foi executada devido aos parâmetros fornecidos(is_success =false): não foi possível criar um novo tíquete com os parâmetros fornecidos. O erro é: <texto do erro>.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, entre outros: "Erro ao executar a ação "Criar tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Atualizar ingresso

Descrição

Atualiza um tíquete do Freshservice com base nos parâmetros de entrada de ação fornecidos. Se novas tags forem fornecidas para o tíquete, devido às limitações da API Freshservice, a ação vai substituir as tags atuais, não anexar novas às existentes.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete a ser atualizado.
Status DDL Sem alterações Não Especifique o novo status do tíquete.
Assunto String N/A Não Especifique o campo de assunto a ser atualizado.
Descrição String N/A Não Especifique o campo de descrição a ser atualizado.
E-mail do solicitante String N/A Não Especifique o e-mail do solicitante a ser atualizado.
Atribuir a agente String N/A Não Especifique o e-mail do agente a ser atualizado.
Atribuir grupo a String N/A Não Especifique o nome do grupo a ser atualizado.
Prioridade DDL Não mudou Não Especifique a prioridade a ser atualizada.
Urgência DDL Não mudou Não Especifique a urgência para atualizar.
Impacto DDL Não mudou Não Especifique o impacto a ser atualizado.
Tags String N/A Não Especifique as tags a serem substituídas no tíquete. O parâmetro aceita vários valores como uma string separada por vírgulas. Devido às limitações da API Freshservice, a ação substitui as tags atuais no tíquete, em vez de anexar novas.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados a serem adicionados ao tíquete. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

{"key1":"value1", "key2":"value2"}
Anexos de arquivo a serem adicionados String (CSV) N/A Não Especifique o caminho completo do arquivo a ser enviado com o tíquete. O parâmetro aceita vários valores como uma string separada por vírgulas. O tamanho total dos anexos não pode exceder 15 MB.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • O tíquete do Freshservice <ticket id> foi atualizado.

  • Se a ação não foi executada devido aos parâmetros fornecidos(is_success =false)

    • Não foi possível atualizar o tíquete <ticket_id> com os parâmetros fornecidos. O erro é: <error text>.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Atualizar tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Listar conversas de tíquetes

Descrição

Lista as conversas de tíquetes do Freshservice com base nos critérios de pesquisa especificados. Essa ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para retornar as conversas.
Linhas por página Número inteiro 30 Não Especifique quantas conversas de tíquetes devem ser retornadas por página para a paginação do Freshservice.
Começar na página Número inteiro 1 Não Especifique a partir de qual página as conversas de tíquetes devem ser retornadas com a paginação do Freshservice.
Número máximo de linhas a serem retornadas Número inteiro 30 Não Especifique quantas conversas de tíquetes a ação deve retornar no total.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se as conversas de tíquetes forem encontradas (is_success = true):
    "As conversas do tíquete <ticket id> do Freshservice foram buscadas com sucesso."
  • Se nenhuma conversa de tíquete for retornada (is_success = false):
    "Nenhuma conversa de tíquete foi encontrada para o tíquete <ticket id>"
  • Se o ID do tíquete fornecido não for encontrado (is_success = false):
    "O tíquete <ID do tíquete> não foi encontrado no Freshservice.
  • Se você recebeu um erro de API ao receber tíquetes (is_success = false): "Não foi possível listar as conversas de tíquetes com os parâmetros de entrada fornecidos. O erro é: {error from the API}"

A ação precisa falhar e interromper a execução de um playbook:

se erro fatal, como credenciais incorretas, sem conexão com o servidor, outro:

"Erro ao executar a ação "List Ticket Conversations". Motivo: {0}''.format(error.Stacktrace)

 Geral
Tabela

Nome da tabela:Conversas do tíquete <ticket id> do Freshservice

Colunas da tabela:

ID

Tipo

Visibilidade

E-mail do usuário

Texto

E-mail de origem

Para e-mail

E-mail Cc

E-mail CCO

 Geral

Adicionar uma resposta a um tíquete

Descrição

Adicione uma resposta a um tíquete do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para retornar as conversas.
Texto da resposta String N/A Sim Especifique o texto da resposta para adicionar ao tíquete.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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"
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • Uma nova resposta foi adicionada ao tíquete <ticket id>.

  • Se o ID da passagem fornecido não foi encontrado (is_success = false):

    • "O tíquete <ticket id> não foi encontrado no Freshservice.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou do SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Adicionar uma resposta ao tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Adicionar uma observação ao tíquete

Descrição

Adicione uma observação a um tíquete do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para retornar as conversas.
Tipo de nota DDL Particular Não Especifique o tipo de ação de observação que deve ser adicionada ao tíquete.
Texto da nota String N/A Sim Especifique o texto da observação a ser adicionada ao tíquete.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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"
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • Uma nova nota <note type> foi adicionada ao tíquete <ticket id>.

  • Se o ID da passagem fornecido não foi encontrado (is_success = false):

    • "O tíquete <ticket id> não foi encontrado no Freshservice.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, entre outros: "Erro ao executar a ação "Adicionar uma observação ao tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Listar agentes

Descrição

Lista os agentes do Freshservice com base nos critérios de pesquisa especificados. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
E-mail do agente String N/A Não Especifique o endereço de e-mail para retornar registros de agente.
Estado do agente DDL TODOS Não Especifique os estados do agente a serem retornados.
Incluir agentes não ativos Caixa de seleção Desmarcado Não Se ativada, os resultados vão incluir registros de agentes inativos.
Linhas por página Número inteiro 30 Não Especifique quantos registros de agente devem ser retornados por página para a paginação do Freshservice.
Começar na página Número inteiro 1 Não Especifique a partir de qual página os registros do agente devem ser retornados com a paginação do Freshservice.
Número máximo de linhas a serem retornadas Número inteiro 30 Não Especifique quantos registros de agente a ação deve retornar no total.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
        },
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se os agentes forem encontrados (is_success = true): "Agentes do Freshservice buscados com sucesso".
  • Se nenhum agente for retornado (is_success = false): "Nenhum agente foi encontrado para os parâmetros de entrada fornecidos".
  • Se você recebeu um erro de API ao receber agentes (is_success = false): "Não foi possível listar os agentes com os parâmetros de entrada fornecidos. O erro é: {error from the API}"

A ação precisa falhar e interromper a execução de um playbook:

se erro fatal, como credenciais incorretas, sem conexão com o servidor, outro:

"Erro ao executar a ação "List Agents". Motivo: {0}''.format(error.Stacktrace)

 Geral

Tabela

Nome da tabela:Agentes do Freshservice encontrados

Colunas da tabela:

ID

E-mail

Nome

Sobrenome

Papéis

Grupos

Departamentos

Local

Ativo

Ocasional

Campos personalizados

Data de criação

Data de atualização

Data da última atividade

Data do último login

 Geral

Listar requerentes

Descrição

Lista os solicitantes registrados no Freshservice com base nos critérios de pesquisa especificados. Essa ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
E-mail do solicitante String N/A Não Especifique o endereço de e-mail para retornar os registros do solicitante.
Linhas por página Número inteiro 30 Não Especifique quantos registros de agente devem ser retornados por página para a paginação do Freshservice.
Começar na página Número inteiro 1 Não Especifique a partir de qual página os registros do agente devem ser retornados com a paginação do Freshservice.
Número máximo de linhas a serem retornadas Número inteiro 30 Não Especifique quantos registros de agente a ação deve retornar no total.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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
        }
    ]
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se os solicitantes forem encontrados (is_success = true):
    "Solicitantes registrados do Freshservice buscados com sucesso."
  • Se nenhum solicitante for retornado (is_success = false):
    "Nenhum solicitante foi encontrado para os parâmetros de entrada fornecidos."
  • Se você recebeu um erro de API ao receber solicitantes (is_success = false): "Não foi possível listar os solicitantes com os parâmetros de entrada fornecidos. O erro é: {error from the API}"

A ação precisa falhar e interromper a execução de um playbook:

se erro fatal, como credenciais incorretas, sem conexão com o servidor, outro:

"Erro ao executar a ação "List Requesters". Motivo: {0}''.format(error.Stacktrace)

 Geral

Tabela

Nome da tabela:Freshservice Requester Found

Colunas da tabela:

ID

E-mail

Nome

Sobrenome

Departamentos

Local

Ativo

Campos personalizados

Data de criação

Data de atualização

 Geral

Crie um agente

Descrição

Crie um novo agente do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
E-mail String N/A Sim Especifique o e-mail do agente a ser criado.
Nome String N/A Sim Especifique o nome do agente a ser criado.
Sobrenome String N/A Não Especifique o sobrenome do agente a ser criado.
É ocasional Caixa de seleção Desmarcado Não Se ativado, o agente será criado como um agente eventual. Caso contrário, será criado um agente em tempo integral.
Pode ver todos os tíquetes dos departamentos associados Caixa de seleção Desmarcado Não

Se ativado, o agente poderá ver todos os tíquetes dos departamentos associados.
Departamentos CSV N/A Não Especifique os nomes dos departamentos associados ao agente. O parâmetro aceita vários valores como uma string separada por vírgulas.
Local String N/A Não Especifique o nome do local associado ao agente.
Associações a grupos CSV N/A Não Especifique os nomes dos grupos de que o agente precisa fazer parte.
Papéis CSV N/A Sim

Especifique as funções a serem adicionadas ao agente. O parâmetro aceita vários valores como uma string separada por vírgulas.

Exemplo: {"role_id":17000023338,"assignment_scope": ""}
Cargo String N/A Não Especifique o cargo do agente.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados para adicionar ao agente. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

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

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • Novo agente do Freshservice criado.

  • Se a ação não foi executada devido aos parâmetros fornecidos(is_success =false)

    • Não foi possível criar um agente com os parâmetros fornecidos. O erro é: <error text>.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Criar agente". Motivo: {0}''.format(error.Stacktrace)

 Geral

Atualizar agente

Descrição

Atualizar o agente do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do agente Número inteiro N/A Sim Especifique o ID do agente a ser atualizado.
E-mail String N/A Não Especifique o e-mail do agente a ser atualizado.
Nome String N/A Não Especifique o primeiro nome do agente a ser atualizado.
Sobrenome String N/A Não Especifique o sobrenome do agente a ser atualizado.
É ocasional Caixa de seleção Desmarcado Não Se ativado, o agente será atualizado como um agente ocasional. Caso contrário, será um agente em tempo integral.
Pode ver todos os tíquetes dos departamentos associados Caixa de seleção Desmarcado Não

Se ativado, o agente poderá ver todos os tíquetes dos departamentos associados.
Departamentos CSV N/A Não Especifique os nomes dos departamentos associados ao agente. O parâmetro aceita vários valores como uma string separada por vírgulas.
Local String N/A Não Especifique o nome do local associado ao agente.
Associações a grupos CSV N/A Não Especifique os nomes dos grupos de que o agente precisa fazer parte.
Papéis CSV N/A Não

Especifique as funções a serem adicionadas ao agente. O parâmetro aceita vários valores como uma string separada por vírgulas.

Exemplo: {"role_id":17000023338,"assignment_scope": "entire_helpdesk"}
Cargo String N/A Não Especifique o cargo do agente.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados para adicionar ao agente. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

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

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • O agente do Freshservice <agent_id> foi atualizado.

  • Se a ação não foi executada devido aos parâmetros fornecidos(is_success =false)

    • Não foi possível atualizar o agente do Freshservice <agent_id> com os parâmetros fornecidos. O erro é: <error text>.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Atualizar agente". Motivo: {0}''.format(error.Stacktrace)

 Geral

Desativar agente

Descrição

Desative o agente do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do agente Número inteiro N/A Sim Especifique o ID do agente a ser desativado.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • O agente do Freshservice <agent_id> foi desativado.

  • Se a ação não foi executada devido ao erro 404 (is_success =false)

    • Não foi possível encontrar o agente do Freshservice <agent_id> para desativar.

  • Se a ação não foi executada devido ao erro 403 (is_success =false)

    • Não foi possível desativar o agente do Freshservice <agent_id>. Talvez ele já esteja desativado. Resposta da API: "code": "access_denied","message": "Você não tem autorização para realizar esta ação."

A ação precisa falhar e interromper a execução de um playbook:

Se for um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Desativar agente". Motivo: {0}''.format(error.Stacktrace)

 Geral

Criar solicitante

Descrição

Crie um novo solicitante do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
E-mail String N/A Sim Especifique o e-mail do solicitante a ser criado.
Nome String N/A Sim Especifique o nome do solicitante a ser criado.
Sobrenome String N/A Não Especifique o sobrenome do solicitante a ser criado.
Pode ver todos os tíquetes dos departamentos associados Caixa de seleção Desmarcado Não

Se ativada, o solicitante poderá ver todos os tíquetes dos departamentos associados.
Departamentos CSV N/A Não Especifique os nomes dos departamentos associados ao solicitante . O parâmetro aceita vários valores como uma string separada por vírgulas.
Local String N/A Não Especifique o nome do local associado ao solicitante .
Cargo String N/A Não Especifique o cargo do solicitante.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados para adicionar ao solicitante. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

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

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • Novo solicitante do Freshservice criado.

  • Se a ação não foi executada devido aos parâmetros fornecidos(is_success =false)

    • Não foi possível criar um novo solicitante com os parâmetros fornecidos. O erro é: <error text>.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou do SDK, como credenciais incorretas, sem conexão com o servidor, entre outros: "Erro ao executar a ação "Criar solicitante". Motivo: {0}''.format(error.Stacktrace)

 Geral

Atualizar requerente

Descrição

Atualizar o solicitante do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do solicitante Número inteiro N/A Sim Especifique o ID do solicitante a ser atualizado.
E-mail String N/A Não Especifique o e-mail do solicitante a ser atualizado.
Nome String N/A Não Especifique o nome do solicitante a ser atualizado.
Sobrenome String N/A Não Especifique o sobrenome do solicitante a ser atualizado.
Pode ver todos os tíquetes dos departamentos associados Caixa de seleção Desmarcado Não

Se ativada, o solicitante poderá ver todos os tíquetes dos departamentos associados.
Departamentos CSV N/A Não Especifique os nomes dos departamentos associados ao solicitante. O parâmetro aceita vários valores como uma string separada por vírgulas.
Local String N/A Não Especifique o nome do local associado ao solicitante.
Cargo String N/A Não Especifique o cargo do solicitante.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados para adicionar ao solicitante. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

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

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": []
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • O solicitante do Freshservice <requester_id> foi atualizado.

  • Se a ação não foi executada devido aos parâmetros fornecidos(is_success =false)

    • Não foi possível atualizar o solicitante do Freshservice <requester_id> com os parâmetros fornecidos. O erro é: <error text>.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou do SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Atualizar solicitante". Motivo: {0}''.format(error.Stacktrace)

 Geral

Desativar solicitante

Descrição

Desativar o solicitante do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do solicitante Número inteiro N/A Sim Especifique o ID do solicitante a ser desativado.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • O solicitante do Freshservice <requester_id> foi desativado.

  • Se a ação não foi executada devido ao erro 404 (is_success =false)

    • Não foi possível encontrar o solicitante do Freshservice <requester_id> para desativar.

  • Se a ação não foi executada devido ao erro 405 (is_success =false)

    • Falha ao desativar o solicitante do Freshservice <requester_id>. Talvez ele já esteja desativado. Resposta da API: "message": "DELETE method is not allowed. Ele precisa ser um destes métodos: GET"

A ação precisa falhar e interromper a execução de um playbook:

se houver um erro fatal ou do SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Desativar solicitante". Motivo: {0}''.format(error.Stacktrace)

 Geral

Listar entradas de horário de ingressos

Descrição

Lista as entradas de tempo dos tíquetes do Freshservice com base nos critérios de pesquisa especificados. Essa ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para retornar as entradas de tempo.
E-mail do agente String N/A Sim Especifique o e-mail do agente para listar as entradas de tempo do tíquete.
Linhas por página Número inteiro 30 Não Especifique quantas entradas de tempo de tíquete devem ser retornadas por página para a paginação do Freshservice.
Começar na página Número inteiro 1 Não Especifique a partir de qual página as entradas de tempo de tíquete devem ser retornadas com a paginação do Freshservice.
Número máximo de linhas a serem retornadas Número inteiro 30 Não Especifique quantas entradas de tempo de tíquete a ação deve retornar no total.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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": {}
       }
   ]
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se forem encontradas entradas de tempo de tíquete (is_success = true):
    "Successfully fetched Freshservice ticket <ticket id> time entries."
  • Se nenhuma entrada de tempo de tíquete for retornada (is_success = false):
    "Nenhuma entrada de tempo de tíquete foi encontrada para o tíquete <ticket id>"
  • Se o ID do tíquete fornecido não for encontrado (is_success = false):
    "O tíquete <ID do tíquete> não foi encontrado no Freshservice.
  • Se nenhum ID de agente foi encontrado para o e-mail fornecido (is_success = false):
    "O agente <agent_email> não foi encontrado no Freshservice.
  • Se você recebeu um erro da API ao receber entradas de tempo de tíquete (is_success = false): "Não foi possível listar as entradas de tempo de tíquete com os parâmetros de entrada fornecidos. O erro é: {error from the API}"

A ação precisa falhar e interromper a execução de um playbook:

se erro fatal, como credenciais incorretas, sem conexão com o servidor, outro:

"Erro ao executar a ação "List Ticket Time Entries". Motivo: {0}''.format(error.Stacktrace)

 Geral
Tabela

Nome da tabela:entradas de tempo do tíquete <ticket id> do Freshservice

Colunas da tabela:

ID da entrada de tempo

E-mail do agente

Observação

Faturável

Tempo gasto

ID da tarefa

Campos personalizados

Timer em execução

Hora da criação

Horário da atualização

Horário de início

Horário de execução

 Geral

Adicionar entrada de horário de ingresso

Descrição

Adicione uma entrada de tempo a um tíquete do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para adicionar uma entrada de tempo.
E-mail do agente String N/A Sim Especifique o e-mail do agente para quem adicionar uma entrada de tempo de tíquete.
Observação String N/A Não Especifique uma observação para adicionar à entrada de tempo do tíquete.
Tempo gasto String N/A Sim Especifique o tempo gasto para a entrada de tempo do tíquete. Formato: {hh:mm}
Faturável Caixa de seleção Falso Não Se ativada, a entrada de tempo do tíquete será marcada como faturável.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados a serem adicionados à entrada de tempo do tíquete. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

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

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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"
       }
   }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • Uma nova entrada de tempo foi adicionada ao tíquete <ticket id>.

  • Se o ID da passagem fornecido não foi encontrado (is_success = false):

    • "O tíquete <ticket id> não foi encontrado no Freshservice.

  • Se o e-mail do agente fornecido não foi encontrado (is_success = false):

    • "O agente com o e-mail <agent_email> não foi encontrado no Freshservice.

  • Se o tempo gasto fornecido tiver um formato errado (is_success = false):

    • "O valor de tempo gasto especificado <time_spent> está em um formato incorreto. Ele precisa estar no formato "hh:mm".

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, entre outros: "Erro ao executar a ação "Adicionar entrada de tempo de tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Atualizar entrada de tempo do tíquete

Descrição

Atualiza uma entrada de tempo para um tíquete do Freshservice. A ação não está funcionando em entidades do Google SecOps

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para atualizar uma entrada de tempo.
ID da entrada de tempo Número inteiro N/A Sim Especifique o ID da entrada de tempo a ser atualizada.
E-mail do agente String N/A Não Especifique o e-mail do agente para quem mudar uma entrada de tempo de tíquete.
Observação String N/A Não Especifique uma observação para a entrada de tempo do tíquete.
Tempo gasto String N/A Não Especifique o tempo gasto para a entrada de tempo do tíquete. Formato: {hh:mm}
Faturável Caixa de seleção Falso (desmarcado) Não Se ativada, a entrada de tempo do tíquete será marcada como faturável.
Campos personalizados JSON N/A Não

Especifique um objeto JSON que contenha campos personalizados a serem adicionados à entrada de tempo do tíquete. O Acton anexa novos campos personalizados a qualquer campo existente de um tíquete. Exemplo de formato:

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

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do 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"
        }
    }
}
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • A entrada de tempo <time_entry_id> foi atualizada para o tíquete <ticket id>.

  • Se o ID do tíquete ou da entrada de tempo fornecido não foi encontrado (is_success = false):

    • "O ID do tíquete <ticket_id> ou o ID da entrada de tempo <time_entry id> fornecido não foi encontrado no Freshservice.

  • Se o e-mail do agente fornecido não foi encontrado (is_success = false):

    • "O agente com o e-mail <agent_email> não foi encontrado no Freshservice.

  • Se o tempo gasto fornecido tiver um formato errado (is_success = false):

    • "O valor de tempo gasto especificado <time_spent> está em um formato incorreto. Ele precisa estar no formato "hh:mm".

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Atualizar entrada de tempo do tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Excluir entrada de tempo de tíquete

Descrição

Exclui uma entrada de tempo de um tíquete do Freshservice. A ação não funciona em entidades do Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID do tíquete Número inteiro N/A Sim Especifique o ID do tíquete para excluir uma entrada de tempo.
ID da entrada de tempo Número inteiro N/A Sim Especifique o ID da entrada de tempo a ser excluída.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a ação for executada com sucesso:(is_success=true)

    • A entrada de tempo <time_entry_id> foi excluída do tíquete <ticket id>.

  • Se o ID do tíquete ou da entrada de tempo fornecido não foi encontrado (is_success = false):

    • "O ID do tíquete <ticket_id> ou o ID da entrada de tempo <time_entry id> fornecido não foi encontrado no Freshservice

A ação precisa falhar e interromper a execução de um playbook:

Se for um erro fatal ou de SDK, como credenciais incorretas, sem conexão com o servidor, entre outros: "Erro ao executar a ação "Excluir entrada de tempo do tíquete". Motivo: {0}''.format(error.Stacktrace)

 Geral

Conector

Conector de tíquetes do Freshservice

Descrição

O conector pode ser usado para buscar tíquetes do Freshservice e criar alertas do Google SecOps. A lista de permissões do conector pode ser usada para ingerir apenas tipos específicos de tíquetes: incidentes ou solicitações de serviço.

Configurar o conector de tíquetes do Freshservice no Google SecOps

Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.

Parâmetros do conector

Use os seguintes parâmetros para configurar o conector:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome do campo do produto String Freshworks Freshservice Sim
Nome do campo do evento String "type" Sim
Nome do campo de ambiente String "" Não Não
Padrão de regex do ambiente String .* Não Não
Raiz da API String

https://yourdomain.freshservice.com

 Sim URL raiz da API da instância do Freshservice.
Chave de API Senha N/A Sim Chave de API do Freshservice para usar na integração.
Verificar SSL Caixa de seleção Selecionado Não Se ativada, a integração tentará verificar se o URL raiz está configurado com um certificado válido.
Tempo de ajuste em horas Número inteiro 24 Sim Busca ingressos de X horas atrás.
Máximo de tíquetes por ciclo Número inteiro 30 Sim Quantos tíquetes devem ser processados durante uma execução do conector.
Prioridade mínima para buscar String Médio Não Prioridade mínima do tíquete a ser ingerido no Google SecOps, por exemplo, "Baixa" ou "Média". Valores possíveis: baixa, média, alta, urgente
Status dos bilhetes a serem buscados CSV Aberto, fechado Não Status de tíquetes a serem ingeridos no Google SecOps. O parâmetro aceita vários valores como uma string separada por vírgulas. Valores possíveis: "Open", "Pending", "Resolved" e "Closed".
Usar a lista de permissões como uma lista de proibições Caixa de seleção Desmarcado Sim Se ativada, a lista de permissões será usada como uma lista de bloqueios.

Regras de conector

Suporte a proxy

O conector é compatível com proxy.

Jobs

Trabalho de encerramento de tíquetes de sincronização do Freshservice

Descrição

Encerra os tíquetes no Freshservice se os alertas correspondentes do Google Security Operations SOAR SOAR forem encerrados.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Raiz da API String https://yourdomain.freshservice.com Sim URL raiz da API da instância do Freshservice.
Chave de API Senha N/A Sim Chave de API do Freshservice para usar na integração.
Verificar SSL Caixa de seleção Selecionado Não Se ativada, a integração tentará verificar se o URL raiz está configurado com um certificado válido.
Tempo de ajuste em horas Número inteiro 24 Sim Sincronizar o encerramento de tíquetes de X horas atrás.
Descrição padrão do tíquete String O tíquete é encerrado pelo job de encerramento de tíquetes da sincronização do Siemplify Freshservice. Sim Especifique a descrição que deve ser adicionada ao tíquete se ele não tiver uma. Assim, o tíquete pode ser fechado no Freshservice, já que o campo de descrição é obrigatório para essa plataforma.

Trabalho de sincronização de conversas de tíquetes do Freshservice

Descrição

Sincronizar conversas (consideradas respostas e notas) entre o caso de alerta do Google SecOps e o tíquete correspondente do Freshservice. O mecanismo de sincronização funciona nos dois sentidos: Google SecOps → Freshservice e Freshservice → Google SecOps.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Raiz da API String https://yourdomain.freshservice.com Sim URL raiz da API da instância do Freshservice.
Chave de API Senha N/A Sim Chave de API do Freshservice para usar na integração.
Verificar SSL Caixa de seleção Selecionado Não Se ativada, a integração tentará verificar se o URL raiz está configurado com um certificado válido.
Tempo de ajuste em horas Número inteiro 24 Sim Sincronizar conversas de tíquetes das últimas X horas
Prefixo de comentário do Siemplify String SIEMPLIFY: Sim Prefixo que será adicionado pelo job de sincronização aos comentários criados para tíquetes do Freshservice.
Prefixo de comentário do Freshservice String Trabalho de sincronização de comentários do Freshservice: Sim Prefixo que será adicionado pelo job de sincronização aos comentários do caso do alerta do Google SecOps.
Tipos de conversa a serem sincronizados CSV Respostas, Notas Sim Especifique os tipos de conversa do Freshservice que o job deve sincronizar. O parâmetro aceita vários valores como uma string separada por vírgulas.
Buscar notas particulares? Caixa de seleção Caixa de seleção desmarcada (false) Não Se ativado, vai buscar notas públicas e privadas para tíquetes relacionados do Freshservice.
Sincronizar comentário do Siemplify como X String Observação particular Sim Especifique qual tipo de job de conversa deve ser usado para adicionar um comentário do Google SecOps. Valores possíveis: Private Note, Public Note, Reply.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.