Antes de tudo certifique-se de estar usando o S3 para armazenar os seus arquivos. Não é obrigatório ter o S3 para usar o Kanban mas adiciona uma camada a mais de resiliência aos dados. Dito isso, vamos lá: 1. Em primeiro lugar, pause a stack do seu Chatwoot atual. 2. Após pausar a stack, navegue até a página “Volumesˮ do Portainer (se estiver usando EasyPanel não é necessário excluir os volumes) e exclua todos os volumes (exceto chatwoot_data ou chatwoot_storage, dependendo da instalação) - dicas no final do tutorial. Uma vez a stack pausada e os volumes removidos, agora é a hora de fazer as alterações que vão colocar o Kanban para funcionar. Não excluir o volume chatwoot_storage (ou chatwoot_data) se não estiver usando o S3. Isso causa perda de arquivos das conversas. 3. No trecho “enviromentˮ da stack do seu Chatwoot, adicione uma nova variável chamada “STACKLAB_TOKENˮ e insira o token que você recebeu via Whatsapp e E-mail na hora da compra do Kanban. 4. Após adicionar o token, altere as imagens dos dois serviços, app e Sidekiq, para usar a imagem do kanban: stacklabdigital/kanban:latest 5. Clique em “Prune Servicesˮ e logo após em “Redeployˮ. Espere o serviço chatwoot_app estar com o status “runningˮ e quando estiver, siga os próximos passos para migrar o banco de dados para a nova versão. 6. No Portainer, na linha onde aparece o serviço chatwoot_app, clique em “Consoleˮ. 7. Na tela de conexão ao console selecione “shˮ e mantenha o usuário como “rootˮ mesmo. 8. Rode o comando para migrar o banco de dados e aplicar as alterações necessárias para o funcionamento do Kanban para Chatwoot: bundle exec rails db:migrate - veja alguns comandos para gerenciar o banco de dados no fim do post. Pronto, seu Kanban para Chatwoot está instalado! O processo de atualização é exatamente o mesmo. Dicas Bônus Porque é importante usar o S3 no Chatwoot? Quando armazenamos os nossos arquivos direto no armazenamento local do Chatwoot ficamos refém do servidor em que as imagens e arquivos estão hospedados ficar indisponível, sofrer gargalos que afetam a integridade dos demais serviços, corromper informações e uma série de outros fatores. O armazenamento S3 é um protocolo especializado para guardar arquivos com segurança e performance além de permitir que seu Chatwoot tenha um serviço robusto que servirá as imagens para sua aplicação. Saiba mais sobre o protocolo S3: https://aws.amazon.com/pt/s3/getting-started/ Alguns dos bugs mais comuns de ocorrer no processo de instalação e atualização: - “Mudei a imagem dos dois serviços mas não aparece a opção de Kanban no Chatwoot.ˮ Isso geralmente ocorre quando antes de fazer o redeploy, os volumes não são apagados. Limpe os volumes e faça o redeploy pra que as modificações sejam aplicadas. - “Atualizei o Kanban para Chatwoot e apareceu “rejectedˮ no containerˮ Esse erro é causado 90% das vezes pelo nome errado da imagem. Certifique-se se estar usando a versão mais atualizada com o nome correto da imagem: stacklabdigital/kanban:latest Docker Hub com tags atualizadas: https://hub.docker.com/r/stacklabdigital/kanban/tags Comandos uteis para gerenciar o banco de dados do Chatwoot - bundle exec rails db:migrate Aplica as migrations pendentes no seu banco de dados atual após uma atualização. - bundle exec rails db:rollback Desfaz a última migration (1 step). Útil em caso de erros. - bundle exec rails db:rollback STEP=3 Desfaz as últimas 3 migrations. - bundle exec rails db:migrate:status Mostra o status das migrations (aplicadas ou não). - bundle exec rails db:seed Executa o arquivo db/seeds.rb. - bundle exec rails db:reset Dropa, cria, migra e roda seeds no banco (cuidado: apaga os dados!).

📚 Onboarding

O que são os Modulos StackLab?

