> For the complete documentation index, see [llms.txt](https://docs.flw.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flw.chat/guide/documentacao/faq/whatsapp-nao-oficial/restricoes-em-conexoes-nao-oficiais.md).

# Restrições em Conexões Não Oficiais

Conexões não oficiais (como **Z-API** e ferramentas similares) utilizam métodos que simulam o uso do WhatsApp Web para conectar números à plataforma. Por não serem autorizadas pela Meta, essas conexões estão sujeitas a **restrições, bloqueios temporários (soft bans)** e até **banimentos permanentes**.

{% hint style="danger" %}
**Importante:** Não nos responsabilizamos por bloqueios ou banimentos decorrentes do uso de conexões não oficiais. O uso da **API Oficial do WhatsApp** é sempre a opção recomendada.
{% endhint %}

## O que é um soft ban?

O soft ban é um bloqueio temporário aplicado pelo WhatsApp quando detecta comportamento considerado suspeito. Diferente do banimento permanente, o soft ban geralmente não exibe uma mensagem de erro clara, e o número simplesmente para de enviar ou receber mensagens corretamente.

Um dos indicadores mais comuns é o **erro z301** (em ferramentas como Z-API), que sinaliza que o número foi temporariamente restrito.

## Fatores que causam restrições

Os principais fatores que levam a restrições e soft bans em conexões não oficiais são:

* **Diferença de localização (IP):** O número está registrado em uma cidade, mas a conexão é feita a partir de um servidor em outra região ou país. Essa divergência é um dos principais sinais detectados pelo WhatsApp.
* **Tempo de resposta do chatbot:** Respostas instantâneas e padronizadas (abaixo de 1 segundo) são facilmente identificadas como automação.
* **Alto volume de mensagens:** Enviar muitas mensagens em um curto intervalo de tempo, especialmente para contatos que nunca interagiram com o número.
* **Bloqueios em massa:** Quando muitos destinatários bloqueiam ou denunciam o número em um curto período.
* **Múltiplos IPs ou dispositivos:** Conectar o mesmo número em várias instâncias ou alternar frequentemente entre servidores.
* **Instabilidades na conexão:** Quedas frequentes e reconexões repetidas geram padrões de uso anormais.
* **Falta de aquecimento do número:** Números novos que iniciam com alto volume de mensagens sem um período de uso gradual.

## Consequências possíveis

* **Soft ban temporário:** O número fica restrito por horas ou dias. Geralmente se resolve sozinho após um período de inatividade.
* **Banimento permanente:** Em casos de reincidência ou violação grave, o número pode ser banido permanentemente sem possibilidade de recurso.
* **Perda do número:** Em banimentos permanentes via conexão não oficial, a Meta não oferece suporte para recuperação, pois o uso da ferramenta já configura uma violação dos termos de serviço.

## O que fazer em caso de soft ban

### Passo 1: Desconectar o número

* Desconecte o número da ferramenta não oficial imediatamente. Não tente reconectar.

### Passo 2: Aguardar

* Espere pelo menos **24 a 48 horas** antes de qualquer tentativa de reconexão. Em alguns casos, pode ser necessário aguardar até **72 horas**.

### Passo 3: Reduzir o volume

* Ao reconectar, reduza significativamente o volume de mensagens e aumente gradualmente ao longo de dias.

## Recomendação

Para evitar esses riscos, a melhor alternativa é migrar para a **API Oficial do WhatsApp**, que oferece:

* Conexão autorizada e estável.
* Sem risco de soft ban ou banimento por uso de ferramenta não oficial.
* Suporte da Meta para resolução de problemas.
* Maior limite de envio de mensagens conforme a qualidade do número.

{% hint style="info" %}
**Considerações Adicionais:**

* Soft bans são cada vez mais frequentes, pois o WhatsApp aprimora constantemente seus mecanismos de detecção.
* Mesmo seguindo "boas práticas" com conexões não oficiais, o risco de bloqueio nunca é eliminado, apenas reduzido.
* Se o número já sofreu múltiplos soft bans, é altamente recomendável migrar para a API oficial antes que ocorra um banimento permanente.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.flw.chat/guide/documentacao/faq/whatsapp-nao-oficial/restricoes-em-conexoes-nao-oficiais.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.