Preflight QC

O Preflight QC é um complemento premium que oferece um controle de qualidade profissional dos seus lançamentos. Envie um lançamento e o Preflight QC o analisa de ponta a ponta: metadados, datas de lançamento, áudio, capa, conteúdo com IA, identificadores de catálogo, distribuição anterior e documentação de licenças. Você recebe um relatório de qualidade claro e acionável. Corrija o que ele apontar no seu próprio ritmo e, quando estiver satisfeito, confirme o lançamento para análise.

Para selos e integradores da API, o Preflight QC funciona como um bloco de construção. Obtenha o relatório de qualidade de forma programática, conecte-o ao seu próprio fluxo de QA, condicione o seu processo interno de aprovação aos resultados e confirme lançamentos para análise automaticamente. A sua equipe define o padrão de qualidade, e o Preflight QC faz a análise.

Um lançamento que chega limpo avança rápido pela análise. O Preflight QC leva você até lá antes de enviar.

O que é o Preflight QC

Com o Preflight QC ativado na sua conta, enviar um lançamento para distribuição não o manda direto para a fila de análise. Em vez disso, o lançamento entra em uma espera pré-análise (“aguardando a sua revisão”) enquanto o Preflight QC executa sua análise de qualidade: metadados, datas de lançamento, áudio, capa, conteúdo com IA, identificadores de catálogo, distribuição anterior e documentação de licenças. O resultado é um relatório de qualidade, e o que você constrói sobre ele é decisão sua:

Seu próprio fluxo de QA (API). Passe o seu catálogo pela análise de qualidade, obtenha o relatório de forma programática no seu próprio fluxo de QA, condicione o seu processo interno de aprovação aos resultados e confirme cada lançamento para análise somente quando ele passar pelo seu crivo. Veja Usar a API para integrações.
O fluxo no aplicativo. Leia o relatório na página do lançamento, corrija o que ele apontar e confirme quando estiver satisfeito.

Nos dois casos, é a confirmação que move o lançamento para a fila de análise normal: nada entra em análise até você dar o aval.

O Preflight QC adiciona uma etapa de qualidade antes da análise. Ele não muda o que acontece depois: assim que você confirma, o seu lançamento passa pelo mesmo processo de validação e análise que qualquer outro lançamento.

Como obter o Preflight QC

O Preflight QC é um complemento premium ativado por conta pela nossa equipe. Para ativá-lo na sua conta, entre em contato com a nossa equipe de vendas e informe que deseja o Preflight QC.

Depois de ativado, você verá a nova etapa de espera e confirmação na próxima vez que enviar um lançamento para distribuição.

O fluxo de trabalho do Preflight QC

Este é o caminho completo de um lançamento com o Preflight QC ativado, do envio à análise.

1. Envie o seu lançamento para distribuição

Crie e conclua o seu lançamento como de costume e, depois, envie-o para distribuição. Com o Preflight QC ativado, isso não coloca o lançamento na fila de análise de imediato. Em vez disso, o lançamento passa para uma espera pré-análise e é marcado como aguardando a sua revisão.

2. A análise de qualidade é executada

Enquanto o seu lançamento está em espera, o Preflight QC o analisa de ponta a ponta. A análise cobre:

Metadados: títulos, artistas, créditos e outros detalhes do lançamento e das faixas
Datas de lançamento: a configuração de datas e as versões do lançamento
Áudio: os arquivos de áudio que você enviou
Capa: a sua imagem de capa
Conteúdo com IA: se o uso de IA foi declarado e a música ou a capa gerada por IA que detectamos
Identificadores de catálogo: se os seus ISRCs são válidos e se uma gravação já foi reivindicada por outro titular de direitos
Distribuição anterior: se o lançamento ou as suas faixas já estão nas lojas por outra distribuidora
Licenças: quando um cover, um sample ou algo semelhante precisa de documentação de apoio

A análise costuma terminar poucos minutos depois de o envio e a transcodificação serem concluídos. Enquanto ainda está em andamento, o relatório de qualidade indica que as verificações estão em andamento e ainda não lista nenhum problema.

