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
Selecione a ação no diagrama e digite o Nome, por exemplo «Atribuir ao Suporte em campo».
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.
Em Parâmetros (JSON) são carregados parâmetros de exemplo. Altere-os conforme o que você precisar.
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.