zendesk-macro-export-import

eesel Team
Written by

eesel Team

Last edited 25 fevereiro 2026

{
  "title": "Como exportar e importar macros do Zendesk: Guia completo de 2026",
  "slug": "zendesk-macro-export-import",
  "locale": "pt",
  "date": "2026-02-24",
  "updated": "2026-02-24",
  "template": "default",
  "excerpt": "Descubra os melhores métodos para exportar e importar macros do Zendesk, desde aplicativos gratuitos de terceiros até soluções de API e ferramentas de desenvolvedor.",
  "categories": [
    "Zendesk",
    "Guides"
  ],
  "tags": [
    "Zendesk",
    "Macros",
    "Data Export",
    "Customer Support",
    "Workflow Automation"
  ],
  "readTime": 9,
  "author": 16,
  "reviewer": 14,
  "seo": {
    "title": "Como exportar e importar macros do Zendesk: Guia completo de 2026",
    "description": "Descubra os melhores métodos para exportar e importar macros do Zendesk, desde aplicativos gratuitos de terceiros até soluções de API e ferramentas de desenvolvedor.",
    "image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-c98dbbb5-26f6-40d1-85fe-0af2270fcb42"
  },
  "coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-c98dbbb5-26f6-40d1-85fe-0af2270fcb42",
  "coverImageAlt": "Imagem do banner para Como exportar e importar macros do Zendesk: Guia completo de 2026",
  "coverImageWidth": 1920,
  "coverImageHeight": 1080,
  "faqs": {
    "heading": "Perguntas Frequentes",
    "type": "blog",
    "answerType": "html",
    "faqs": [
      {
        "question": "Posso usar a API do Zendesk para importar macros em massa de um arquivo CSV?",
        "answer": "Não diretamente. A API oferece suporte à criação de macros uma de cada vez por meio de solicitações POST, mas não há endpoint de importação em massa nativo. Para importação em massa real de CSV ou Excel, você precisará de uma ferramenta como LEAFWORKS Macro Manager ou Salto CLI."
      },
      {
        "question": "Existe uma maneira gratuita de importar macros para o Zendesk depois de exportá-las?",
        "answer": "As opções gratuitas para importação são limitadas. O Salto CLI é gratuito e oferece suporte à importação em massa, mas requer conhecimento técnico. Se você precisar de uma solução de importação amigável, o LEAFWORKS Macro Manager por US$ 199 é a opção profissional mais econômica."
      },
      {
        "question": "Qual é a diferença entre Swifteq e LEAFWORKS para exportação e importação de macros do Zendesk?",
        "answer": "O Swifteq Macro Export é gratuito, mas lida apenas com exportações para CSV. O LEAFWORKS Macro Manager custa US$ 199, mas oferece suporte à exportação e importação no formato Excel, além de incluir visualização de conteúdo dinâmico e recursos de edição em massa."
      },
      {
        "question": "A exportação de macros inclui traduções de conteúdo dinâmico?",
        "answer": "Sim, todos os quatro métodos incluem conteúdo dinâmico. Swifteq e LEAFWORKS exportam conteúdo dinâmico para todos os idiomas. A API do Zendesk retorna espaços reservados de conteúdo dinâmico na matriz de ações. O Salto captura o conteúdo dinâmico como parte do backup completo da configuração."
      },
      {
        "question": "Posso migrar macros de uma instância do Zendesk para outra usando essas ferramentas?",
        "answer": "Sim, mas você precisará de uma ferramenta que ofereça suporte à exportação e importação. LEAFWORKS Macro Manager e Salto CLI são suas melhores opções. Exporte da instância de origem, modifique o arquivo, se necessário (atualizando nomes de marcas, etc.) e, em seguida, importe para a instância de destino."
      },
      {
        "question": "Qual formato de dados devo escolher para minha exportação de macro do Zendesk?",
        "answer": "CSV é melhor para auditorias simples e análise de planilhas. O Excel funciona melhor se você precisar editar e reimportar. JSON é ideal para integrações personalizadas. NaCl (via Salto) é relevante apenas se você estiver usando fluxos de trabalho de configuração como código."
      }
    ],
    "supportLink": null
  }
}
---

