> For the complete documentation index, see [llms.txt](https://doc.whazing.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.whazing.com.br/canais-disponiveis/whatsapp-api-nao-oficial/whatsapp-wuzapi.md).

# WhatsApp Wuzapi (WhatsMeow)

## WhatsApp Wuzapi (WhatsMeow)

A **WuzAPI (WhatsMeow)** é uma forma de conectar seu WhatsApp ao sistema **sem custo por canal**. É a opção **recomendada** para quem está começando, no lugar da **Baileys**, pois é **mais leve**, **estável** e **garante melhor desempenho do sistema**.

> ⚠️ **Atenção:** o Whazing recomenda usar contas do **WhatsApp Business** para a integração. O WhatsApp normal pode apresentar desconexões e instabilidade.

### 🔁 Posso trocar de API sem perder dados?

Sim. É possível **migrar entre as 3 APIs não oficiais** — **Baileys**, **API Plus** e **WuzAPI** — **sem perder dados**. Veja o passo a passo em [Migração entre APIs Não Oficiais](/canais-disponiveis/whatsapp-api-nao-oficial/migracao-entre-apis-nao-oficiais.md).

> 🆘 **Sessão não conecta ou o QR Code não aparece?** Veja o guia [WuzAPI não conecta ou não lê o QR Code](/canais-disponiveis/whatsapp-api-nao-oficial/whatsapp-wuzapi/wuzapi-nao-conecta-ou-nao-ler-qrcode.md).

***

#### 🧩 **Instalação ou atualização do servidor**

Para instalar ou atualizar, basta executar o comando abaixo:

```bash
curl -sSL wuzapi.whazing.com.br | sudo bash
```

Após a instalação, será exibida uma tela parecida com esta:

```
==============================
✅ Instalação concluída!
URL WuzAPI: http://127.0.0.1:8080
Admin Token: xeU2d47fSHxIM5pSdB4ua9C1y3E4k2
DB Password: vuzNRCFFxp2EqIr
Arquivo: /home/deploy/wuzapi.yaml
==============================
```

***

#### ⚙️ **Conexão no painel Whazing**

<figure><img src="https://858671661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL28BkT6aCze1NvvWNwS5%2Fuploads%2FTc2sALh8eeebaz6s8jUJ%2Fwuzapiconfig.png?alt=media&amp;token=dc99794b-57cb-4a30-b952-c58c1e07835f" alt=""><figcaption></figcaption></figure>

1. Acesse o painel **Whazing → Painel SaaS → Integrações → Wuzapi**
2. Preencha os campos com:
   * **URL:** a exibida na instalação (exemplo: `http://127.0.0.1:8080`)
   * **Admin Token:** o token gerado (exemplo: `xeU2d47fSHxIM5pSdB4ua9C1y3E4k2`)

💡 **Dica de desempenho:** desativar "Enviar arquivos em Base64 para o Wuzapi" torna o envio mais rápido, pois elimina a necessidade de converter arquivos antes de enviar. Isso funciona apenas com a versão da WuzAPI a partir da **1.0.9** — se sua versão for mais antiga (ou a versão original), deixe a opção **ativada**.

***

#### 🔁 **Reiniciar serviços**

**Reiniciar WuzAPI**

```bash
docker container restart wuzapi
```

**Reiniciar Banco**

```bash
docker container restart postgreswuzapi
```

**Reiniciar RabbitMQ**

```bash
docker container restart rabbitmqwuzapi
```

***

#### 📜 **Ver logs dos contêineres**

**Logs do WuzAPI**

```bash
docker logs --tail 100 -f wuzapi
```

**Logs do Banco**

```bash
docker logs --tail 100 -f postgreswuzapi
```

**Logs do RabbitMQ**

```bash
docker logs --tail 100 -f rabbitmqwuzapi
```

Segue versão melhorada para **GitBook**, mais organizada, com correção de digitação, melhor explicação e mantendo seu conteúdo técnico intacto:

***

## 🗑️ Desinstalar WUZAPI

Caso ocorra algum erro e você precise realizar uma **reinstalação limpa**, ou caso não utilize mais o WUZAPI, siga os passos abaixo para remover completamente a instalação.

> ⚠️ **Importante:** As mensagens já existentes no **Whazing** **não serão perdidas**, pois ficam armazenadas no banco principal do sistema.
>
> Se for instalar novamente, será necessário:
>
> * Ler novamente os **QR Codes**
> * Atualizar o **Token no painel SaaS**

***

### 📂 1️⃣ Acessar diretório de instalação

```bash
cd /home/deploy
```

***

### 🛑 2️⃣ Derrubar containers + remover volumes

Esse comando remove:

* Containers
* Volumes
* Containers órfãos

```bash
docker compose -f wuzapi.yaml down -v --remove-orphans
```

***

### 🔎 3️⃣ Garantir que não restou nenhum container

Verifique se ainda existe algum container ativo ou parado:

```bash
docker ps -a
```

Se ainda aparecer algum container do WUZAPI, remova manualmente:

```bash
docker rm -f wuzapi postgreswuzapi rabbitmqwuzapi
```

***

### 🌐 4️⃣ Limpar redes órfãs

```bash
docker network prune -f
```

***

### 🗂️ 5️⃣ Remover arquivo de configuração

```bash
rm wuzapi.yaml
```

***

### ✅ Finalização

Após esses passos, o WUZAPI estará completamente removido do servidor.

***

## 👣 Próximos passos depois de conectar

Depois que o WhatsApp estiver conectado, siga esta sequência para deixar o atendimento funcionando:

1. **Crie as filas** e defina qual fila receberá os atendimentos desse número — veja [Organização de Atendimentos, Filas e Permissões de Usuários](/funcionalidades/funcionalidades/gestao/organizacao-de-atendimentos-filas-e-permissoes-de-usuarios.md).
2. **Cadastre os usuários (atendentes)** e defina quais filas cada um pode acessar — veja [Usuários](/funcionalidades/funcionalidades/gestao/usuarios.md).
3. **Configure mensagens automáticas** (saudação, despedida e transferência) — veja [Mensagens Automáticas](/funcionalidades/funcionalidades/automacao/mensagens-automaticas.md).
4. **Crie um chatbot** para responder automaticamente — veja [Chatbot Interno](/funcionalidades/funcionalidades/automacao/chatbotinterno-1.md).
5. **Importe as mensagens antigas** do WhatsApp, se quiser manter o histórico — veja [Importar mensagens Baileys](/funcionalidades/funcionalidades/whatsapp/importar-mensagens-whatsapp.md).
6. **Nada funcionando?** Veja [Mensagem não enviando](/canais-disponiveis/whatsapp-api-nao-oficial/mensagem-nao-enviando.md), [WuzAPI não conecta ou não lê o QR Code](/canais-disponiveis/whatsapp-api-nao-oficial/whatsapp-wuzapi/wuzapi-nao-conecta-ou-nao-ler-qrcode.md) e [WhatsApp desconecta ou mensagens não chegam](/solucao-de-problemas/solucao-de-problemas/whatsapp-e-mensagens/whatsapp-desconecta-ou-mensagens-nao-chegam.md).