Modulos StackLab são scripts prontos para uso que adicionam funcionalidades extras e visuais personalizados ao Kanban para Chatwoot, por meio da injeção de código HTML diretamente no frontend. “Estes scripts funcionam exclusivamente com o Kanban para Chatwoot e utilizam a estrutura oficial de módulos do StackLab.ˮ Como Funcionam: Todos os scripts utilizam a tecnologia de injeção dinâmica de código HTML antes do fechamento da tag body, o que permite modificar ou estender a interface do Chatwoot de forma segura e desacoplada. Isso abre um universo de possibilidades! - Inserção de componentes visuais flutuantes. - Adição de eventos automáticos ou personalizados. - Integrações com ferramentas externas (APIs, CRMs, VoIP, Analytics…). - Automação visual de tarefas no Kanban Personalização de estilos, layout e comportamentos. Requisitos: - Kanban para Chatwoot instalado e ativo. - Acesso de SuperAdmin à sua instalação do Chatwoot. - Painel de Gerenciamento de Scripts disponível no seu ambiente em: /super_admin/dashboard_scripts. Passos para usar: 1. Acesse sua instalação do Chatwoot com uma conta SuperAdmin. 2. Vá até: https://seuchatwoot.com/super_admin/dashboard_scripts 3. Cole o código do script no campo "Script Code". 4. Clique em "Salvar Scripts". 5. Atualize seu painel do Kanban — o script já estará funcionando! Boas Práticas: - Evite duplicações e verifique se o elemento já foi adicionado ao DOM. - Utilize ‘MutationObserverʼ para manter seu script funcional mesmo com atualizações dinâmicas da interface. - Encapsule sua lógica para não poluir o namespace global. - Comente seu código para facilitar futuras manutenções ou colaborações. Exemplos de Funcionalidades Possíveis: - Botões flutuantes com ações rápidas (ex: chamada, criar tarefa, arquivar lead). - Atalhos de teclado personalizados para navegação rápida no Kanban. - Integração com APIs de CRM, VoIP ou automação. - Scripts que exibem alertas ou instruções contextuais para operadores. - Personalizações visuais (temas escuros, bordas por status, agrupamentos). - Automatizações visuais com base em datas, metas ou responsáveis. Contribuições: Se você tem sugestões de melhoria, novas ideias de scripts ou quer compartilhar suas criações, participe da Comunidade oficial no WhatsApp do Kanban para Chatwoot. https://chat.whatsapp.com/FDagtAiDpQt10hKGiMtiF0 Suporte: Compradores do Kanban para Chatwoot têm acesso direto à comunidade de suporte via WhatsApp. Dúvidas técnicas ou de implementação serão atendidas por especialistas da StackLab. Grupo dos Módulos no Whatsapp: https://chat.whatsapp.com/IJAeviGg74SKP8blG0k6ds

🚀 Dicas & Tutoriais

Como Instalar e Atualizar o Kanban para Chatwoot pelo EasyPanel

Vamos te ensinar a instalar o Kanban para Chatwoot usando o EasyPanel nesse tutorial. Siga o passo a passo com atenção para que funcione corretamente. Dito isso, vamos lá: 1. Navegue até o projeto do seu Chatwoot no EasyPanel e clique na aba "Source" no menu lateral esquerdo. 2. Após isso, no campo "Image" da aba "Docker Image", mude para a imagem do Kanban: stacklabdigital/kanban:latest 3. Agora vamos inserir seu Token da StackLab no ambiente do seu Chatwoot. Pra isso, no menu lateral esquerdo, clique na aba "Enviroment" 4. Crie uma nova variável de ambiente chamada STACKLAB_TOKEN e cole o token que você recebeu no momento da compra. 5. Repita esse processo tanto pros serviços chatwoot e chatwoot-sidekiq, colocando a imagem e o token do Kanban em ambos os serviços. 6. Após isso clique em "Deploy" para aplicar a alteração 7. Agora clique no botão de console e rode o comando abaixo para executar a migração do banco de dados e criar as tabelas do Kanban. Veja o icone abaixo: 8. Selecione a opção "sh" e rode o comando: bundle exec rails db:migrate Pronto, seu Kanban para Chatwoot está instalado! O processo de atualização é exatamente o mesmo. Dicas Bônus Porque é importante usar o S3 no Chatwoot? Quando armazenamos os nossos arquivos direto no armazenamento local do Chatwoot ficamos refém do servidor em que as imagens e arquivos estão hospedados ficar indisponível, sofrer gargalos que afetam a integridade dos demais serviços, corromper informações e uma série de outros fatores. O armazenamento S3 é um protocolo especializado para guardar arquivos com segurança e performance além de permitir que seu Chatwoot tenha um serviço robusto que servirá as imagens para sua aplicação. Saiba mais sobre o protocolo S3: https://aws.amazon.com/pt/s3/getting-started/ Alguns dos bugs mais comuns de ocorrer no processo de instalação e atualização: - “Mudei a imagem dos dois serviços mas não aparece a opção de Kanban no Chatwoot.ˮ Isso geralmente ocorre quando antes de fazer o redeploy, os volumes não são apagados. Limpe os volumes e faça o redeploy pra que as modificações sejam aplicadas. - “Atualizei o Kanban para Chatwoot e apareceu “rejectedˮ no containerˮ Esse erro é causado 90% das vezes pelo nome errado da imagem. Certifique-se se estar usando a versão mais atualizada com o nome correto da imagem: stacklabdigital/kanban:latest Docker Hub com tags atualizadas: https://hub.docker.com/r/stacklabdigital/kanban/tags Comandos uteis para gerenciar o banco de dados do Chatwoot - bundle exec rails db:migrate Aplica as migrations pendentes no seu banco de dados atual após uma atualização. - bundle exec rails db:rollback Desfaz a última migration (1 step). Útil em caso de erros. - bundle exec rails db:rollback STEP=3 Desfaz as últimas 3 migrations. - bundle exec rails db:migrate:status Mostra o status das migrations (aplicadas ou não). - bundle exec rails db:seed Executa o arquivo db/seeds.rb. - bundle exec rails db:reset Dropa, cria, migra e roda seeds no banco (cuidado: apaga os dados!).