Se sua equipe usa o Zendesk há algum tempo, você provavelmente acumulou uma grande coleção de macros. Essas respostas automatizadas e ações de tickets economizam incontáveis horas dos agentes. Mas o que acontece quando você precisa fazer backup delas, migrar para uma nova instância ou limpar duplicatas? Saber como exportar e importar macros do Zendesk torna-se essencial nessas situações.

O Zendesk não fornece um botão simples de "exportar" na interface de administração, então você precisará saber onde procurar. Neste guia, vamos percorrer quatro métodos diferentes para obter seus dados de macro (e colocá-los de volta), desde soluções gratuitas sem código até ferramentas amigáveis para desenvolvedores.

![Compare estes quatro métodos de gerenciamento de macros do Zendesk para encontrar o melhor equilíbrio entre custo, esforço técnico e flexibilidade de dados para sua equipe.](https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/38f8f622-ea9a-4db5-9f26-83aab6ae8053)

## Método 1: Usando o [Swifteq Macro Export](https://www.zendesk.com/apps/support/903149/macro-export/) (Gratuito)

Para a maioria das equipes, o caminho mais fácil é o aplicativo Macro Export da Swifteq. É gratuito, não requer configuração técnica e entrega seus dados em um formato CSV limpo.

A Swifteq é uma parceira de tecnologia qualificada do Zendesk com mais de 14 aplicativos de suporte. Sua ferramenta Macro Export se tornou popular porque resolve um problema específico sem adicionar complexidade.

### Passo 1: Instale o Aplicativo