3. Leia o seu relatório de qualidade

Assim que a análise terminar, abra o relatório de qualidade do lançamento para ver o que, se houver algo, precisa da sua atenção. Você pode lê-lo em dois lugares:

Pela API pública, para o seu próprio fluxo de QA; veja Usar a API mais abaixo.
No aplicativo, na página do lançamento.

O relatório lista cada problema com um título claro e uma mensagem que descreve o que corrigir. Veja Entender o relatório de qualidade para saber como ler os campos.

4. Corrija o que for apontado

Percorra os problemas do seu relatório:

Problemas de metadados: edite os detalhes do lançamento ou da faixa.
Problemas de áudio ou de capa: substitua o arquivo afetado.
Problemas que pedem um retorno: responda no tópico de notas do problema ou envie o documento solicitado (por exemplo, uma licença para um cover ou um sample).

Editar o seu lançamento enquanto ele está em espera marca o relatório atual como desatualizado: as constatações não refletem mais o estado mais recente do seu lançamento. Edite quanto quiser e, depois, solicite uma nova análise, pela página do lançamento no aplicativo ou pelo endpoint de atualização para integrações. A análise é executada novamente e o relatório é atualizado com os novos resultados. Você pode repetir esse ciclo quantas vezes precisar, dentro de um limite de uso justo de quantas novas análises você pode iniciar por lançamento a cada hora.

5. Confirme o lançamento

Quando o seu relatório estiver limpo, ou você tiver tratado tudo o que precisava, confirme o lançamento. No aplicativo, é um botão de confirmação no lançamento; para integrações, é o endpoint de confirmação.

A confirmação tira o lançamento da espera e o move para a fila de análise normal. A confirmação exige uma análise concluída e atualizada: se você editou o lançamento após a última execução, o relatório está desatualizado, então solicite uma nova análise e deixe-a terminar antes de confirmar.

6. Análise normal

Após a confirmação, o seu lançamento é analisado exatamente como qualquer outro. Para saber o que acontece durante a análise, os prazos e os resultados possíveis, veja Validação e análise.

Entender o relatório de qualidade

O relatório de qualidade tem duas partes: uma lista de problemas e um pequeno bloco de detalhes do relatório sobre a execução em si.

Problemas

Cada problema no relatório descreve um ponto a examinar. Os campos com que você vai trabalhar:

Campo	O que ele indica
Título	Um nome curto e em linguagem simples para o problema.
Mensagem	O que é o problema e o que fazer a respeito.
Gravidade	A importância do problema, para ajudar você a priorizar.
Bloqueante	Se o problema precisa ser resolvido antes de você poder confirmar (veja abaixo).
Exige retorno	Se o problema precisa de uma resposta escrita ou de um documento enviado por você.
Descrição personalizada	Detalhes adicionais específicos do seu lançamento, quando disponíveis.
Faixas afetadas	A quais faixas o problema se aplica. Problemas no nível do lançamento não listam faixas específicas.
Evidências	Em problemas de data, de duplicidade e de distribuição anterior, os lançamentos correspondentes que encontramos, para que você mesmo verifique o conflito (veja abaixo).

Bloqueante ou informativo

Problemas bloqueantes precisam ser resolvidos antes de você poder confirmar o lançamento para análise. Corrija o que eles descrevem, execute uma nova análise e eles sairão do seu relatório.
Problemas informativos estão ali para sinalizar algo que vale um olhar, mas não impedem você de confirmar. Analise-os e confirme quando estiver pronto.

Problemas que exigem retorno

Alguns problemas não se resolvem só com edição: eles precisam de algo de você, como uma explicação escrita ou um documento de apoio (por exemplo, uma licença para um cover ou um sample). Eles são marcados como exige retorno. Para resolver um deles, responda no tópico de notas do problema ou envie o documento solicitado antes de confirmar.

Evidências em um problema

