Instalação: Wuzapi (Meow) — Central de Ajuda Connect.ai

Atenção

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 Connect.ai 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 Connect.ai 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 Connect.ai.

Dica

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

Preparação do Ambiente: Atualizar o servidor e instalar as dependências (Git, PM2, Go).

Instalação do Wuzapi: Clonar o repositório e compilar a aplicação.

Configuração: Ajustar o arquivo de variáveis de ambiente (.env).

Execução e Gerenciamento: Iniciar a API e configurá-la como um serviço persistente com PM2.

Integração com Connect.ai: 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.

Atualizar o Servidor e Instalar o Git:

codeBash

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

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
```

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.

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

codeBash
```
git clone https://github.com/pedroherpeto/wuzapi.git
```
Acessar o Diretório:

codeBash
```
cd wuzapi
```
Baixar Dependências:

codeBash
```
go mod tidy
```
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.

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

Tudo certo

Dica de Configuração: É uma prática comum utilizar as mesmas credenciais do banco de dados da sua instalação Connect.ai. 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.

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.

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

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

codeBash
```
pm2 logs wuzapi
```

5. Integração com Connect.ai

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

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

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

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.