Toda equipe encontra um detalhe do Chatwoot que não combina com a própria rotina. Um botão que deveria estar em outro lugar, uma informação que falta na conversa, um atalho que evitaria três cliques. A vontade natural é abrir o código e ajustar.
O problema aparece na próxima atualização.
Por que não editar o núcleo
Alterar diretamente o código do Chatwoot resolve hoje e cobra depois. A cada nova versão, o arquivo modificado precisa ser comparado, reaplicado e testado. Em pouco tempo, a equipe deixa de atualizar para não quebrar a personalização. O sistema fica mais seguro? Não. Fica parado.
Personalização que impede evolução não é personalização. É uma dependência escondida.
O que é um script desacoplado
A ideia é simples: usar os pontos de extensão que o próprio Chatwoot oferece, sem alterar o núcleo. O script roda no frontend, adiciona o comportamento desejado e pode ser removido sem deixar cicatriz no produto.
// Exemplo ilustrativo de um script de interface.
// A API real depende da versão e da instalação.
const atalho = document.createElement('button');
atalho.type = 'button';
atalho.textContent = 'Registrar atividade';
atalho.addEventListener('click', () => {
window.dispatchEvent(new CustomEvent('stacklab:registrar-atividade'));
});
document.querySelector('[data-atalhos]')?.append(atalho);
O trecho acima é só uma referência de formato. O importante é o contrato: o script consome a interface existente, não substitui o Chatwoot.
Onde os Módulos fazem diferença
Os Módulos StackLab reúnem scripts prontos para o Kanban para Chatwoot. Eles atuam em três frentes:
- fluxo — estilo, layout e comportamento adaptados à rotina;
- ações rápidas — botões, atalhos e comandos que reduzem cliques;
- integrações — CRM, VoIP e analytics dentro da experiência atual, sem abrir uma tela nova.
O ganho não está em ter “mais um recurso”. Está em reduzir o atrito entre a conversa e a próxima ação.
O que eles não fazem
É importante ser direto sobre os limites:
- os Módulos funcionam com o Kanban para Chatwoot ativo;
- a instalação é feita via SuperAdmin, no painel de scripts da instalação;
- não alteram o núcleo do Chatwoot;
- não substituem decisões de processo, permissão ou atendimento;
- não transformam uma operação desorganizada em organizada por conta própria.
Script é ferramenta. Processo continua sendo escolha da equipe.
Checklist antes de instalar
- Confirme a versão do Chatwoot e do Kanban em uso.
- Teste em um ambiente separado, se possível.
- Registre o que o script altera e quem pode removê-lo.
- Combine com a equipe o que muda na rotina.
- Tenha um caminho de rollback.
Se a personalização quebra a cada atualização, ela não é personalização — é dívida.
Personalizar bem é escolher o ponto certo de extensão. O objetivo não é ter um Chatwoot diferente. É ter um Chatwoot que acompanha o jeito da sua equipe sem deixar de evoluir.
