Skip to content

Configuração do Sistema OTOBO / Znuny – Gerenciando Configurações

Configuração do Sistema OTOBO

A Configuração do Sistema em OTOBO/Znuny é o coração para personalizações e ajustes finos: – Todas as alterações passam por uma interface gráfica centralizada. – Versionamento e log de auditoria documentam quem, quando e quais valores foram alterados. – Em caso de erro, cada configuração pode ser revertida para um estado anterior.


1. Guia Rápido: Abrindo a Configuração do Sistema

  1. Faça login como administrador na interface do Agente.
  2. Navegue para Administração → Configuração do Sistema.
  3. Use o campo de busca de texto completo para encontrar imediatamente o que procura entre as aproximadamente 2.200 chaves de configuração.

Iniciando a Busca


2. Encontrando e Abrindo uma Configuração

  1. Digite o termo de busca – a busca de texto completo pesquisa em nomes, descrições e valores.
  2. Selecione o resultado:

Configuração Encontrada

  1. Expanda o widget:

Configuração Expandida


3. Editando e Salvando Valores

  1. Passe o mouse sobre o widget → "Editar esta configuração":

    Ativando o Modo de Edição

  2. Altere o valor e clique em Salvar:

    Configuração ClicadaValor Alterado

  3. Confirme a alteração:

    Configuração Salva


4. Comparação de Versões & Redefinição

Após salvar, um log de diferenças é gerado automaticamente – assim você vê os valores antigos vs. os novos em um piscar de olhos:

Alterações na Diferença

Se algo der errado, você pode voltar para o valor anterior a qualquer momento com "Redefinir":

Redefinindo Configuração


5. Ativando Alterações (Deploy)

Um clique em "Deploy de Configurações" aplica todas as alterações locais:

Executando o DeployConfiguração Implantada


6. Navegação & Árvore de Categorias

A árvore de navegação lateral organiza as configurações por módulos e subgrupos. Cada categoria mostra o número de suas entradas entre parênteses:

Árvore de Navegação

Assim, você mantém a visão geral mesmo com pacotes adicionais (por exemplo, ITSM, FAQ, OAuth).


7. Importação & Exportação de Configurações Completas

  • Exportar: Crie backups ou transfira suas configurações para arquivos .yml.
  • Importar: Carregue configurações previamente exportadas para outro sistema ou sincronize instâncias de teste/staging.

Importar & Exportar


8. Casos Especiais & Melhores Práticas

8.1 Logos & Branding

Altere o logo do Agente centralmente via

bash
Frontend::Agent::LogoURL

Logo de Login do Agente

E ajuste o logo do portal do cliente:

bash
Frontend::Customer::LogoURL

Logo do Portal do Cliente

8.2 Autenticação & SSO

Ative OAuth2/OpenID Connect ou LDAP de forma flexível – completamente via configuração do sistema:

bash
Core::Auth::Agent::Module
Core::Auth::Customer::Module

Configurando OAuth2

8.3 Campos Dinâmicos via Configuração

Adicione novos drivers de Campos Dinâmicos sem precisar programar:

bash
Core::DynamicFields::DriverRegistration

Configurações de Campo Dinâmico

8.4 Controle Individual de Módulos de Menu

Ative ou desative módulos de front-end como AgentTicketZoom ou CustomerTicketSearch via configuração:

bash
Frontend::Agent::ModuleRegistration

Módulo de Menu Ticket


9. Conclusão

A Configuração do Sistema OTOBO/Znuny fornece a você:

  • Função de busca em tempo real: Encontre qualquer chave em segundos.
  • Auditoria & Versionamento: Cada alteração de valor é documentada.
  • Mecanismo de Rollback: Um clique para voltar – sem medo de configurações incorretas.
  • Importação/Exportação: Sincronização perfeita entre instâncias de produção, staging e teste.

Com essas funções, você adapta seu sistema OTOBO de forma segura, transparente e ágil a qualquer novo cenário – desde branding e autenticação até plugins personalizados.


Mais detalhes podem ser encontrados na documentação oficial do OTOBO.

Configurações Populares do Sistema

Aqui estão as 30 configurações mais frequentes em uma tabela clara.

Chave de ConfiguraçãoDescriçãoValor
NotificationSenderEmailEndereço de e-mail do remetente para notificações do sistemasupport@<OTOBO_CONFIG_FQDN>
PostmasterDefaultQueueFila padrão para o Postmaster
FirstnameLastnameOrderOrdem de nome e sobrenome
Elasticsearch::TicketSearchFieldsCampos usados para busca de tickets no Elasticsearch
Elasticsearch::TicketStoreFieldsCampos usados para armazenar tickets no Elasticsearch
GenericAgentAllowCustomScriptExecutionPermite que o Agente Genérico execute scripts próprios
DashboardBackend::AllowCmdOutputPermite a exibição de saídas de console no Dashboard
Ticket::Frontend::CustomerTicketZoom###StateDefaultEstado padrão para a visualização de tickets do cliente
Ticket::Frontend::CustomerDisableCompanyTicketAccessDesativa o acesso do cliente a tickets da empresa
ACL::PossibleNot→Form→<Feldname>Configuração ACL para condições de formulário negadas
PostmasterFollowUpStateEstado de acompanhamento para e-mails do Postmaster
PostmasterFollowUpStateClosedEstado fechado para acompanhamentos do Postmaster
Ticket::Frontend::AgentTicketZoomReplyPermite respostas no zoom de tickets do agente
AgentTicketComposeConfigurações para compor novos tickets de agente
Ticket::Frontend::MenuModule###550-AppointmentMódulo de menu para compromissos no front-end de tickets
Ticket::Frontend::MoveTypeConfigurações para o tipo de movimentação de tickets
Ticket::Frontend::AgentTicketMove###RequiredLockExige bloqueio ao mover tickets por agentes
Ticket::Frontend::TicketNote###OwnerMandatoryExige o campo "Proprietário" em notas de tickets
Core::Crypt::PGPConfigurações de criptografia PGP
CustomerDashboard::Tiles###ServiceCatalog-01Bloco do painel para o Catálogo de Serviços
Frontend::Module###CustomerTicketMessageMódulo de front-end para mensagens de tickets do cliente
CustomerTicketMessageConfiguração para mensagens de tickets do cliente
CustomerDashboard::Tiles###TicketList-01Bloco do painel para a Lista de Tickets
CustomerFrontend::Module###CustomerTicketMessageMódulo de front-end do cliente para mensagens de tickets
Ticket::GenericAgentAllowCustomScriptExecutionPermite que o Agente Genérico execute scripts próprios (módulo ticket)
Ticket::Frontend::AgentTicketNote###SubjectConfiguração de assunto para notas de tickets do agente
Core::Time::Calendar1Configurações de tempo para o Calendário 1
TimeAccountingMódulo de contabilidade de tempo
DynamicField_<Name>Placeholder para campos dinâmicos
Ticket::NumberGenerator::MinCounterSizeTamanho mínimo do contador para números de ticket