Macros
15 min
Criado por Edson Maestri em 11/06/2016 23:12
Atualizado por Ligia Sarmento em 03/02/2026 08:28

Neste artigo você irá aprender sobre macro e como utilizá-las. 

A macro é uma importante ferramenta para a automatização de tarefas na abertura ou atendimento de um ticket. Sempre que você tiver uma ação que se repita com certa frequência, considere a criação de uma macro.

Macros são templates que podem ser utilizadas pelo agente na resposta ou na abertura de um ticket. Todos os campos do ticket podem ser preenchidos ou alterados pela macro, permitindo criar modelos e padrões de tickets.

Quem poderá gerenciar as macros

Podem editar as macros todos os agentes que tiverem no seu perfil de acesso o parâmetro Permitir criar macros pessoais ou  Permitir criar macros compartilhadas marcados. As macros compartilhadas possuem três opções: com todas as equipes, com as seguintes equipes e com os seguintes agentes.

Como gerenciar suas macros

Na guia Principal do sistema acesse a opção Configurações. No menu da esquerda localize o grupo Automação e em seguida a opção Macros.

Através desta tela você poderá editar as macros existentes ou então criar novas macros. Também é possível clonar uma macro existente.

Observe que somente as macros que estiverem habilitadas é que serão executadas pelo Movidesk.

Como faço para clonar uma macro

Na listagem de macros basta selecionar a macro que você deseja clonar e em seguida escolher a opção clonar macro selecionado no bloco de opções da listagem.

A clonagem de uma macro poderá ser importante se você quiser executar uma ação similar a outra que já esteja configurada no sistema sem a necessidade de passar por todo o processo de criação da macro. Após clonada, você poderá modificar livremente o que for necessário na nova macro.

Cadastrando uma macro

O cadastro da macro consistem em dois passos básicos. O primeiro é definir o tipo do compartilhamento da macro e o segundo as ações que essa macro irá executar.

Compartilhando uma macro

Existem dois tipos básicos de macros. As macros pessoais e as macros compartilhadas. Macros pessoais estarão disponíveis somente para o agente que a criou, enquanto macros compartilhadas poderão ser utilizadas por outros agentes.

Ao optar por compartilhar uma macro, você será questionado se essa macro estará disponível para todos os agentes ou apenas para agentes de equipes específicas.
Observe que um ou outro tipo de compartilhamento poderá não estar disponível em função do seu nível de acesso ao Movidesk.
As ações

As ações são as alterações que serão feitas no ticket quando a macro for aplicada pelo agente. Todos os campos de um ticket, com exceção do cliente poderão ser automatizados através do uso da macro.

Uma macro pode executar uma ou mais ações. Veja a relação de ações disponíveis:

AçãoComentário
Alterar tipo do ticketMuda a definição se o ticket é público ou interno
Alterar statusAltera o status ou justificativa do ticket
Alterar serviçoAltera o serviço do ticket
Alterar categoriaAltera a categoria do ticket
Alterar urgênciaAltera a urgência do ticket
Alterar responsávelAltera o responsável pelo ticket
Definir assuntoAltera o assunto do ticket
Incluir TAGsAdiciona TAGs ao ticket
Definir TAGsElimina as TAGs existentes e adiciona novas
Remover TAGsRemove todas as TAgs do ticket
Definir texto da açãoInsere no conteúdo da ação um texto específico.

 

Após aplicar uma macro com esse campo é necessário confirmar a gravação da ação no ticket.

Definir tipo da açãoAltera o tipo da ação que esta sendo incluída.

 

Após aplicar uma macro com esse campo é necessário confirmar a gravação da ação no ticket.

Definir anexos da açãoInsere arquivos anexados a ação que esta sendo incluída.

 

Após aplicar uma macro com esse campo é necessário confirmar a gravação da ação no ticket.

Definindo texto da ação

Uma das ações mais importantes da macro é a criação de textos padrões que poderão ser utilizados nos tickets.

Todas as características do texto podem ser customizadas, desde a formatação da fonte ou da cor até o conteúdo do mesmo, e o que da um grande poder de customização são as variáveis dinâmicas.

Além de textos, é possível adicionar imagens e vídeos para compor a descrição da ação.

