Pacotes de configuração
O recurso Pacotes de configuração permite exportar e importar a configuração da sua instalação como um arquivo ZIP portátil. É útil para migrar entre ambientes (preparação → produção), replicar configurações entre clientes ou criar modelos de instalação reutilizáveis.
Disponível a partir de v1.0.0-rc3 (WTO-1116).
O que vem dentro de um pacote?
Um pacote inclui (quando você marca cada categoria no assistente de exportação):- Caixas de entrada — canais conectados (configuração, sem credenciais confidenciais).
- Agentes de IA — prompts, ferramentas, configurações de modelo.
- Regras de automação — regras
trigger → action. - Respostas automáticas.
- Modelos de mensagens — incluindo variáveis declaradas.
- Funções personalizadas — funções personalizadas com permissões.
O que NÃO entra: credenciais (tokens, senhas, chaves API), dados de conversas, contatos, histórico. Os pacotes são configuração, não dados operacionais.
Acessando
Settings → Templates / Bundles (a entrada aparece se você tiver permissão template_bundles.read ou template_bundles.manage).
Exportando um pacote
- Clique em Exportar pacote.
- No assistente, marque as categorias que deseja incluir. Cada categoria expõe a lista de itens disponíveis — você pode optar por exportar tudo ou apenas itens específicos.
- Confirme. O sistema gera um ZIP com a estrutura interna do pacote.
- Faça o download.
bundle-{installation}-{date}.zip. Você pode renomeá-lo livremente após o download.
O que esperar
- Pacotes pequenos (somente modelos e respostas prontas) são lançados rapidamente.
- Pacotes grandes (todos os agentes + regras de automação) podem levar alguns segundos.
- Não há limite de tamanho rígido, mas mantenha o foco nos pacotes (não exporte tudo se precisar migrar apenas um agente).
Importando um pacote
- Clique em Importar pacote.
- Selecione o arquivo ZIP.
- O sistema valida o conteúdo e mostra uma prévia do que será importado.
- Você decide o que importar, sobrescrever ou ignorar item por item.
- Confirme.
Comportamento de conflito
Quando um item do pacote já existe na instalação de destino (mesmo nome/mesmo identificador):- Importar como novo: cria com um sufixo para evitar colisão (por exemplo,
Welcome (imported)). - Substituir: substitui o existente. Use com cuidado na produção.
- Ignorar: ignora esse item específico, mas continua com o resto do pacote.
Não há reversão automática após a confirmação da importação. Faça backup do banco de dados antes de importar para produção.
Casos de uso
1. Preparação → Produção
Você ajusta agentes e automações na preparação, valida com a equipe e exporta um pacote. Na produção, você importa substituindo apenas os itens validados.2. Modelo de instalação
Você mantém um pacote de “modelo padrão” com automações e respostas prontas que toda nova instalação deve ter. Ao criar uma nova instância, basta importar.3. Migração entre clientes (multilocatário)
As empresas que prestam serviços de implementação podem ter um catálogo de pacotes por vertical (varejo, saúde, educação) e importar o relevante ao iniciar um cliente.Permissões
Por padrão, apenas
account_owner obtém manage. Conceda a outras funções com cautela — manage permite substituir configurações críticas.
Limitações conhecidas
- As credenciais não viajam. Depois de importar uma caixa de entrada WhatsApp, você precisa reconectar o canal manualmente (o token da instância não está no pacote).
- Referências cruzadas. Se um agente fizer referência a um espaço Knowledge Nexus que não existe no destino, o agente será importado, mas a referência será quebrada (visível na UI como “espaço não encontrado”). Configure espaços no destino antes de importar.
- Versões de esquema. Pacotes exportados em diferentes versões de CRM podem precisar de adaptação. Mantenha a preparação e a produção próximas da versão.