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:
O sistema envia a mensagem para a Z-API.
A Z-API adiciona a mensagem à fila.
A instância processa a fila e realiza o envio ao WhatsApp.
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.
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.
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:
Atualizado
Isto foi útil?