> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/integracoes/integracoes-z-api/z-api-sistema-de-fila.md).
# Z-API - Sistema de Fila
A Z-API possui um sistema de fila responsável por organizar e controlar o envio das mensagens realizadas através da API. Esse mecanismo garante que as mensagens sejam processadas de forma ordenada e contribui para manter a estabilidade dos envios, principalmente em cenários de instabilidade da conexão do aparelho vinculado ao WhatsApp.
***
### Como funciona a fila?
Sempre que uma mensagem é enviada para a Z-API, ela não é encaminhada imediatamente ao WhatsApp. Primeiramente, ela é adicionada a uma fila de processamento, onde aguarda sua vez para ser enviada.
De forma simplificada, o fluxo ocorre da seguinte maneira:
1. O sistema envia a mensagem para a Z-API.
2. A Z-API adiciona a mensagem à fila.
3. A instância processa a fila e realiza o envio ao WhatsApp.
4. Os webhooks informam o status do processamento e da entrega da mensagem.
### Funcionamento durante instabilidades
O sistema de filas também atua como uma camada de proteção quando o celular conectado à instância fica temporariamente indisponível, seja por falta de internet, desligamento do aparelho ou outras instabilidades.
Nesses casos, as mensagens permanecem armazenadas na fila e, assim que a conexão for restabelecida, os envios pendentes serão processados automaticamente.
***
### Como desabilitar a fila
Caso não deseje utilizar o sistema de filas, é necessário desabilitar essa funcionalidade diretamente nas configurações da **Instância Web da Z-API**.
{% hint style="danger" %}
**Importante:** ao desativar a fila, as mensagens não ficarão armazenadas caso a instância esteja desconectada. Dessa forma, qualquer tentativa de envio realizada durante um período de indisponibilidade poderá falhar e não será reenviada automaticamente após a reconexão.
{% endhint %}
Recomenda-se avaliar cuidadosamente essa configuração antes de desabilitá-la.
### Recomendação importante
Antes de reconectar uma instância, a Z-API recomenda verificar se existem mensagens pendentes na fila.
Isso é importante porque, ao reconectar a instância, a fila será executada automaticamente e todas as mensagens pendentes serão enviadas. Dependendo do contexto, essas mensagens podem já não fazer mais sentido para o destinatário.
Por esse motivo, recomenda-se que o usuário seja informado sobre a existência dessas mensagens e decida se deseja mantê-las ou descartá-las antes da reconexão.
### Limite da fila
A Z-API permite armazenar até **1.000 mensagens** na fila enquanto o celular estiver desconectado. Após atingir esse limite, novas mensagens começarão a ser rejeitadas até que haja espaço disponível na fila.
***
### Referência oficial
Para mais informações, consulte a documentação oficial da Z-API:
---
# 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.sprinthub.com/topicos/integracoes/integracoes-z-api/z-api-sistema-de-fila.md?ask=&goal=
```
`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.