> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Macros
A seção de **Macros** permite que você crie e gerencie macros para automatizar tarefas repetitivas no sistema. Com as macros, você pode definir sequências de ações que serão executadas automaticamente em uma ordem específica, economizando tempo e garantindo consistência nas operações realizadas pela equipe.
Cada macro pode ter um nome descritivo, configuração de visibilidade (privada ou pública) e uma sequência de ações que serão executadas na ordem definida. As macros são especialmente úteis para padronizar processos comuns, como atribuir conversas a equipes específicas, aplicar etiquetas, ou realizar outras ações recorrentes.
## Acessando Macros
Para acessar a área de gerenciamento de macros:
1. No menu lateral esquerdo, clique em **Settings** (Configurações).
2. Na lista de opções de configurações, selecione **Macros**.
A tela principal de macros será exibida, mostrando todas as macros criadas ou uma mensagem indicando que nenhuma macro foi criada ainda.
***
## Pesquisando Macros
A barra de pesquisa permite localizar macros rapidamente pelo nome.
### Como pesquisar
1. Na parte superior da tela, localize o campo **"Search macros..."** com o ícone de lupa
2. Digite o nome ou parte do nome da macro desejada
3. A tabela de macros será atualizada automaticamente conforme o termo digitado, mostrando apenas as macros que correspondem à busca
A busca é realizada em tempo real, facilitando a localização de macros específicas quando há muitas cadastradas.
***
## Criando uma Nova Macro
Existem duas formas de iniciar a criação de uma nova macro:
### Opção 1: Botão no Cabeçalho
1. Clique no botão verde **"+ New Macro"** localizado no canto superior direito da tela
### Opção 2: Botão no Estado Vazio
Quando não há macros criadas, clique no botão verde **"New Macro"** no centro da tela.
### Preenchendo o Formulário de Criação
Após clicar em qualquer um dos botões, um modal será exibido com fundo escuro contendo:
* **Título:** **"New Macro"** no topo do modal
* **Botão de Fechar:** Um ícone "X" no canto superior direito para fechar o modal sem salvar
No formulário, preencha os seguintes campos:
#### 1. Nome (Obrigatório)
* **Campo:** **Name** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Campo de texto simples
* **Descrição:** Nome identificador da macro
* **Exemplo:** "Commercial Leader", "Atribuir Equipe de Vendas", "Resposta Padrão"
* **Recomendação:** Use nomes descritivos que indiquem claramente o propósito da macro
* **Localização:** Primeiro campo do formulário
#### 2. Visibilidade
* **Campo:** **Visibility**
* **Tipo:** Seleção de opção (radio buttons)
* **Descrição:** Define quem pode usar esta macro
* **Opções disponíveis:**
**Private (Privada):**
* **Ícone:** Cadeado (lock icon)
* **Descrição:** "This macro will be private and available only to you"
* **Comportamento:** A macro será visível e utilizável apenas por você
* **Recomendação:** Use para macros pessoais ou específicas do seu trabalho
**Public (Pública):**
* **Ícone:** Globo (globe icon)
* **Descrição:** "This macro will be public and available to all agents"
* **Comportamento:** A macro será visível e utilizável por todos os agentes do sistema
* **Recomendação:** Use para macros que padronizam processos da equipe
* **Seleção:** A opção selecionada fica destacada com uma borda verde
* **Padrão:** Private (Privada) é selecionada por padrão
* **Localização:** Segundo campo do formulário, abaixo do campo Name
#### 3. Ações
* **Campo:** **Actions**
* **Tipo:** Lista de ações configuráveis
* **Descrição:** Define a sequência de ações que a macro executará
* **Texto Explicativo:** "Macros will execute actions in the defined order" - indica que as ações serão executadas na ordem em que são definidas
* **Botão de Adicionar:** **"+ Add Action"** localizado no canto direito do cabeçalho da seção, permite adicionar novas ações à macro
**Configurando uma Ação:**
Cada ação possui dois componentes principais:
1. **Action (Ação):**
* **Tipo:** Dropdown/Select
* **Descrição:** Tipo de ação a ser executada
* **Exemplo:** "Atribuir equipe" (Assign team)
* **Texto de Ajuda:** Abaixo da seleção, aparece uma descrição explicativa da ação selecionada (ex: "Atribui a conversa a uma equipe específica")
* **Localização:** Primeiro campo de cada ação
2. **Configuration (Configuração):**
* **Tipo:** Dropdown/Select
* **Descrição:** Parâmetros específicos para a ação selecionada
* **Placeholder:** "Select an option" quando nenhuma opção foi selecionada
* **Comportamento:** As opções disponíveis dependem da ação selecionada
* **Exemplo:** Se a ação for "Atribuir equipe", a configuração permitirá selecionar qual equipe será atribuída
* **Localização:** Segundo campo de cada ação, ao lado do campo Action
**Tipos de Ações Disponíveis:**
* **Atribuir equipe (Assign team):** Atribui a conversa a uma equipe específica
* Outras ações podem estar disponíveis dependendo das funcionalidades do sistema
**Adicionando Múltiplas Ações:**
1. Clique no botão **"+ Add Action"** para adicionar uma nova ação à sequência
2. Configure a ação e sua configuração
3. Repita o processo para adicionar quantas ações forem necessárias
4. As ações serão executadas na ordem em que aparecem na lista (de cima para baixo)
* **Localização:** Terceiro campo do formulário, abaixo da seção Visibility
### Finalizando a Criação
Na parte inferior do modal, há dois botões de ação:
* **Cancel:** Botão cinza escuro com texto branco, localizado à esquerda
* **Create:** Botão verde/turquesa brilhante com texto branco, localizado à direita
Após preencher os campos desejados:
1. Revise as informações inseridas, especialmente o nome, visibilidade e a sequência de ações
2. Certifique-se de que todas as ações têm suas configurações preenchidas corretamente
3. Clique no botão verde **"Create"** para criar a macro
4. Ou clique em **"Cancel"** para fechar o modal sem salvar
5. Alternativamente, clique no ícone "X" no canto superior direito para fechar sem salvar
A macro será criada e aparecerá imediatamente na tabela de macros.
***
## Visualizando Macros na Tabela
Após criar macros, elas serão exibidas em uma tabela com as seguintes colunas:
### Colunas da Tabela
* **Name:** Nome da macro (ordenável - indicado por seta para cima/baixo)
* Exibe o nome descritivo da macro (ex: "Commercial Leader")
* Abaixo do nome, exibe o número de ações configuradas (ex: "1 action")
* **Created by:** Criador da macro
* Exibe o nome do usuário que criou a macro ou um traço ("-") se não houver informação disponível
* **Updated by:** Último usuário que atualizou a macro
* Exibe o nome do usuário que atualizou a macro ou um traço ("-") se não houver informação disponível
* **Visibility:** Visibilidade da macro
* Exibe um ícone de cadeado seguido de "Private" em texto azul para macros privadas
* Exibe um ícone de globo seguido de "Public" para macros públicas
* **ID:** Identificador único da macro (ordenável - indicado por seta para cima/baixo)
* Exibe o UUID da macro (ex: "5d83859d-3d52-4a26-a14f-27c63c868be5")
* **Actions:** Menu de ações para gerenciar a macro
* Ícone de três pontos verticais (`...`) que abre um menu dropdown com opções
### Funcionalidades da Tabela
* **Ordenação:** Clique nos cabeçalhos das colunas "Name" ou "ID" para ordenar a tabela em ordem crescente ou decrescente
* **Busca Integrada:** A barra de pesquisa acima da tabela filtra os resultados em tempo real
* **Visualização de Ações:** O número de ações configuradas é exibido abaixo do nome da macro, facilitando a identificação rápida da complexidade da macro
***
## Visualizando uma Macro
Para visualizar os detalhes completos de uma macro:
1. Na tabela de macros, localize a macro que deseja visualizar
2. Na coluna **Actions**, clique no ícone de três pontos (`...`) correspondente à macro
3. Um menu dropdown será exibido com as opções disponíveis
4. No menu dropdown, clique em **View** (acompanhado de um ícone de olho)
Uma tela ou modal será exibido mostrando os detalhes completos da macro, incluindo todas as ações configuradas e suas respectivas configurações.
***
## Executando uma Macro
Para executar uma macro manualmente:
1. Na tabela de macros, localize a macro que deseja executar
2. Na coluna **Actions**, clique no ícone de três pontos (`...`) correspondente à macro
3. Um menu dropdown será exibido com as opções disponíveis
4. No menu dropdown, clique em **Execute** (acompanhado de um ícone de play/triângulo)
A macro será executada imediatamente, realizando todas as ações configuradas na ordem definida.
**Atenção:** Certifique-se de que você está no contexto correto (por exemplo, uma conversa específica) antes de executar a macro, pois as ações serão aplicadas ao contexto atual.
***
## Editando uma Macro
Para modificar uma macro existente:
1. Na tabela de macros, localize a macro que deseja editar
2. Na coluna **Actions**, clique no ícone de três pontos (`...`) correspondente à macro
3. Um menu dropdown será exibido com as opções disponíveis
4. No menu dropdown, clique em **Edit** (acompanhado de um ícone de lápis)
5. Um modal semelhante ao de criação será aberto, mas com o título **"Edit Macro"** e os campos já preenchidos com os valores atuais da macro
6. Modifique os campos desejados:
* Nome
* Visibilidade (Private/Public)
* Ações (adicione, remova ou reordene ações conforme necessário)
* Configurações de cada ação
7. Revise as alterações
8. Clique no botão verde **"Update"** ou **"Save"** para salvar as alterações
9. Ou clique em **"Cancel"** para descartar as alterações
As alterações serão aplicadas imediatamente e refletidas na tabela de macros.
**Nota:** Ao editar uma macro pública, as alterações afetarão todos os usuários que têm acesso à macro. Considere criar uma nova macro se precisar de uma versão diferente para uso pessoal.
***
## Excluindo uma Macro
Para remover uma macro:
1. Na tabela de macros, localize a macro que deseja excluir
2. Na coluna **Actions**, clique no ícone de três pontos (`...`) correspondente à macro
3. Um menu dropdown será exibido com as opções disponíveis
4. No menu dropdown, clique em **Delete** (acompanhado de um ícone de lixeira, exibido em texto vermelho para indicar uma ação destrutiva)
5. Um diálogo de confirmação será exibido
6. Confirme a exclusão no diálogo que aparecer
**Atenção:**
* A exclusão de uma macro é permanente e não pode ser desfeita
* Se a macro for pública, todos os agentes perderão acesso a ela após a exclusão
* Verifique se não há processos ou usuários dependendo desta macro antes de excluí-la
* Considere desativar ou tornar a macro privada em vez de excluí-la se houver dúvidas sobre seu uso futuro
***
## Considerações Finais
* **Nomenclatura Clara:** Use nomes descritivos e claros para que todos os membros da equipe entendam o propósito de cada macro
* **Ordem das Ações:** Lembre-se de que as ações são executadas na ordem em que são definidas. Planeje a sequência cuidadosamente para garantir o resultado desejado
* **Visibilidade:** Use macros privadas para processos pessoais e macros públicas para padronizar processos da equipe
* **Teste Antes de Compartilhar:** Teste macros públicas antes de disponibilizá-las para toda a equipe, garantindo que funcionam corretamente
* **Documentação:** Considere usar nomes descritivos que funcionem como documentação do processo automatizado
* **Revisão Regular:** Revise periodicamente as macros existentes para garantir que continuam relevantes e funcionando corretamente
* **Reutilização:** Crie macros para tarefas que são realizadas frequentemente, maximizando o ganho de eficiência
* **Configurações Corretas:** Certifique-se de que todas as ações têm suas configurações preenchidas corretamente antes de criar ou atualizar uma macro
As macros são uma ferramenta poderosa para automatizar tarefas repetitivas, economizando tempo da equipe e garantindo consistência nas operações realizadas no sistema. O uso adequado de macros pode aumentar significativamente a produtividade e a padronização dos processos de trabalho.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.