# Instalação: Wuzapi (Meow) {% hint style="warning" %} **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. {% endhint %} 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.
{% hint style="info" %} **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. {% endhint %} \ **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 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). {% hint style="success" %} **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. {% endhint %} *** #### **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 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: ). 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. {% embed url="" %}
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.