DocumentaciónAjuda

Ações automáticas

Configure os passos que o Elion ITSM faz sozinho dentro de um fluxo, como atribuir o ticket, mudar seu estado, avisar ou criar um ticket filho.

Nesta página

Uma Ação automática do Elion ITSM é um passo que não é feito por uma pessoa: o Elion ITSM o executa assim que o fluxo chega a ele. As ações vêm de uma lista fechada e cada uma tem seus parâmetros, que são verificados antes de publicar.

Antes de começar

  • Você precisa de Administrar em Fluxos.

  • Adicione uma Ação automática do Elion ITSM pela paleta, ou use Adicionar ação no menu de um elemento.

  • Quase todas as ações trabalham sobre o ticket do fluxo. Se o fluxo for iniciado sem ticket, só servem Enviar um aviso e Chamar um webhook registrado.

Passos

  1. Selecione a ação no diagrama e digite o Nome, por exemplo «Atribuir ao Suporte em campo».

  2. Em Ação, escolha o que ela faz (veja a tabela abaixo). Abaixo da lista aparece uma ajuda com os parâmetros que ela usa.

  3. Em Parâmetros (JSON) são carregados parâmetros de exemplo. Altere-os conforme o que você precisar.

  4. Se houver um problema, o painel avisa abaixo dos parâmetros, por exemplo to: estado de destino em minúsculas (in_progress, on_hold, resolved…).

Ao mudar de ação, os parâmetros são substituídos pelos de exemplo da nova ação.

Ações disponíveis

Ação

O que faz

Alterar o estado do ticket

Move o ticket para outro estado, com as mesmas regras de quando uma pessoa faz isso.

Atribuir o ticket

Atribui o ticket a um grupo e, se você quiser, a uma pessoa.

Alterar um campo do ticket

Muda a prioridade, o impacto, a urgência, a categoria, o serviço, as etiquetas ou um campo personalizado.

Adicionar uma nota

Adiciona uma nota interna ou uma resposta pública (que chega ao solicitante por e-mail).

Criar um ticket filho

Cria um ticket novo vinculado ao do fluxo, no grupo que você indicar.

Enviar um aviso

Avisa o solicitante, o responsável, o grupo, os aprovadores ou uma pessoa, no sino e por e-mail.

Sugerir artigos

Procura até 3 artigos publicados de conhecimento relacionados ao título do ticket e os deixa como sugestão na ficha.

Resumir com Elion

Pede ao Elion um resumo do ticket, que fica como nota interna. O fluxo não espera o resumo.

Chamar um webhook registrado

Envia um aviso assinado a um sistema externo registrado em Configurações → Integrações.

No ticket, as alterações feitas por uma ação aparecem como feitas pelo fluxo, com o nome e a versão dele.

Parâmetros de cada ação

Os parâmetros são escritos em JSON: entre chaves, cada parâmetro com seu nome entre aspas duplas. Estes são exemplos que você pode copiar.

Alterar o estado do ticket. to é o estado de destino (in_progress, on_hold, resolved…). Para colocar em espera, adicione holdReason (requester, vendor, change ou other); para resolver, resolutionCode (solved, workaround, not_reproducible, duplicate, user_error, no_response ou cancelled). note é opcional.

{ "to": "resolved", "resolutionCode": "no_response", "note": "Fechado por falta de resposta." }

Atribuir o ticket. groupId é o id do grupo (se você não indicar, é usado o grupo atual do ticket). assignee pode ser round_robin (a atribuição do grupo decide), requester.manager (a chefia do solicitante) ou user:<id>.

{ "groupId": 4, "assignee": "round_robin" }

Alterar um campo do ticket. field é priority (valor P1 a P5), impact ou urgency (1, 2 ou 3), categoryId ou serviceId (um id ou null), tags (uma lista de até 20 etiquetas) ou custom.<clave>.

{ "field": "priority", "value": "P2" }

Adicionar uma nota. kind é internal (só a equipe vê) ou public (chega ao solicitante por e-mail). body é o texto.

{ "kind": "public", "body": "Seu pedido {{ticket.number}} foi aprovado e já estamos preparando." }

Criar um ticket filho. kind é incident, request, problem ou change; title (até 200 caracteres), description (pode ficar vazia) e groupId, o grupo que o recebe. O número do ticket filho fica disponível para os passos seguintes em vars.<id>.number.

{ "kind": "request", "title": "Criar conta de e-mail para {{form.nombre}}", "description": "", "groupId": 7 }

Enviar um aviso. to é requester, assignee, group, approvers (os da última aprovação do fluxo) ou user:<id>. template é sempre workflow_notice. subject (até 200 caracteres) e body (até 5.000).

{ "to": "requester", "template": "workflow_notice", "subject": "Novidade de {{ticket.number}}", "body": "Precisamos que você confirme o endereço de entrega." }

Sugerir artigos e Resumir com Elion não têm parâmetros: deixe {}.

Chamar um webhook registrado. integrationId é o id da integração em Configurações → Integrações, event o nome do evento (minúsculas, números, ponto e _) e payload os dados que você envia (até 32 KB).

{ "integrationId": 2, "event": "alta.usuario", "payload": { "ticket": "{{ticket.number}}" } }

Textos com dados do fluxo

Nos textos dos parâmetros, você pode inserir dados do fluxo:

  • {{ticket.number}}: o número do ticket.

  • {{form.campo}}: uma resposta do formulário do pedido.

  • {{vars.x}}: um dado que um passo anterior deixou.

O valor é copiado como está: condições e cálculos dentro das chaves não são avaliados.

Se a ação falhar

  • Se o problema for passageiro (por exemplo, um sistema externo que não responde), o Elion ITSM tenta de novo sozinho: até 3 vezes na maioria das ações e até 5 em um webhook.

  • Se falhar de forma definitiva (um grupo que não existe, um estado para o qual o ticket não pode passar, um fluxo sem ticket), a instância fica Interrompido por erro e os administradores recebem o aviso «Fluxo interrompido». Depois de corrigir a causa, um administrador pode pressionar Tentar novamente na instância. Veja Acompanhar uma instância.

Os ids de grupos, pessoas e integrações não aparecem em todas as telas. Se você não os conhecer, peça a quem administra o Elion ITSM na sua empresa. Para atribuir ao grupo do ticket ou à chefia, você não precisa de ids.

Relacionado

Pesquisar em Elion ITSM

Digite pelo menos 2 letras para pesquisar em Elion ITSM.

↑↓ navegar · Enter abrir · Esc fechar