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:
{
"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 mesmoqueue_archived. Agoraqueue_pending/queue_active/queue_scheduled/queue_retry/queue_archivedsão contados por instância (filtrando as tasks peloinstance_iddo payload). Os campos globais O campo globalqueue_completedfoi removido deste endpoint — o agregado da plataforma continua emGET /v1/admin/queue(superadmin). Os nomes dos campos foram preservados — só oqueue_completedsaiu (o conjuntocompleteddo 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:
{
"status": "paused",
"instance_id": "84c2e480-..."
}
POST/v1/instances/{instanceId}/queue/resume#
Retoma o processamento da fila.
Auth: Owner, Admin
Resposta 200:
{
"status": "resumed",
"instance_id": "84c2e480-..."
}
DELETE/v1/instances/{instanceId}/queue#
Limpa todas as mensagens pendentes da fila.
Auth: Owner, Admin
Resposta 200:
{
"status": "cleared",
"instance_id": "84c2e480-..."
}