Fila de Mensagens

14. Fila de Mensagens#

A fila de processamento e baseada em Redis (Asynq). Cada instância tem sua própria fila.

GET/v1/instances/{instanceId}/queue#

Retorna o status da fila daquela instância.

Auth: Owner, Admin — e a instância precisa pertencer à empresa do chamador. Um instanceId de outra empresa (ou inexistente) responde 404 INSTANCE_NOT_FOUND. Vale para os quatro endpoints de fila abaixo.

Resposta 200:

json
{
  "instance_id": "3f9c...",
  "is_paused": false,
  "hourly_limit": 200,
  "messages_sent": 12,
  "resets_at": "2026-07-20T01:00:00Z",
  "queue_pending": 5,
  "queue_active": 1,
  "queue_scheduled": 2,
  "queue_retry": 0,
  "queue_archived": 3
}

Mudança 2026-07-19 (breaking, correção de vazamento). Os contadores eram lidos de Inspector.GetQueueInfo("default") — totais do deployment inteiro — e devolvidos como se fossem da instância: duas empresas distintas liam o mesmo queue_archived. Agora queue_pending / queue_active / queue_scheduled / queue_retry / queue_archived são contados por instância (filtrando as tasks pelo instance_id do payload). Os campos globais O campo global queue_completed foi removido deste endpoint — o agregado da plataforma continua em GET /v1/admin/queue (superadmin). Os nomes dos campos foram preservados — só o queue_completed saiu (o conjunto completed do Asynq é artefato de retenção da fila inteira, sem significado por instância). A varredura é limitada a 2000 tasks; ao atingir o teto a resposta inclui "queue_counts_capped": true.


POST/v1/instances/{instanceId}/queue/pause#

Pausa o processamento da fila. Mensagens continuam sendo aceitas mas não são enviadas.

Auth: Owner, Admin

Resposta 200:

json
{
  "status": "paused",
  "instance_id": "84c2e480-..."
}

POST/v1/instances/{instanceId}/queue/resume#

Retoma o processamento da fila.

Auth: Owner, Admin

Resposta 200:

json
{
  "status": "resumed",
  "instance_id": "84c2e480-..."
}

DELETE/v1/instances/{instanceId}/queue#

Limpa todas as mensagens pendentes da fila.

Auth: Owner, Admin

Resposta 200:

json
{
  "status": "cleared",
  "instance_id": "84c2e480-..."
}