🤝 Novos Clientes

Diferença entre Planos e Limites

O Kanban para Chatwoot é uma extensão validada por mais de 400 empresas que buscam organização, automação e eficiência na comunicação com seus clientes. Se você é uma agência, freelancer ou quer iniciar uma operação de revenda, este artigo vai te mostrar como os planos funcionam, quais são os limites, e como lucrar como revendedor ou afiliado. O que é o Kanban para Chatwoot? Uma extensão poderosa que transforma seu Chatwoot em uma verdadeira central de produtividade. Com ela, você tem: - Funis personalizados com múltiplas etapas - Mensagens automáticas - Agendamento de mensagens - Kanban AI (criação inteligente de tarefas com IA) - Histórico completo de cada item - Visualização por prioridade - Integração com API (Postman com 15 endpoints) Planos e Limites Veja abaixo a comparação entre os planos disponíveis: Obs: Cada instalação refere-se a uma instância independente do Kanban/Chatwoot, ideal para revenda ou gestão de múltiplos projetos/clientes. Benefícios de ser um Revendedor ou Afiliado ✔️ Como Revendedor: - Tenha até 50 instalações SaaS para seus clientes - Entregue uma solução validada para empresas que já usam Chatwoot - Ganhe recorrência com planos mensais - Gerencie tudo pelo Painel de Licenças (exclusivo no plano Scale) ✔️ Como Afiliado: - Receba 35% de comissão por cada venda realizada - Custo zero para começar - Materiais prontos de marketing - Suporte especializado para afiliados 👉 Cadastre-se como afiliado agora mesmo Instalação Simples (em 3 minutos) Você pode testar agora na sua própria VPS com este comando: curl -fsSL https://cli.stacklab.digital | bash Ou solicite uma demonstração gratuita com nossa equipe. Canais de suporte e comunidade - 📱 WhatsApp – Entre no grupo para suporte e novidades - 📺 YouTube – Veja a demonstração - 📘 API documentada – Acesse no Postman Números que comprovam - +400 Aplicações com o Kanban - +6.100 Usuários Ativos - +37.000 Itens Criados Dúvidas comuns 1. O que são as "instalações" nos planos? Cada instalação representa uma instância separada com o Kanban ativo. Ideal para múltiplos clientes ou projetos. 2. Posso migrar de outro Chatwoot? Sim! A instalação é compatível com versões padrão do Chatwoot. 3. O plano Go limita meu número de agentes? Não. Você pode ter quantos agentes quiser, mas está limitado a 1 instalação e 2 funis. Transforme sua operação hoje Comece agora com uma instalação simplificada, suporte completo e potencial de lucro recorrente. 👉 Ver planos | Solicitar demonstração

🚀 Dicas & Tutoriais

Como usar o SMTP do Google para enviar e-mails

