Esta página foi traduzida pela API Cloud Translation.

Zendesk

Versão da integração: 8.0

Configure o Zendesk para funcionar com o Google Security Operations

Um administrador gera um token de API. Para tal, siga os passos seguintes:

Navegue para a barra lateral da interface do Zendesk e clique no ícone Administração. Em seguida, selecione Canais > API.

Clique no separador Definições e ative o acesso por token.
Clique no botão + à direita de Tokens de API ativos.
Opcionalmente, introduza uma descrição em Descrição do token de API.
Copie o token para o usar mais tarde e cole-o num local seguro. O token completo nunca mais é apresentado após o fecho da janela.
Clique em Guardar para voltar à página da API.

Configure a integração do Zendesk no Google SecOps

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

Ações

Adicionar comentário ao pedido

Descrição

Adicionar um comentário a um pedido existente.

Parâmetros

Parâmetro	Tipo	Valor predefinido	Descrição
ID do pedido	String	N/A	Número do bilhete.
Corpo do comentário	String	N/A	N/A
Nome do autor	String	N/A	N/A
Nota interna	Booleano	N/A	N/A

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado JSON

N/A

Aplique macros no pedido

Descrição

Aplique uma macro a um pedido.

Parâmetros

Parâmetro	Tipo	Valor predefinido	Descrição
ID do pedido	String	N/A	Número do bilhete.
Título da macro	String	N/A	N/A

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_applied	Verdadeiro/Falso	is_applied:False

Resultado JSON

N/A

Criar pedido

Descrição

Crie um pedido com propriedades específicas.

Limitações conhecidas

Os emails com carateres Unicode não são suportados pela API Zendesk. Afeta o parâmetro "Email CC". A ação vai ignorá-los

Parâmetros

Parâmetro	Tipo	Valor predefinido	Descrição
Assunto	String	N/A	N/A
Descrição	String	N/A	N/A
Utilizador atribuído	String	N/A	Nome completo do utilizador.
Grupo de atribuição	String	N/A	Nome do grupo.
Prioridade	String	N/A	A prioridade será uma das seguintes: urgente, alta, normal ou baixa.
Tipo de bilhete	String	N/A	A prioridade será uma das seguintes: urgente, alta, normal ou baixa.
Etiqueta	String	N/A	N/A
Nota interna	Caixa de verificação	Desmarcado	Especifique se o comentário deve ser público ou interno. Se a caixa não estiver selecionada, significa que o documento é público. Se estiver selecionada, significa que é apenas para uso interno
Emails em CC	CSV	N/A	Especifique uma lista de endereços de email separados por vírgulas, que também devem receber a notificação da criação do pedido. Nota: pode adicionar um máximo de 48 destinatários em CC. Esta é uma limitação do Zendesk.
Valide os campos CC de email	Booleano	Marcado	Se estiver ativada, a ação tenta verificar se existem utilizadores com emails fornecidos no parâmetro "Emails em CC". Se, pelo menos, um utilizador não existir, a ação falha. Se este parâmetro estiver desativado, a ação não realiza esta verificação.

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	N/A	N/A

Resultado JSON

N/A

Case Wall

Tipo de resultado	Valor/descrição	Tipo
Mensagem de saída*	Se a opção "Validar CCs de email" estiver ativada e não tiver sido encontrado, pelo menos, um email (falha): erro ao executar a ação "{action name}". Motivo: não foram encontrados utilizadores com os seguintes emails: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validate Email CCs". Se, pelo menos, uma entrada não for um endereço de email válido: erro ao executar a ação "{action name}". Motivo: não foram encontrados utilizadores com os seguintes emails: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validate Email CCs".	Geral

Tipo de resultado

Valor/descrição

Tipo

Mensagem de saída*

Se a opção "Validar CCs de email" estiver ativada e não tiver sido encontrado, pelo menos, um email (falha): erro ao executar a ação "{action name}". Motivo: não foram encontrados utilizadores com os seguintes emails: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validate Email CCs".

Se, pelo menos, uma entrada não for um endereço de email válido: erro ao executar a ação "{action name}". Motivo: não foram encontrados utilizadores com os seguintes emails: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validate Email CCs".

Geral

Obtenha detalhes do pedido

Descrição

Obtenha detalhes, comentários e anexos de um pedido através do respetivo ID.

Parâmetros

Parâmetro	Tipo	Valor predefinido	Descrição
ID do pedido	String	N/A	O ID do pedido.

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_details	N/A	N/A

Resultado JSON

{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

Tchim-tchim

Descrição

Testar conetividade.

Parâmetros

N/A

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_connected	Verdadeiro/Falso	is_connected:False

Resultado JSON

N/A

Pesquisar bilhetes

Descrição

Pesquise pedidos por uma palavra-chave.

Parâmetros

Parâmetros	Tipo	Valor predefinido	Descrição
Consulta de pesquisa	String	N/A	Consultar conteúdo (exemplo: type:ticket status:pending).

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
results_count	N/A	N/A

Resultado JSON

N/A

Atualizar bilhete

Descrição

Atualize os detalhes do registo existentes

Parâmetros

Parâmetro	Tipo	Valor predefinido	Descrição
ID do pedido	String	N/A	Número do bilhete.
Assunto	String	N/A	O assunto do pedido.
Utilizador atribuído	String	N/A	Nome completo do utilizador.
Grupo de atribuição	String	N/A	Nome do grupo.
Prioridade	String	N/A	A prioridade será uma das seguintes: urgente, alta, normal ou baixa.
Tipo de bilhete	String	N/A	O tipo de pedido será um dos seguintes: problema, incidente, pergunta ou tarefa.
Etiqueta	String	N/A	Etiqueta a adicionar ao pedido.
Estado	String	N/A	O estado será um dos seguintes: novo, aberto, pendente, em espera, resolvido ou fechado.
Comentário adicional	String	N/A	Se quiser adicionar um comentário ao pedido, especifique o texto que quer adicionar como comentário aqui.
Nota interna	Caixa de verificação	Desmarcado	Especifique se o comentário deve ser público ou interno. Se a caixa não estiver selecionada, significa que o documento é público. Se estiver selecionada, significa que é apenas para uso interno

Exemplos de utilização

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Estatísticas

N/A

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_updated	Verdadeiro/Falso	is_updated:False

Resultado JSON

N/A

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