COMPRAR

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 Z-PRO 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 Z-PRO 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 Z-PRO.

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 Z-PRO: 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

  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 Z-PRO.

    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 Z-PRO. 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 Z-PRO

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

  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.

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

  5. 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.

AnteriorIntegrando APIs Externas (Evolution, Wuzapi, Z-API, Uazapi)PróximoInstalação: Evoluiton API

Atualizado