O Simple Mail Transfer Protocol (SMTP) do Google permite que você envie e-mails de forma programática usando uma conta do Gmail. Este tutorial vai guiá-lo através dos passos necessários para configurar e usar o SMTP do Google para enviar e-mails. Antes de começar, você vai precisar de uma conta Gmail ou Google Workspace. Passo 1: Configurar a Conta do Gmail 1. Ativar o Acesso a Aplicativos Menos Seguros (Opcional): O Google tem medidas de segurança que podem bloquear aplicativos menos seguros. Para permitir que seu aplicativo envie e-mails, você pode precisar ativar o acesso a aplicativos menos seguros na sua conta do Gmail. - Acesse Minha Conta. - Role para baixo até a seção "Acesso a aplicativos menos seguros". - Clique em "Ativar acesso" e habilite a opção "Permitir aplicativos menos seguros". 2. Gerar uma Senha de Aplicativo (Recomendado): Por questões de segurança, é recomendado gerar uma senha específica para o aplicativo em vez de usar sua senha principal do Gmail. - Acesse Minha Conta. - Em "Segurança", encontre "Senhas de aplicativos". - Selecione "Outros (nome personalizado)" e insira um nome para a aplicação (por exemplo, "Envio de Email SMTP"). - Clique em "Gerar" e anote a senha fornecida. Passo 2: Configurar as Credenciais SMTP Para configurar o envio de e-mails via SMTP do Google, você precisará das seguintes informações: - Servidor SMTP: smtp.gmail.com - Porta SMTP: 587 (TLS) ou 465 (SSL) - Usuário: Seu endereço de e-mail completo do Gmail (ex: seuemail@gmail.com) - Senha: Sua senha do Gmail ou a senha do aplicativo gerada anteriormente. Passo 3: Limites de Envio do SMTP Google Grátis O Google limita a saída de 100 e-mails por dia. Se atingir o limite, você não será capaz de enviar e-mails pelas próximas 24 horas até que o limite seja resetado. Mais informações sobre os limites de envio de e-mails do Google podem ser encontradas aqui. Passo 4: Testar a Configuração SMTP Para verificar se a configuração SMTP do Google está funcionando corretamente, siga estes passos: Testar com Clientes de E-mail: 1. Uma maneira de testar a configuração SMTP é configurando-a em um cliente de e-mail, como Microsoft Outlook, Mozilla Thunderbird ou Apple Mail. - Abra o cliente de e-mail. - Acesse as configurações de conta e adicione uma nova conta de e-mail. - Insira as informações do servidor SMTP, porta, e credenciais. - Envie um e-mail de teste para verificar se a configuração está funcionando. Verificar o Log de Envio: 1. Depois de enviar um e-mail de teste, verifique a caixa de entrada do destinatário para confirmar que o e-mail foi recebido. Também, confira os logs de envio no cliente de e-mail ou ferramenta de teste utilizada para garantir que não houve erros durante o processo. Solucionar Problemas Comuns 1. Erro de Autenticação: - Verifique se o usuário e a senha estão corretos. - Certifique-se de que a opção "Permitir aplicativos menos seguros" está ativada ou que você está usando a senha do aplicativo. 2. Erro de Conexão: - Verifique se o servidor SMTP e a porta estão corretos. - Assegure-se de que sua conexão com a internet está estável. 3. Mensagens de Segurança do Google: - Se o Google bloquear sua tentativa de login, você poderá receber um e-mail ou notificação sobre uma tentativa de login suspeita. Confirme que foi você quem tentou fazer login. Considerações Finais Usar o SMTP do Google é uma maneira simples e eficaz de enviar e-mails programaticamente. No entanto, para aplicações de produção, considere usar uma solução de e-mail transacional como SendGrid, Mailgun ou Amazon SES, que oferecem mais recursos e melhor gerenciamento de envios em larga escala. Crêditos: https://chatwoot.app.br/

📚 Onboarding

Enterprise Edition

A partir da versão 2.0, o Chatwoot oferece duas versões de seu software: a Community Edition, licenciada pelo MIT, e a Enterprise Edition, disponível sob uma licença proprietária. Ambas as versões são desenvolvidas a partir de um único repositório no GitHub. Enquanto a edição comunitária sempre será gratuita e de código aberto, a versão Enterprise é uma forma de sustentar tanto a oferta do Chatwoot quanto o negócio comercial da empresa. Esse modelo é semelhante ao de outras empresas de código aberto comercial, como Gitlab, Mattermost e Metabase. Diferenças entre as edições Community e Enterprise A edição Community do Chatwoot inclui todas as funcionalidades relevantes de comunicação com o cliente, ideais para negócios em crescimento. Já a versão Enterprise oferece recursos proprietários, como dashboards personalizáveis, gerenciamento de SLAs, software de agendamento de agentes, bloqueio de IP, entre outros, voltados para grandes organizações. Embora o código-fonte de ambas as edições esteja disponível ao público no nosso repositório no GitHub, todo o conteúdo da pasta /enterprise é protegido por direitos autorais. Escolhendo a edição correta Recomendamos instalar a Enterprise Edition do Chatwoot para facilitar a atualização para um plano pago no futuro, sem necessidade de reinstalação. Enterprise Edition A edição Enterprise oferece os seguintes benefícios: - Todas as funcionalidades do Chatwoot - Código-fonte completo, visível e auditável - Todos os recursos da edição Community sem necessidade de assinatura - Opções de suporte direto - Facilidade para atualização para funcionalidades pagas Community Edition A edição Community inclui: - Código-fonte completo, visível e modificável - Sem acesso às funcionalidades pagas - Suporte exclusivamente pela comunidade Caso você queira adicionar funcionalidades pagas no futuro, será necessário migrar para a Enterprise Edition.