⚠️Atenção: Vídeos nas macros devem estar em locais públicos, como YouTube. Caso contrário, ocorrerá um erro.

As variáveis dinâmicas (Place holders)

Variáveis dinâmicas são expressões regulares que podem ser incluídas na ação. Na hora da execução da macro, elas são substituídas pelo valor correspondente no ticket. As variáveis dinâmicas podem ser usadas nas ações de Definir assunto e Definir texto da ação.

Para incluir as variáveis dinâmicas, basta digitar a chave {. Feito isso, o sistema irá exibir a relação com todas as variáveis dinâmicas que estiverem disponíveis.

VariávelDescrição
ticket.idNúmero do ticket
ticket.typeTipo do ticket (Público/Interno)
ticket.openchannelCanal de abertura do ticket (E-mail, via sistema pelo Cliente, via sistema pelo Agente)
ticket.receivedinConta de e-mail na qual o ticket foi recebido
ticket.statusStatus do ticket
ticket.statusbaseStatus base do status do ticket
ticket.justificationJustificativa do ticket
ticket.categoryCategoria do ticket
ticket.urgencyUrgência do ticket
ticket.urlURL para acesso direto ao ticket
ticket.tagsTAGs do ticket
ticket.subjectAssunto do ticket
ticket.actioncountQuantidade de ações do ticket
ticket.opendateData de abertura do ticket
ticket.closedateData de conclusão do ticket
ticket.lastactionregistrationdateData de registro da última ação do ticket
ticket.client.nameNome do cliente do ticket
ticket.client.hierachicalOrganização do cliente do ticket
ticket.client.profileSe o cliente do ticket é pessoa, empresa ou departamento
ticket.client.persontypeSe o cliente do ticket é agente ou cliente
ticket.client.accessprofilePerfil de acesso do cliente do ticket
ticket.client.countryPais do cliente do ticket
ticket.client.cityCidade do cliente do ticket
ticket.client.stateEstado do cliente do ticket
ticket.generator.nameNome do usuário que abriu o ticket
ticket.generator.teamEquipe(s) do usuário que abriu o ticket
ticket.generator.hierachicalOrganização do usuário que abriu o ticket
ticket.generator.profileSe o usuário que abriu o ticket é pessoa, empresa ou departamento
ticket.generator.persontypeSe o usuário que abriu o ticket é agente ou cliente
ticket.generator.accessprofilePerfil de acesso do usuário que abriu o ticket
ticket.generator.countryPais do usuário que abriu o ticket
ticket.generator.cityCidade do usuário que abriu o ticket
ticket.generator.stateEstado do usuário que abriu o ticket
ticket.owner.nameNome do responsável pelo ticket
ticket.owner.teamEquipe(s) do responsável pelo ticket
ticket.owner.typeSe o o responsável pelo ticket é um Agente ou uma Equipe
ticket.owner.hierachicalOrganização do responsável pelo ticket
ticket.owner.profileSe o responsável pelo ticket é pessoa, empresa ou departamento
ticket.owner.persontypeSe o responsável pelo ticket é agente ou cliente
ticket.owner.accessprofilePerfil de acesso do responsável pelo ticket
ticket.owner.countryPais do responsável pelo ticket
ticket.owner.cityCidade do responsável pelo ticket
ticket.owner.stateEstado do responsável pelo ticket
ticket.firstaction.datedata de inclusão da primeira ação do ticket
ticket.firstaction.descriptionDescrição da primeira ação do ticket
ticket.firstaction.numberNúmero da primeira ação do ticket. Será sempre 1
ticket.firstaction.typeSe a primeira ação do ticket é pública ou interna
ticket.firstaction.generator.nameNome do gerador da primeira ação do ticket
ticket.firstaction.generator.teamEquipe do usuário que incluiu a primeira ação do ticket
ticket.firstaction.generator.hierachicalOrganização do usuário que incluiu a primeira ação do ticket
ticket.firstaction.generator.profileSe o usuário que incluiu a primeira ação do ticket é pessoa, empresa ou departamento
ticket.firstaction.generator.persontypeSe o usuário que incluiu a primeira ação do ticket é agente ou cliente
ticket.firstaction.generator.accessprofilePerfil de acesso do usuário que incluiu a primeira ação do ticket
ticket.firstaction.generator.countryPais do usuário que incluiu a primeira ação do ticket
ticket.firstaction.generator.cityCidade do usuário que incluiu a primeira ação do ticket
ticket.firstaction.generator.stateEstado do usuário que incluiu a primeira ação do ticket
ticket.firstaction.attachementsArquivos anexados a primeira ação do ticket
ticket.firstaction.receivedinConta de e-mail onde foi recebida a primeira ação do ticket
ticket.lastaction.dateData de inclusão da ação que esta sendo incluída ou editada
ticket.lastaction.descriptionDescrição da ação que esta sendo incluída ou editada
ticket.lastaction.numberNúmero da ação que esta sendo incluída ou editada
ticket.lastaction.typeSe a ação que está sendo incluída ou editada é pública ou interna
ticket.lastaction.generator.nameNome do usuário que incluiu ou editou a ação
ticket.lastaction.generator.teamEquipe(s) do usuário que incluiu ou editou a ação
ticket.lastaction.generator.hierachicalOrganização do usuário que incluiu ou editou a ação
ticket.lastaction.generator.profileSe o usuário que incluiu ou editou a ação é pessoa, empresa ou departamento
ticket.lastaction.generator.persontypeSe o usuário que incluiu ou editou a ação é agente ou cliente
ticket.lastaction.generator.accessprofilePerfil de acesso do usuário que incluiu ou editou a ação
ticket.lastaction.generator.countryPais do usuário que incluiu ou editou a ação
ticket.lastaction.generator.cityCidade do usuário que incluiu ou editou a ação
ticket.lastaction.generator.stateEstado do usuário que incluiu ou editou a ação
ticket.lastaction.attachementsArquivos anexados a ação que esta sendo incluída ou editada
ticket.lastaction.receivedinConta de e-mail onde foi recebida a ação que esta sendo incluída ou editada
tenant.nameNome da sua empresa
tenant.urlURL para acesso ao seu Movidesk

Utilizando uma macro

Após ter feito o cadastramento das suas macros, será possível acessá-las na abertura de um ticket ou na edição de um ticket que já esteja aberto. Para isso, vá até o menu Opções localizado na barra superior azul do ticket. Nesse menu, selecione a opção Aplicar macro.

Após selecionar a opção Aplicar macro, será aberta uma nova janela com a relação de todas as macros disponíveis. As macros que você utiliza com frequência poderão ser marcadas como favoritas através do ícone 1.png. Observe que as macros definidas como favoritas são exibidas primeiro na relação de macros. Em seguida vem as macros que não estiverem como favoritas, sempre em ordem alfabética.

Se você clicar sobre a macro, serão exibidos em detalhes todas as ações executadas por ela. Para aplicar a macro no ticket você poderá usar o ícone 2.png ao lado do nome da macro ou o botão 3.png no rodapé da página.

Macros e criação de tickets via API

As macros do Movidesk são executadas somente quando o ticket é criado ou atualizado pela interface da plataforma (tela). Quando um ticket é criado via API, o fluxo de execução é diferente e as macros não são disparadas, mesmo que o serviço associado ao ticket possua macros configuradas. 

Importante: Se você utiliza a API para criação de tickets e precisa aplicar regras automáticas, avalie o uso de outras estratégias de automação disponíveis na plataforma ou trate essas regras diretamente na integração.

Quando as ações da macro serão salvas no ticket

Se você estiver abrindo um novo ticket, sempre terá que clicar no botão 4.pngexistente na tela de abertura do ticket. Mesmo tendo aplicado a macro, o ticket só será efetivamente aberto quando você clicar no botão de salvar.

Se a aplicação da macro ocorrer em um ticket que já estiver aberto, as ações serão salvas de forma automática imediatamente após a aplicação da macro, com exceção das ações de Definir anexos da ação, Definir tipo da ação e Definir texto da ação. Essas três ações irão preencher os campos da ação, mas ela só será salva quando você clicar no botão 5.png. Isso ocorre porque é comum precisar complementar o texto da ação antes de enviar ao cliente. Também existe a opção de simplesmente registrar a ação com o conteúdo da macro ou mesmo resolver ou cancelar o ticket.