Instalação: Wuzapi (Meow)

Aviso Importante: Responsabilidade sobre a Instalação e Suporte

A Wuzapi (Meow) é uma solução de software de código aberto.

Isso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.

A equipe de suporte do Konvoo não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Konvoo não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.

Este guia fornece o passo a passo técnico para realizar uma instalação auto-hospedada (self-hosted) da Wuzapi (Meow), uma API de conexão não oficial para WhatsApp.

Ao final deste processo, você terá uma instância da Wuzapi funcional em seu próprio servidor, pronta para ser integrada à sua plataforma Konvoo.

Visão Geral do Processo de Instalação:

1. Preparação do Ambiente: Atualizar o servidor e instalar as dependências (Git, PM2, Go).
2. Instalação do Wuzapi: Clonar o repositório e compilar a aplicação.
3. Configuração: Ajustar o arquivo de variáveis de ambiente (.env).
4. Execução e Gerenciamento: Iniciar a API e configurá-la como um serviço persistente com PM2.
5. Integração com Konvoo: Conectar a nova instância ao seu painel.

1. Preparação do Ambiente do Servidor

Estes comandos preparam seu servidor Ubuntu com todas as ferramentas necessárias para a instalação.

1. Atualizar o Servidor e Instalar o Git:

   codeBash

   sudo apt update && sudo apt upgrade -y && sudo apt install git -y
   sudo apt install npm
   

2. Instalar o PM2:
   O PM2 é um gerenciador de processos que manterá a API da Wuzapi rodando como um serviço.

   codeBash

   npm install -g pm2
   

3. Instalar a Linguagem Go (GoLang):
   A Wuzapi é construída em Go, portanto a linguagem precisa ser instalada no servidor.

   codeBash

   # Baixa o pacote de instalação
   wget https://go.dev/dl/go1.21.1.linux-amd64.tar.gz
   
   # Remove instalações antigas (se houver)
   sudo rm -rf /usr/local/go
   
   # Extrai os arquivos para o local correto
   sudo tar -C /usr/local -xzf go1.21.1.linux-amd64.tar.gz
   
   # Adiciona o Go ao PATH do sistema
   echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
   source ~/.bashrc
   
   # Verifica a instalação
   go version
   

   O terminal deve retornar a versão do Go instalada (ex: go version go1.21.1 linux/amd64).

---

2. Instalação da Aplicação Wuzapi

Agora, vamos baixar o código-fonte da Wuzapi e compilá-lo.

1. Clonar o Repositório:
   Este comando baixa a versão da Wuzapi compatível com o Konvoo.

   codeBash

   git clone https://github.com/pedroherpeto/wuzapi.git
   

2. Acessar o Diretório:

   codeBash

   cd wuzapi
   

3. Baixar Dependências:

   codeBash

   go mod tidy
   

4. Compilar a Aplicação:
   Este comando cria o arquivo executável chamado wuzapi.

   codeBash

   go build -o wuzapi
   

---

3. Configuração do Arquivo .env

Antes de iniciar a API, é fundamental configurar as variáveis de ambiente, principalmente as de acesso ao banco de dados.

1. Acesse e edite o arquivo .env.example para criar seu arquivo de configuração. É comum renomeá-lo para .env.
2. Preencha as variáveis do banco de dados (DB_HOST, DB_USER, DB_PASSWORD, DB_NAME, DB_PORT).

Dica de Configuração: É uma prática comum utilizar as mesmas credenciais do banco de dados da sua instalação Konvoo. Ao fazer isso, a Wuzapi criará suas próprias tabelas no mesmo banco de dados, simplificando o gerenciamento.

---

4. Execução e Gerenciamento com PM2

Com a aplicação compilada e configurada, vamos iniciá-la.

1. Execução para Teste (Opcional):
   Você pode iniciar a API manualmente para um teste rápido. O comando abaixo a iniciará na porta 5555.

   codeBash

   ./wuzapi -port 5555
   

   Para confirmar que está funcionando, acesse http://SEU\\_IP\\_DE\\_SERVIDOR:5555 no navegador.

2. Iniciando como um Serviço com PM2:
   Este comando iniciará a Wuzapi e garantirá que ela reinicie automaticamente em caso de falhas ou após o boot do servidor.

   codeBash

   # Inicia o serviço
   pm2 start ./wuzapi --name "wuzapi" -- -port 5555
   
   # Salva a lista de processos do PM2
   pm2 save
   
   # Configura o PM2 para iniciar com o sistema
   pm2 startup
   

3. Verificando os Logs:
   Para acompanhar os logs da aplicação em tempo real, use o comando:

   codeBash

   pm2 logs wuzapi
   

---

5. Integração com Konvoo

O último passo é conectar sua nova instância da Wuzapi ao painel do Konvoo.

1. No painel Admin, navegue até Configurações > Integrações > Wuzapi.
2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\_IP\\_DE\\_SERVIDOR:5555).
3. Preencha a Chave Global com o APP_ADMIN_TOKEN definido no seu arquivo .env.

1. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Wuzapi".

1. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.

---

Tutorial em Vídeo

Para uma demonstração visual detalhada de todos os passos descritos nesta documentação, assista à gravação completa.