Alguns problemas incluem evidências para ajudar você a verificar uma sinalização sem precisar adivinhar: os lançamentos existentes que correspondem ao seu. Você as verá em problemas de data, de duplicidade e de distribuição anterior. Cada correspondência mostra o título e o artista da faixa correspondente, o título do lançamento dela, a data de lançamento e o ISRC, além de um link para uma loja onde esse lançamento está no ar e a quais das suas faixas ela se aplica. São listadas até três correspondências por faixa. Use as evidências para confirmar se o conflito é real (por exemplo, um envio anterior seu) antes de decidir como responder.

Os detalhes do relatório

Ao lado dos problemas, o relatório inclui alguns detalhes sobre a execução:

Campo	O que ele indica
generated_at	Quando o relatório atual foi produzido. Fica vazio enquanto a primeira análise ainda está em andamento.
checks_in_progress	`true` enquanto a análise ainda está em andamento; a lista de problemas fica vazia até que termine.
stale	`true` quando você editou o lançamento (ou qualquer uma de suas faixas) após a última análise concluída, de modo que as constatações não refletem mais o estado atual. Qualquer edição conta. Solicite uma nova análise para atualizar o relatório.
hold	Se o lançamento está atualmente na espera pré-análise.
review_status	O status de análise atual do lançamento.
release_status	O status geral do próprio lançamento, ao lado do status específico de análise.
profile	O perfil de qualidade aplicado a este lançamento, com o seu nome e a sua versão.

Usar a API para integrações

Se você desenvolve sobre a API pública do LabelGrid, pode conectar o Preflight QC ao seu próprio pipeline: passe cada lançamento pela análise de qualidade, leve o relatório para o seu próprio fluxo de QA, condicione o seu processo interno de aprovação aos resultados e confirme para análise a partir das suas próprias ferramentas. O Preflight QC oferece três endpoints para isso, todos com a mesma autenticação por token Bearer que o restante da API pública. Para os esquemas completos e sempre atualizados de requisição e resposta, veja a referência da API.

Webhook: saiba quando o relatório está pronto

Em vez de consultar os resultados periodicamente, você pode fazer o LabelGrid avisar você no instante em que um relatório fica pronto. Assine o evento de webhook release.preflight.report_ready: ele dispara assim que o Preflight QC termina de analisar um lançamento na espera pré-análise, inclusive cada vez que uma nova análise que você solicita é concluída. Você recebe exatamente um evento por ciclo de análise.

Assine da mesma forma que assina os outros eventos de webhook de lançamento do LabelGrid, nas configurações de webhook no aplicativo ou pela API. Cada evento traz um resumo compacto da execução, nunca os problemas em si:

Identificadores do lançamento: release_id, label_id, release_cat e release_title.
generated_at: quando este relatório foi produzido. Coincide com o próprio generated_at do relatório.
profile: o perfil de qualidade pelo qual as contagens foram calculadas, como {name, version}.
counts: os totais de blocking, informational e requires_feedback. A contagem de requires_feedback se sobrepõe às outras duas.

Use as contagens para decidir se você precisa agir e, então, busque o próprio relatório para ver os detalhes. O padrão de integração recomendado:

Assine o release.preflight.report_ready.
A cada evento, chame Obter o relatório de qualidade para ler o conjunto completo de problemas.
Corrija e execute novamente: após editar um lançamento em espera, chame o endpoint de atualização para iniciar uma nova análise; o webhook dispara de novo quando ela é concluída.
Decida e confirme a partir das suas próprias ferramentas assim que o lançamento passar pelo seu crivo.

Para a referência completa do payload e o funcionamento do webhook (assinatura, novas tentativas e o envelope), veja Webhooks.

Obter o relatório de qualidade

GET /api/public/releases/{id}/quality-report
Authorization: Bearer YOUR_API_TOKEN

Retorna o relatório de qualidade atual do lançamento. A resposta traz:

issues[]: uma entrada por problema, cada uma com id, code (uma string estável; veja Trabalhar com os códigos de problema), title, message, status, severity, is_blocking, requires_feedback, custom_description e affected_tracks. Em problemas de data, de duplicidade e de distribuição anterior, a entrada também traz um array evidence (veja abaixo).
report: generated_at, checks_in_progress, stale, hold, review_status, release_status e profile (um objeto com name e version). stale é true quando o lançamento ou qualquer uma de suas faixas foi editado após a última análise concluída; execute a análise novamente com o endpoint de atualização antes de confirmar.

Enquanto a análise ainda está em andamento, o relatório retorna checks_in_progress: true com uma lista issues vazia. Se você preferir não usar webhooks, consulte este endpoint periodicamente até que generated_at esteja preenchido, normalmente poucos minutos após o término do envio e da transcodificação, e então leia os problemas. Para, em vez disso, ser avisado no instante em que o relatório ficar pronto, use o webhook de relatório pronto.

Um exemplo de resposta com a análise concluída:

{
  "issues": [
    {
      "id": "12345",
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "status": "confirmed",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456],
      "evidence": [
        {
          "affected_track_id": 456,
          "track_title": "Matched track title",
          "artist": "Matched artist",
          "release_title": "Matched release",
          "release_date": "2024-03-01",
          "isrc": "USRC12345678",
          "store_url": "https://…"
        }
      ]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "stale": false,
    "hold": true,
    "review_status": "…",
    "release_status": "…",
    "profile": { "name": "quality_report", "version": 2 }
  }
}

Cada item de evidence descreve um lançamento existente que correspondeu ao seu: affected_track_id (a qual das suas faixas a correspondência se aplica), o track_title, o artist, o release_title, a release_date e o isrc correspondentes, e um store_url que aponta para a página de uma loja onde a correspondência está no ar. São listadas no máximo três correspondências por faixa, e a chave está presente apenas nos tipos de problema acima.

Solicitar uma nova análise

POST /api/public/releases/{id}/quality-report/refresh
Authorization: Bearer YOUR_API_TOKEN

Inicia um novo ciclo de análise do Preflight QC para um lançamento em espera. Editar um lançamento em espera não executa novamente as verificações por conta própria: apenas marca o relatório atual como desatualizado (report.stale: true). Quando terminar de editar, chame este endpoint para executar a análise novamente; quando o ciclo é concluído, o webhook de relatório pronto dispara e report.stale volta a false.

Uma chamada bem-sucedida retorna 202 Accepted:

{
  "status": "refreshing",
  "checks_in_progress": true,
  "review_status": "pending_customer_review",
  "release_status": "to_review"
}

A chamada é idempotente enquanto um ciclo está em andamento: chamá-la de novo retorna o mesmo corpo de progresso, não coloca uma segunda análise na fila e não conta contra a sua cota. Outras respostas que você deve tratar:

409 not_in_customer_review_hold: o lançamento não está atualmente em espera para a sua análise do Preflight QC.
409 refresh_coalesced: uma análise para este lançamento foi concluída há instantes, então nada foi colocado na fila. Tente novamente após o cabeçalho Retry-After (em segundos).
429 preflight_recheck_limit_reached: você atingiu a cota de uso justo de 6 ciclos de análise iniciados por lançamento a cada hora corrida. O cabeçalho Retry-After (em segundos) informa quando a próxima atualização é permitida. Consultar uma análise em andamento é gratuito; apenas iniciar um novo ciclo consome cota.
403 RELEASE_NOT_VALIDATED: o lançamento precisa passar na validação antes que uma nova análise possa começar (a mesma regra da distribuição); execute a validação primeiro.
403 pre_review_qc_not_enabled: o Preflight QC não está ativado para a conta proprietária.

Confirmar o lançamento para análise

POST /api/public/releases/{id}/confirm-review
Authorization: Bearer YOUR_API_TOKEN

Tira o lançamento da espera e o move para a fila de análise normal: o equivalente, via API, ao botão de confirmação no aplicativo.

A confirmação exige uma análise concluída e atualizada. Dois conflitos a tratar:

409 checks_in_progress: a análise ainda está em andamento. Aguarde o webhook de relatório pronto (ou consulte periodicamente até que generated_at esteja preenchido) e então tente novamente.
409 checks_stale: o lançamento foi editado após a última análise concluída (report.stale é true). Chame o endpoint de atualização, aguarde o novo relatório e então tente a confirmação novamente.

Trabalhar com os códigos de problema

Se você constrói lógica sobre o relatório de qualidade, baseie-a no code do problema:

code é uma string estável em formato slug (por exemplo, audio.trailing-silence). É seguro mapear os códigos no seu sistema e construir lógica sobre eles.
Títulos e mensagens são textos para pessoas. Eles podem ser refinados com o tempo; nunca baseie a sua lógica no texto, use-o apenas para exibição.
Códigos novos podem surgir à medida que a cobertura do Preflight QC se expande. Trate códigos desconhecidos de forma genérica: exiba o title e a message da resposta em vez de falhar.
Seus relatórios ensinam os códigos que importam. À medida que você passa lançamentos pelo Preflight QC, os códigos relevantes para o seu catálogo aparecem naturalmente nos seus próprios relatórios de qualidade.
O que a análise cobre. Os problemas se enquadram nestas categorias: metadados do lançamento e das faixas, datas e versões do lançamento, qualidade do áudio, capa, conteúdo com IA, identificadores de catálogo, distribuição anterior, e licenças e documentação.

O catálogo de problemas

Para mapear os problemas ao montar o seu próprio fluxo de QA, recupere o catálogo completo de forma programática:

GET /api/public/issue-definitions
Authorization: Bearer YOUR_API_TOKEN

Ele retorna todos os problemas que podem aparecer em um relatório de qualidade, indexados pelo seu código de string estável, com o título, o modelo da mensagem, a gravidade, o indicador de bloqueio, requires_feedback e a sua categoria (type). A resposta também traz o perfil de qualidade pelo qual o catálogo foi calculado, como {name, version}. O endpoint está disponível apenas para contas com o complemento Preflight QC.

Perguntas frequentes

E se a análise de qualidade ainda estiver em andamento?

O relatório mostrará checks_in_progress: true sem problemas listados por enquanto. Isso é normal logo após o envio. Aguarde alguns minutos depois de o envio e a transcodificação terminarem e verifique de novo: no aplicativo, o relatório se atualiza sozinho. Pela API, você pode assinar o webhook de relatório pronto para receber uma notificação no instante em que ele estiver pronto, ou consultar periodicamente até que generated_at esteja preenchido.

Posso editar o meu lançamento enquanto ele está em espera?

Sim, edite tão livremente quanto quiser: um lançamento na espera pré-análise permanece totalmente editável. Editar não executa novamente as verificações por si só; marca o relatório atual como desatualizado. Quando terminar as suas alterações, solicite uma nova análise (na página do lançamento no aplicativo ou pelo endpoint de atualização para integrações) para ver os resultados atualizados sem sair da espera. A nova análise precisa ser concluída antes de você poder confirmar.

O que acontece depois que eu confirmo?

O seu lançamento sai da espera e entra na fila de análise normal, onde é analisado como qualquer outro. Veja Validação e análise para saber como a análise funciona, quanto tempo leva e os resultados possíveis.

Posso voltar um lançamento para rascunho?

Sim: enquanto o seu lançamento está na espera pré-análise e você ainda não o confirmou, ele não entrou em análise, então você fica livre para continuar editando-o ou deixá-lo como rascunho e voltar mais tarde. Ele só entra na fila de análise quando você o confirma.

Preciso corrigir todos os problemas antes de confirmar?

Você precisa resolver os problemas bloqueantes antes de poder confirmar. Os problemas informativos não impedem você de confirmar, mas valem um olhar: resolver o máximo possível antes da análise é o caminho mais rápido para a aprovação.

Dúvidas sobre o Preflight QC? Entre em contato com a nossa equipe. Teremos prazer em ajudar.

Ainda não usa a LabelGrid?

Tudo o que você acabou de ler está disponível na nossa plataforma.

Veja o que a LabelGrid pode fazer →