Navegue até a [listagem do Zendesk Marketplace](https://www.zendesk.com/apps/support/903149/macro-export/) e instale o aplicativo. O processo leva cerca de um minuto e requer permissões de administrador em sua conta do Zendesk.

### Passo 2: Conecte Sua Conta

Após a instalação, registre-se em [swifteq.com/zendesk-export-macros](https://swifteq.com/zendesk-export-macros) e autorize o aplicativo a acessar seus dados do Zendesk. A conexão usa o fluxo OAuth seguro do Zendesk, para que suas credenciais permaneçam protegidas.

### Passo 3: Execute a Exportação

Clique no botão de exportação na interface do aplicativo. Em poucos minutos, você receberá um e-mail com arquivos CSV contendo:

- Todos os metadados da macro (títulos, descrições, datas de criação/atualização)
- Cada ação que cada macro executa
- Conteúdo dinâmico para todos os idiomas
- Condições e restrições

### O Que Está Incluído e O Que Não Está

A exportação cobre tudo o que os agentes veem ao usar macros, além de detalhes de back-end, como quando cada macro foi modificada pela última vez. No entanto, o Swifteq Macro Export é apenas para exportação. Se você precisar importar macros de volta para o Zendesk ou mesclar dados entre instâncias, precisará de uma ferramenta diferente.

**Melhor para:** Equipes que fazem auditorias únicas, backups ou revisões de fluxo de trabalho que desejam a solução mais simples possível.

---

## Método 2: Usando o [LEAFWORKS Macro Manager](https://www.zendesk.com/marketplace/apps/support/457551/macro-manager-by-leafworks/) (US$ 199)

Quando você precisa de funcionalidade bidirecional (exportação e importação), o LEAFWORKS Macro Manager é a escolha profissional. Por US$ 199 para uma compra única, é um investimento que compensa para equipes que gerenciam bibliotecas de macros complexas.

A LEAFWORKS é uma Parceira Premier do Zendesk com sede na região DACH. Eles atenderam mais de 300 clientes, desde startups de 3 agentes até empresas com mais de 999 agentes em 30 países.

### Principais Características

Ao contrário das alternativas gratuitas, o Macro Manager lida com todo o ciclo de vida:

- **Exportação em massa para Excel** Baixe todas as macros em um formato fácil de editar
- **Importação em massa do Excel** Carregue macros modificadas de volta para o Zendesk
- **Ativação e exclusão em massa** Gerencie o status da macro em toda a sua biblioteca
- **Visualização de conteúdo dinâmico** Teste como as macros são renderizadas em diferentes idiomas antes de implantar
- **Pesquisa aprimorada** Encontre macros por nome ou valores de conteúdo dinâmico

### Passo 1: Compre e Instale

Compre o aplicativo no [Zendesk Marketplace](https://www.zendesk.com/marketplace/apps/support/457551/macro-manager-by-leafworks/) e instale-o em sua instância do Zendesk. A taxa de US$ 199 é uma taxa única, não uma assinatura.
![A interface do LEAFWORKS Macro Manager para editar e visualizar respostas com modelos, incluindo conteúdo dinâmico e visualizações em vários idiomas.](https://457551.apps.zdusercontent.com/457551/assets/1763369393-216ef95a4dfc267d82bb52c2eaa4c50c/screenshot-1.png)

### Passo 2: Exporte Suas Macros

Abra o aplicativo Macro Manager e selecione a exportação em massa. Você receberá um arquivo Excel com todos os dados da macro organizados em colunas para facilitar a edição.

### Passo 3: Edite e Importe de Volta

Faça suas alterações no Excel (atualizando respostas, corrigindo conteúdo dinâmico, reorganizando categorias) e, em seguida, use a função de importação para enviar as alterações de volta para o Zendesk. O aplicativo valida seu arquivo antes de importar para evitar erros.


### Alternativa: Universal Toolkit

Se sua equipe usa vários aplicativos LEAFWORKS, considere o [Universal Toolkit](https://www.zendesk.com/apps/support/1147728/universal-toolkit-by-leafworks/) por US$ 9 por agente por mês. Ele agrupa o Macro Manager com seis outros aplicativos de produtividade e economiza até 50% em comparação com a compra individual.

**Melhor para:** Equipes que atualizam macros regularmente, gerenciam conteúdo em vários idiomas ou migram entre instâncias do Zendesk.

---

## Método 3: Usando a [API do Zendesk](https://developer.zendesk.com/api-reference/ticketing/business-rules/macros/)

Para equipes com recursos de desenvolvimento, a API do Zendesk oferece a maior flexibilidade. Você obtém controle total sobre os formatos de dados e pode automatizar as exportações em uma programação.


### O Endpoint da API

O endpoint principal para operações de macro é:

GET /api/v2/macros.json


Isso retorna um objeto JSON contendo todas as macros acessíveis ao usuário autenticado. Os administradores podem recuperar qualquer macro na conta; os agentes só podem ver as macros compartilhadas com eles.

### Parâmetros de Consulta

Você pode refinar sua exportação com estes parâmetros:

- `access=personal` Apenas macros pessoais
- `access=account` Todas as macros da conta (somente administrador)
- `active=true` Apenas macros ativas
- `per_page=100` Controle a paginação (útil para grandes bibliotecas)

### Passo 1: Gere Credenciais da API

No Admin do Zendesk, navegue até Canais > API e crie um token. Você precisará do token mais seu subdomínio do Zendesk para autenticar as solicitações.


### Passo 2: Faça a Solicitação

Usando curl ou seu cliente HTTP preferido:

```bash
curl https://yourdomain.zendesk.com/api/v2/macros.json \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Passo 3: Converta JSON para CSV

A API retorna JSON, que você precisará converter para análise de planilha. Aqui está um script Python simples:

import json, csv

with open('macros.json') as f:
    data = json.load(f)

with open('macros.csv', 'w', newline='') as f:
    writer = csv.DictWriter(f, fieldnames=['id', 'title', 'description', 'active'])
    writer.writeheader()
    for macro in data['macros']:
        writer.writerow(macro)

Limites de Taxa a Conhecer

Seu plano determina os limites de uso da API:

PlanoSolicitações por Minuto
Essencial10
Equipe200
Profissional400
Empresa700

Fonte: Documentação de Limites de Taxa do Zendesk

Limitações de Importação

Embora a API ofereça suporte à criação e atualização de macros individuais por meio de solicitações POST e PUT, não há um verdadeiro endpoint de "importação em massa". Cada macro deve ser processada separadamente, tornando as importações em larga escala mais lentas do que usar um aplicativo dedicado como o LEAFWORKS Macro Manager.

Melhor para: Equipes de desenvolvimento que criam integrações personalizadas ou automatizam exportações agendadas.


Método 4: Usando o Salto CLI (Ferramenta de Desenvolvedor)

O Salto oferece uma abordagem única: configuração como código para o Zendesk. Sua ferramenta CLI gratuita trata sua configuração do Zendesk (incluindo macros) como código com controle de versão.

Como Funciona

O Salto usa uma linguagem declarativa chamada NaCl (Not Another Configuration Language) para representar as configurações do Zendesk. Você busca sua instância inteira, modifica os arquivos em seu IDE e, em seguida, implanta as alterações de volta.

Principais Recursos

  • Backups completos Exporte toda a sua configuração do Zendesk, não apenas macros
  • Controle de versão Rastreie as alterações nas macros usando o Git
  • Importação em massa Implante configurações modificadas de volta no Zendesk
  • Gerenciamento de vários ambientes Copie configurações entre sandbox e produção

O Fluxo de Trabalho

  1. Instale o Salto CLI em sua máquina
  2. Execute salto fetch para baixar sua configuração do Zendesk
  3. Edite os arquivos de macro em seu editor de código preferido
  4. Execute salto deploy para aplicar as alterações

Limitações

O Salto tem uma curva de aprendizado. É apenas de linha de comando, requer compreensão dos conceitos de configuração como código e é exagerado para exportações simples únicas. Mas para equipes que já praticam fluxos de trabalho DevOps, ele se encaixa naturalmente nos processos existentes.

Melhor para: Equipes de desenvolvimento que gerenciam configurações complexas do Zendesk que desejam controle de versão e implantações automatizadas.


Comparando os Métodos de Exportação e Importação de Macros do Zendesk

Aqui está uma comparação lado a lado para ajudá-lo a escolher:

MétodoPreçoExportarImportarFormatoFacilidade de UsoMelhor Para
Swifteq Macro ExportGratuitoCSVFácilAuditorias rápidas, backups
LEAFWORKS Macro ManagerUS$ 199ExcelFácilSincronização bidirecional, edições em massa
API do ZendeskGratuito*⚠️JSONDifícilIntegrações personalizadas
Salto CLIGratuitoNaClDifícilEquipes de desenvolvimento, controle de versão

*Acesso à API incluído no seu plano do Zendesk

Como Escolher

Escolha o Swifteq se: Você precisa de uma exportação rápida e gratuita para fins de auditoria ou backup e não precisa importar dados de volta.

Escolha o LEAFWORKS se: Você atualiza regularmente macros em massa, gerencia conteúdo dinâmico em vários idiomas ou precisa migrar entre instâncias do Zendesk.

Escolha a API se: Você tem desenvolvedores que podem criar integrações personalizadas ou precisa automatizar as exportações em uma programação.

Escolha o Salto se: Sua equipe já usa práticas de configuração como código e você deseja controle de versão para toda a sua configuração do Zendesk.


Levando Seu Fluxo de Trabalho do Zendesk Adiante

Gerenciar macros é apenas uma parte da otimização de sua operação de suporte. Embora as macros lidem com respostas repetitivas por meio de atalhos estáticos, as ferramentas modernas de IA podem levar a automação muito mais longe.

Painel do eesel AI com fontes de conhecimento e integrações conectadas
Painel do eesel AI com fontes de conhecimento e integrações conectadas

Na eesel AI, abordamos a automação de suporte de forma diferente. Em vez de macros estáticas que exigem atualizações manuais, nosso Agente de IA aprende com seus tickets anteriores e central de ajuda para resolver conversas de forma autônoma. Ele não apenas insere respostas pré-escritas. Ele entende o contexto, faz perguntas esclarecedoras e realiza ações como procurar pedidos ou processar reembolsos.

Para equipes que não estão prontas para automação total, nosso Copiloto de IA elabora respostas que os agentes revisam antes de enviar. Cada edição ensina ao sistema sua voz e preferências, para que os rascunhos melhorem com o tempo sem configuração manual.

A principal diferença? As macros são estáticas. Elas fazem exatamente o que você programou para fazer, nada mais. Os colegas de equipe de IA aprendem e se adaptam. Eles lidam com casos extremos que você não previu e melhoram continuamente com o feedback.

Se você já está investindo tempo na otimização de sua biblioteca de macros, pode valer a pena explorar como é o próximo nível de automação. Você pode convidar o eesel AI para sua equipe do Zendesk e ver como ele funciona junto com suas macros existentes.


Compartilhe esta postagem

eesel undefined

Article by

eesel Team