Como Instalar o Helpy Customer Helpdesk no Ubuntu 22.04

Helpy é uma plataforma de suporte ao cliente gratuita e de código aberto escrita na linguagem Ruby on Rails. É totalmente de código aberto e personalizável, então você pode alterá-la sob a licença MIT. É usada para construir um sistema de tickets automatizado e pode ser integrada com aplicações de terceiros. Oferece um rico conjunto de recursos, alguns deles estão listados abaixo:

• Suporta ticketing multicanal.
• Tem um grande suporte da comunidade. Integrado com e-mail de entrada via Sendgrid, Mandrill, Mailgun, etc.
• É totalmente multilíngue e pode fornecer suporte em vários idiomas.
• Personalizável e em conformidade com o GDPR.
• Amigável para dispositivos móveis e funciona em todos os dispositivos imediatamente.

Este post mostrará como instalar o Sistema de Suporte ao Cliente Helpy Helpdesk no Ubuntu 22.04.

Requisitos

• Um servidor rodando Ubuntu 22.04.
• Uma senha de root configurada em seu servidor.

Atualizar o Sistema

Primeiro, você precisará atualizar e fazer upgrade de todos os pacotes do sistema para a versão mais recente. Você pode atualizar todos eles executando o seguinte comando.

apt update -y  
apt upgrade -y

Uma vez que todos os pacotes estejam atualizados, você também precisará instalar algumas dependências adicionais em seu servidor. Você pode instalar todas elas executando o seguinte comando.

apt install apt-transport-https ca-certificates curl software-properties-common git -y

Uma vez que todos os pacotes estejam instalados, você pode prosseguir para o próximo passo.

Instalar Docker e Docker Compose

Neste post, instalaremos o Helpy usando Docker e Docker Compose. Portanto, ambos os pacotes devem ser instalados em seu servidor.

Primeiro, adicione a chave GPG do Docker e o repositório usando o seguinte comando.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -  
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Em seguida, atualize o cache do repositório com o seguinte comando.

apt update -y

Em seguida, você pode instalar tanto o Docker quanto o Docker Compose usando o seguinte comando.

apt install docker-ce docker-compose -y

Uma vez que ambos os pacotes estejam instalados com sucesso, inicie e habilite o serviço Docker com o seguinte comando.

systemctl start docker  
systemctl enable docker

Agora, verifique a versão do Docker usando o seguinte comando.

docker -v

Você receberá a seguinte saída.

Docker version 20.10.22, build 3a2c30b

Você também pode ver a versão do Docker Compose com o seguinte comando.

docker-compose version

Você deve ver a seguinte saída.

docker-compose version 1.29.2, build unknown
docker-py version: 5.0.3
CPython version: 3.10.4
OpenSSL version: OpenSSL 3.0.2 15 Mar 2022

Instalar Helpy no Ubuntu 22.04

Primeiro, baixe a versão mais recente do Helpy do repositório do GitHub usando o seguinte comando.

git clone https://github.com/helpyio/helpy.git

Uma vez que o download esteja completo, navegue até o diretório helpy com o seguinte comando.

cd helpy

Em seguida, renomeie o arquivo de ambiente do Helpy usando o seguinte comando.

cp docker/.env.sample docker/.env

Em seguida, construa a imagem Docker para o Helpy usando o seguinte comando.

docker-compose build

Você deve ver a seguinte saída.

Building helpy
Sending build context to Docker daemon  134.4MB
Step 1/20 : FROM ruby:2.5
2.5: Pulling from library/ruby
0bc3020d05f1: Pull complete 
a110e5871660: Pull complete 
83d3c0fa203a: Pull complete 
a8fd09c11b02: Pull complete 
14feb89c4a52: Pull complete 
958d2475f181: Pull complete 
ba6c4f28fec1: Pull complete 
757d13b54b5e: Pull complete 
Digest: sha256:ecc3e4f5da13d881a415c9692bb52d2b85b090f38f4ad99ae94f932b3598444b
Status: Downloaded newer image for ruby:2.5
 ---> 27d049ce98db
