Zendesk

Versão da integração: 8.0

Configurar o Zendesk para trabalhar com o Google Security Operations

Um administrador gera um token de API. Para isso, siga estas etapas:

Navegue até a barra lateral da interface do Zendesk e clique no ícone Administrador. Em seguida, selecione Canais > API.

  1. Clique na guia Configurações e ative o acesso por token.
  2. Clique no botão + à direita de Tokens de API ativos.
  3. Se quiser, insira uma descrição em Descrição do token da API.
  4. Copie o token para usar depois e cole em um local seguro. O token completo nunca mais será exibido após o fechamento da janela.
  5. Clique em Salvar para voltar à página da API.

Configurar a integração do Zendesk no Google SecOps

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

Ações

Adicionar comentário ao tíquete

Descrição

Adicione um comentário a um tíquete aberto.

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A Número do ingresso.
Corpo do comentário String N/A N/A
Nome do autor String N/A N/A
Observação interna Booleano N/A N/A

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

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

Aplicar macros no tíquete

Descrição

Aplicar uma macro a um tíquete.

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A Número do ingresso.
Título da macro String N/A N/A

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

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

Criar tíquete

Descrição

Crie um tíquete com propriedades específicas.

Limitações conhecidas

A API Zendesk não aceita e-mails com caracteres Unicode. Ele afeta o parâmetro "Email CC". A ação vai ignorá-los

Parâmetros

Parâmetro Tipo Valor padrão Descrição
Assunto String N/A N/A
Descrição String N/A N/A
Usuário atribuído String N/A Nome completo do usuário.
Grupo de atribuição String N/A Nome do grupo.
Prioridade String N/A A prioridade será uma das seguintes opções: urgente, alta, normal ou baixa.
Tipo de ingresso String N/A A prioridade será uma das seguintes opções: urgente, alta, normal ou baixa.
Tag String N/A N/A
Observação interna Caixa de seleção Não marcada Especifique se o comentário deve ser público ou interno. Desmarcada significa que será pública, marcada significa que será apenas interna
Cc por e-mail CSV N/A Especifique uma lista de endereços de e-mail separados por vírgulas que também vão receber a notificação da criação do tíquete. Observação: é possível adicionar até 48 e-mails em cópia. Essa é uma limitação do Zendesk.
Validar cópias de e-mail Booleano Selecionado Se ativada, a ação vai tentar verificar se os usuários com e-mails fornecidos no parâmetro "E-mails em cópia" existem. Se pelo menos um usuário não existir, a ação vai falhar. Se esse parâmetro for desativado, a ação não vai realizar essa verificação.

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
ticket_id N/A N/A
Resultado do JSON
N/A
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

Se a opção "Validar cópias de e-mail" estiver ativada e pelo menos um e-mail não for encontrado (falha): erro ao executar a ação "{nome da ação}". Motivo: não foi possível encontrar os usuários com os seguintes e-mails: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validar cópias de e-mail".

se pelo menos uma entrada não for um endereço de e-mail válido: Erro ao executar a ação "{nome da ação}". Motivo: não foi possível encontrar os usuários com os seguintes e-mails: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validar cópias de e-mail".

 Geral

Receber detalhes do tíquete

Descrição

Receba detalhes, comentários e anexos de tíquetes pelo ID.

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A O ID da passagem.

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
ticket_details N/A N/A
Resultado do 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": ""}]
 }

Ping

Descrição

Teste a conectividade.

Parâmetros

N/A

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

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

Pesquisar passagens

Descrição

Pesquisar passagens por palavra-chave.

Parâmetros

Parâmetros Tipo Valor padrão Descrição
Consulta de pesquisa String N/A Conteúdo da consulta (exemplo: type:ticket status:pending).

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

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

Atualizar ingresso

Descrição

Atualizar os detalhes de um ingresso

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A Número do ingresso.
Assunto String N/A O assunto da passagem.
Usuário atribuído String N/A Nome completo do usuário.
Grupo de atribuição String N/A Nome do grupo.
Prioridade String N/A A prioridade será uma das seguintes opções: urgente, alta, normal ou baixa.
Tipo de ingresso String N/A O tipo de tíquete será um dos seguintes: problema, incidente, pergunta ou tarefa.
Tag String N/A Tag a ser adicionada ao tíquete.
Status String N/A O status será um dos seguintes: novo, aberto, pendente, aguardar, resolvido ou fechado.
Outros comentários String N/A Se quiser adicionar um comentário à passagem, especifique o texto que você quer adicionar como comentário aqui.
Observação interna Caixa de seleção Não marcada Especifique se o comentário deve ser público ou interno. Desmarcada significa que será pública, marcada significa que será apenas interna

Casos de uso

N/A

Executar em

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

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

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

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