Atualmente a plataforma conta com duas modalidades de instância  WhatsApp QR Code (API não oficial) e WhatsApp Oficial (API oficial da Meta) que são localizadas dentro das respectivas abas. Veja abaixo como acessar.

Como Acessar a Fila de Envios da Instância

A Fila de Envios permite acompanhar o processamento das notificações e realizar ações de gerenciamento conforme o tipo de instância utilizada.

WhatsApp QR Code

Para acessar a fila de envios de uma instância WhatsApp QR Code:

1. No menu lateral esquerdo, clique em WhatsApp QR Code;
2. Selecione a instância desejada;
3. No submenu exibido, clique em Fila de Envios.

WhatsApp Oficial

Para acessar a fila de envios de um número da API Oficial:

1. No menu lateral esquerdo, clique em WhatsApp Oficial;
2. Acesse Números de Telefone;
3. Selecione o número desejado;
4. No submenu exibido, clique em Fila de Envios.

Ao acessar a tela, você poderá visualizar as notificações pendentes, acompanhar o status dos envios e utilizar as opções de gerenciamento disponíveis para a instância selecionada.

Visão Geral da Fila

Na parte superior da tela, você encontrará um painel com informações importantes sobre o funcionamento da fila.

Indicadores da fila

• Tempo estimado para finalizar os envios: Exibe uma previsão de quanto tempo será necessário para concluir o processamento das notificações que ainda estão na fila.
• Total de mensagens na fila: Mostra a quantidade de notificações pendentes de envio.
• Criadas nos últimos 5 minutos: Indica quantas notificações foram geradas recentemente e adicionadas à fila.
• Entregues nos últimos 5 minutos: Apresenta a quantidade de notificações enviadas com sucesso nos últimos cinco minutos.

Status da fila: Exibe a situação atual das instâncias conectadas à loja.

• Ativa: Indica que todas as instâncias conectadas à loja estão prontas para realizar envios normalmente.
• Inativa: Indica que não há instâncias prontas para envio ou que nenhuma instância está conectada à loja.

Gráfico de envios

O gráfico apresenta o total de mensagens enviadas nos últimos 7 dias:

Ao passar o mouse sobre a linha do gráfico, será exibido a data e a quantidade de envios.

Entendendo os Estados da Fila

A lista de notificações permite visualizar e filtrar os envios conforme o estado de processamento.

Na instância QR Code é possível filtrar por:

• Aguardando: A notificação está na fila e pronta para ser enviada.
• Processando: A notificação está sendo processada e enviada para o WhatsApp.

Já na fila de envios da API Oficial está disponível:

• Reagendando: A notificação está aguardando uma instância disponível para ser novamente agendada para envio.
• Processando: A notificação está sendo processada e enviada para o WhatsApp.
• Finalizado: Processamento finalizado.
• Na fila: Aguardando processamento.
• Todos: Exibe notificações de todos os estados disponíveis.
• Cancelado: Exibe notificações que tiveram o envio cancelado.
• Falha: Exibe notificações que falharam no envio.

Informações disponíveis na listagem

Cada notificação exibe os seguintes dados:

• Criado em: Exibe a data e o horário em que a notificação foi criada e adicionada à fila de envios.
• Origem: Indica a origem responsável pela criação da notificação, permitindo identificar qual integração, evento ou processo gerou o envio.
• Nome: Apresenta o nome da notificação ou do evento relacionado ao envio.
• Prioridade: Indica o nível de prioridade atribuído à notificação dentro da fila de processamento. Notificações com maior prioridade podem ser processadas antes das demais.
• Status: Exibe o status atual da notificação, permitindo acompanhar seu ciclo de processamento e envio.
• Resultado: Apresenta o resultado retornado pela API após a tentativa de envio da mensagem. Essa informação pode auxiliar na identificação de erros, recusas ou confirmações de processamento realizadas pelo WhatsApp Oficial. Disponível apenas para instâncias da API Oficial.
• Estado: Indica o estado atual da notificação dentro da fila de envios. Por meio dessa informação, é possível identificar se a mensagem está aguardando processamento, sendo enviada ou passando por alguma etapa intermediária do fluxo de envio. Disponível apenas para instâncias QR Code.
• Ações/Opções:

➛ Ver detalhes: Permite visualizar as informações completas do evento que originou a notificação.

➛ Remover da fila: Remove uma notificação específica da fila de envios da loja.

Utilize essa opção quando houver necessidade de cancelar um envio antes que ele seja processado.

Gerenciamento da fila de envios

Além da visualização e acompanhamento das notificações, também é possível realizar ações de gerenciamento da fila de envios.

Para acessar essas opções, vá até a tela de Fila de Envios e clique no menu de opções (três pontos), localizado no canto superior direito da página.

As opções disponíveis variam conforme o canal utilizado:

WhatsApp Oficial: permite limpar a fila de envios, reprocessar mensagens canceladas e reprocessar mensagens que permanecem pendentes.

WhatsApp QR Code: permite limpar a fila, rebalancear as notificações entre as instâncias conectadas e recuperar mensagens removidas.

• Limpar fila: remove todas as notificações que estão atualmente pendentes de envio.

Ao clicar em Limpar fila, será exibida uma janela de confirmação.

Atenção: Após a confirmação, todas as notificações pendentes serão removidas da fila.

• Rebalancear fila: redistribui automaticamente as notificações pendentes entre as instâncias conectadas à loja.

Ao selecionar essa opção, o sistema realizará a redistribuição das notificações de forma automática.

Esse recurso é útil quando:

➛ Novas instâncias foram conectadas recentemente;

➛ Existe uma diferença de carga entre as instâncias disponíveis;

➛ Você deseja otimizar a velocidade de processamento dos envios.

• Recuperar mensagens: caso notificações tenham sido removidas da fila por engano, você poderá restaurá-las utilizando a opção Recuperar mensagens, desde que a remoção tenha ocorrido nos últimos 48 horas. Após esse período, as notificações não poderão mais ser recuperadas.

Atenção: esta ação não poderá ser desfeita. Todas as mensagens removidas da fila nas últimas 48 horas serão reinseridas na fila de envios para processamento.

Após a conclusão do processo, uma notificação será exibida informando a quantidade de mensagens recuperadas com sucesso.

Atualizado em: 29/05/2026