Como instalar o Chatwoot no Saplo (chat ao vivo e helpdesk para equipas)

Se atendes clientes via chat e pagas mensalmente por agente no Intercom, Zendesk ou Tawk.to Pro, mais cedo ou mais tarde vais calcular quanto custa uma equipa de várias pessoas. O Chatwoot resolve isto de outra forma, porque é de código aberto e podes instalá-lo no teu próprio servidor. Pagas uma vez pelo teu Box, e simplesmente não há limite de agentes, conversas ou caixas. Abaixo, passo a passo, como instalar o Chatwoot no Saplo.

Para quem é o Chatwoot

Antes de instalar, verifica se esta ferramenta se adequa ao que fazes:

• queres responder aos clientes no chat do site, não apenas por e-mail - O Chatwoot cria um widget de chat que podes colar em qualquer página, e as conversas vão para uma caixa de entrada partilhada pela equipa.
• geres várias marcas ou sites a partir de um único painel - Uma instalação do Chatwoot suporta qualquer número de caixas de entrada (Inboxes): site, e-mail, Facebook ou Instagram, cada uma separadamente.
• estás farto de pagar por mais um agente no Intercom, Zendesk ou Tawk.to - O Chatwoot é open source, sem taxas baseadas no número de pessoas na equipa de suporte.
• preocupas-te com automações e estatísticas da equipa - Regras de atribuição automática de conversas, modelos de resposta e relatórios de tempo de resposta estão integrados, sem plano adicional.

Se procuras um widget simples e pronto a usar, sem infraestrutura própria, e não te importas de pagar por agente, o Tawk.to no plano gratuito pode ser suficiente. O Chatwoot na Saplo faz sentido quando a equipa cresce e o custo do SaaS começa a aumentar com ela.

Requisitos

Para instalares o Chatwoot no Saplo, precisas de:

• Uma Box no plano M ou superior, porque a receita configura quatro contentores Docker de uma só vez (aplicação, worker, base de dados, Redis) e requer um mínimo de 2 GB de RAM livre.
• Um mínimo de 10 GB de espaço em disco.
• Um domínio ou subdomínio *.saploapp.pl incluído no preço de cada plano, onde serão alojados o painel do agente e o widget de chat.
• Não precisas de configurar uma base de dados separada manualmente; a receita configura o seu próprio contentor PostgreSQL com a extensão pgvector, porque o Chatwoot utiliza-a para as funções de IA e o motor só tem uma base de dados partilhada para MySQL.
• O teu próprio servidor SMTP, se quiseres que os convites para agentes e as notificações sejam realmente enviados por e-mail, sobre o qual falaremos mais na secção de primeira configuração abaixo.

Instalação passo a passo

1. No Painel Saplo, acede ao Catálogo de aplicações e seleciona Chatwoot (categoria "Negócios").
2. Indica uma Box no plano M ou superior com um mínimo de 2 GB de RAM livre e o domínio ou subdomínio onde o painel do agente será instalado.
3. Confirma a instalação. O motor instala o Docker CE, se ainda não estiver na Box, descarrega a imagem oficial chatwoot/chatwoot (cerca de 1,5 GB) e as imagens da sua própria base de dados pgvector/pgvector e do Redis.
4. Antes de iniciar o painel, o motor executa um passo único de preparação da base de dados (rails db:chatwoot_prepare), que o Chatwoot requer antes do primeiro arranque, e só depois inicia os dois contentores de longa duração: o servidor web (painel do agente e widget de chat) e o worker Sidekiq em segundo plano (notificações, e-mails, automações).
5. A instalação demora mais tempo do que com receitas mais simples, porque inclui o descarregamento da imagem, a preparação da base de dados e o arranque de dois contentores na mesma imagem. O motor espera que ambos iniciem efetivamente, em vez de se limitar a apenas iniciá-los.
6. No domínio indicado, aparece o assistente para a criação da primeira conta.

Primeiro início de sessão e configuração

1. Acede ao domínio que indicaste durante a instalação.
2. Ao contrário da maioria das receitas Saplo, o Chatwoot não cria uma conta de administrador automaticamente. Por isso, terás de o fazer tu, no assistente "Create your profile": indicas o nome da empresa, endereço de e-mail e palavra-passe, e esta torna-se a primeira conta de administrador. Faz isto o mais rapidamente possível após a instalação, pois até esse momento, o painel está disponível para qualquer pessoa que aceda ao domínio.
3. Adiciona a primeira caixa em Definições -> Caixas -> Nova caixa -> Website, a partir daí copiarás o código do widget de chat para colar na página do cliente.
4. Por defeito, o Chatwoot apenas define o cabeçalho do remetente dos e-mails, não os envia realmente. Se quiseres que os convites para agentes e as notificações cheguem às caixas de entrada, configura o teu próprio servidor SMTP em Definições -> Conta -> SMTP Settings.
5. As instruções completas para o primeiro início de sessão e a visualização dos registos dos contentores podem ser encontradas no ficheiro CHATWOOT-SETUP.txt no catálogo de aplicações.

Chatwoot na Saplo vs. alternativas

Perguntas frequentes

A conta de administrador é criada automaticamente, como noutras receitas Saplo? Não. O Chatwoot não tem variáveis para criar uma conta automaticamente, por isso, tens de a criar tu próprio no assistente "Create your profile" quando acedes ao domínio pela primeira vez. Faz isso logo após a instalação, porque até esse momento o Painel está aberto para a primeira pessoa que lá aceder.

Que base de dados usa o Chatwoot? Usa o seu próprio contentor PostgreSQL com a extensão pgvector, e não uma base de dados MySQL Saplo partilhada. A receita cria-o automaticamente na instalação, não precisas de criar a tua própria base de dados.

Os convites para agentes e as notificações são enviados automaticamente por e-mail? Por predefinição, não, a instalação apenas configura o cabeçalho do remetente. Para que os e-mails cheguem realmente às caixas de correio, configura o teu próprio servidor SMTP em Configurações -> Conta -> SMTP Settings após o primeiro login.

Quantas caixas de entrada (Inboxes) posso ligar a uma única instalação? Sem limite, podes ligar um site, e-mail ou redes sociais como caixas de entrada separadas no mesmo Painel, cada uma com o seu próprio widget ou endereço.

Porque é que a instalação requer o plano Box M, e não um inferior? Porque a receita instala quatro contentores de uma só vez: a aplicação, o worker Sidekiq, a base de dados PostgreSQL e o Redis, o que requer um mínimo de 2 GB de RAM livre. No Box S, normalmente não há tanta memória livre.

É fácil perder uma conversa de chat quando o cliente volta ao fim de um mês. Podes gerir contactos, oportunidades de vendas e histórico de colaboração no EspoCRM na Saplo, sem taxas por utilizador.

Se quiseres deixar de pagar por mais um agente no Intercom ou Zendesk e ter conversas com clientes no teu próprio servidor, podes instalar o Chatwoot na Saplo em poucos minutos. Escreve-nos se precisares de ajuda com a configuração SMTP ou com a primeira caixa de entrada.