Step 2/20 : ENV RAILS_ENV=production     HELPY_HOME=/helpy     HELPY_USER=helpyuser     HELPY_SLACK_INTEGRATION_ENABLED=true     BUNDLE_PATH=/opt/helpy-bundle

Você pode verificar todas as imagens Docker com o seguinte comando.

docker images

Você deve obter a seguinte saída.

REPOSITORY    TAG       IMAGE ID       CREATED          SIZE
helpy_helpy   latest    9d59c3019f8f   32 seconds ago   1.91GB
ruby          2.5       27d049ce98db   18 months ago    843MB

Em seguida, inicie o container do Helpy e do Nginx com o seguinte comando.

docker-compose up -d

Você deve ver a seguinte saída.

Creating network "helpy_front" with driver "bridge"
Creating network "helpy_back" with driver "bridge"
Creating volume "helpy_rails-assets" with local driver
Pulling frontend (nginx:1.15)...
1.15: Pulling from library/nginx
743f2d6c1f65: Pull complete
6bfc4ec4420a: Pull complete
688a776db95f: Pull complete
Digest: sha256:23b4dcdf0d34d4a129755fc6f52e1c6e23bb34ea011b315d87e193033bcd1b68
Status: Downloaded newer image for nginx:1.15
Pulling postgres (postgres:9.4)...
9.4: Pulling from library/postgres
619014d83c02: Pull complete
7ec0fe6664f6: Pull complete
9ca7ba8f7764: Pull complete
9e1155d037e2: Pull complete
febcfb7f8870: Pull complete
8c78c79412b5: Pull complete
5a35744405c5: Pull complete
27717922e067: Pull complete
36f0c5255550: Pull complete
dbf0a396f422: Pull complete
ec4c06ea33e5: Pull complete
e8dd33eba6d1: Pull complete
51c81b3b2c20: Pull complete
2a03dd76f5d7: Pull complete
Digest: sha256:42a7a6a647a602efa9592edd1f56359800d079b93fa52c5d92244c58ac4a2ab9
Status: Downloaded newer image for postgres:9.4
Creating nginx            ... done
Creating helpy_postgres_1 ... done
Creating helpy_helpy_1    ... done

Em seguida, verifique o status de todos os containers em execução com o seguinte comando.

docker-compose ps

Você deve ver todos os containers em execução na seguinte saída.

      Name                    Command               State                                   Ports                                 
----------------------------------------------------------------------------------------------------------------------------------
helpy_helpy_1      /bin/bash /helpy/docker/run.sh   Up      0.0.0.0:3000->3000/tcp,:::3000->3000/tcp                              
helpy_postgres_1   docker-entrypoint.sh postgres    Up      5432/tcp                                                               
nginx              nginx -g daemon off;             Up      0.0.0.0:443->443/tcp,:::443->443/tcp, 0.0.0.0:80->80/tcp,:::80->80/tcp

Aguarde um tempo para iniciar todos os containers.

Neste ponto, o Helpy está instalado e em execução em seu sistema. Você pode agora prosseguir para o próximo passo.

Acessar a Interface Web do Helpy

Agora, abra seu navegador e acesse a interface web do Helpy usando a URL http://your-server-ip. Você deve ver a página de boas-vindas do Helpy.

Clique em Vamos configurar seu Helpy. Você deve ver a página de configuração de uma conta de administrador.

Defina seu e-mail, nome completo, empresa e senha e clique no botão Salvar Alterações. Você deve ver a página de personalização do Helpy.

Clique no botão Pular por enquanto. Você deve ver a página de configuração do SMTP.

Clique no botão Pular por enquanto. Você deve ver a seguinte página.

Agora, clique no botão Começar! Você deve ver o painel do Helpy na seguinte página.

Clique no botão Usuários. Você deve ver a seguinte página.

Clique no botão Criar Novo Usuário. Você deve ver a seguinte página.

Forneça as informações do seu usuário e clique no botão Salvar Alterações para criar um novo usuário.

Você também pode clicar no botão Relatórios para ver seus relatórios de tickets na seguinte página.

Conclusão

Parabéns! você instalou com sucesso o Helpy Customer Helpdesk no Ubuntu 22.04. Você pode agora usar o Helpy em sua organização para responder às perguntas dos clientes a partir de um local central. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.