Pular para o conteúdo principal

Denúncias e canais

Casos, canais, categorias, prazos, automações, prevenção, indicadores e evidências do canal de denúncias.

📄️Consultar revisão de proteção do caso

Retorna a versão do caso, se a pessoa pode escolher qualquer membro e a lista de pessoas que podem receber acesso caso ele seja protegido (responsável atual, quem recebe casos protegidos e quem já tinha acesso nominal). Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`). Exige leitura do caso e `requests.demands.triage`; para caso já protegido, relato inexistente ou sem a permissão de triagem, a resposta é `null`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Proteger caso

Move o caso para a fila protegida, restringe o acesso às pessoas em `identity_ids` (1 a 100) e registra a justificativa em `reason` (10 a 2000 caracteres); acessos e atividades de quem ficou de fora são revogados. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); exige `requests.demands.read` e `requests.demands.triage`. Idempotente por `request_nonce` e com concorrência otimista por `expected_version` (versão divergente → `409`); caso já protegido → `409`; pessoa que deixou de ser elegível → `409`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Corrigir empresa do caso

Corrige a empresa à qual o caso pertence (a empresa declarada por quem relatou nunca muda), removendo acessos e o responsável fora do escopo da nova empresa. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); exige `requests.demands.triage`. Idempotente por `request_nonce`, com concorrência otimista por `expected_version` (`409` se divergente); empresa inativa ou fora do seu escopo → `422`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Definir autoridade de casos protegidos

Concede ou revoga a autoridade `grantor` ou `contingency` de um membro, com `reason_code`. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`). Só uma autoridade de concessão pode alterar; antes da primeira configuração, apenas o proprietário (`403` caso contrário). Membro inexistente → `422`; conceder a quem não tem acesso a todas as empresas → `422`; revogar a última autoridade de concessão → `409`.

📄️Registrar impedimento por conflito

Impede um membro de atuar em um caso protegido: revoga o acesso dele e, se for o responsável, deixa o caso aguardando nova atribuição. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); permitido a quem pode conceder acesso ao caso ou já tem acesso a ele (`404` caso contrário). Caso fora da fila protegida ou membro inexistente → `422`; impedimento já existente é devolvido sem alteração. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Consultar identidade de quem relatou

Revela a identidade de uma manifestação identificada ou confidencial, com justificativa em `reason_code` (`triage`, `investigation`, `legal`, `inspection`, `other`). Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); exige acesso ao caso, segundo fator verificado com fator cadastrado e, para manifestação confidencial, a permissão `reporting.identity.reveal`. O acesso é registrado no histórico de acessos antes de a identidade sair (recusas também ficam registradas); há limite por hora por pessoa (`429`); identidade ilegível → `409`; o cabeçalho de idempotência não é aceito. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Listar histórico de acessos do caso

Lista os acessos sensíveis ao caso (revelação de identidade, exportação, visualização do relato, retenção), com pessoa, ação, motivo e data, até 500 linhas. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`). Permitido a quem pode conceder acesso ao caso ou a quem tem `requests.history.read` e vê o caso; caso contrário `404`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Exportar caso

Gera um pacote ZIP assinado do caso para fiscalização (o caso como você pode lê-lo, evidências limpas, o histórico de acessos e um manifesto de integridade), montado a cada pedido e nunca armazenado. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); requer a permissão `reporting.cases.export` e acesso ao caso e, com `include_identity`, também segundo fator com fator cadastrado e, para manifestação confidencial, `reporting.identity.reveal`. Cada exportação e recusa fica no histórico de acessos; há limite por hora por pessoa (`429`) e o cabeçalho de idempotência não é aceito. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Consultar análise do caso

Retorna a análise estruturada do caso (triagem, apuração e conclusão), se você pode salvá-la agora e o que cada resultado de apuração ainda exige (`ready_for`, a mesma regra do encerramento); retorna `null` para caso que não é denúncia. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`). Exige acesso ao caso e segundo fator verificado. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Salvar análise do caso

Grava o documento completo da análise (triagem, apuração e conclusão) e cria uma revisão com as seções alteradas. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); requer a permissão `requests.demands.transition`, acesso ao caso e ausência de impedimento por conflito. Concorrência otimista por `expected_version` (`409` se divergente); caso encerrado → `409`; dados inválidos → `422`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Consultar indicadores do canal de denúncias

Indicadores agregados dos relatos no período (`from`/`to`, padrão: mês atual; até cerca de 3 anos), com filtros opcionais `channel_id` e `company_id`: totais, tempos medianos e distribuição por tipo, canal, empresa, categoria, etapa e mês. Grupos com menos de 5 casos são suprimidos e, se o total for insuficiente, retorna `sufficient` igual a `false`. Requer a permissão `reporting.reports.read`; nunca abre um caso. Canal ou empresa fora do seu escopo → `404`.

📄️Baixar cartaz do canal em PDF

Gera o cartaz A4 em PDF de um canal (por slug ou id), com QR code e endereço montados a partir do endereço público da organização, tema (`classic`, `vibrant`, `light`), título e mensagem opcionais; o hash vem no cabeçalho `X-Poster-Sha256`. Requer a permissão `reporting.channels.read` e exige acesso a todas as empresas (`403`). Canal ou empresa não encontrados → `404`; canal não ativo sem `allow_draft` → `409` (com `allow_draft`, cada página leva a marca RASCUNHO); texto que não cabe → `422`.

📄️Definir bloqueio de descarte do caso

Aplica ou libera o bloqueio de descarte (retenção legal) do caso, com `reason_code` (`legal_hold`, `investigation`, `audit`, `inspection`, `other`); a ação fica no histórico de acessos. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); requer a permissão `reporting.retention.manage` e acesso ao caso. Caso que não é relato → `404`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Descartar caso

Apaga de forma irreversível o conteúdo de um caso encerrado além do prazo de retenção (identidade, respostas, mensagens, anexos), mantendo o registro do descarte; `confirm_code` deve repetir o código do caso. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); requer a permissão `reporting.retention.manage`, exige acesso a todas as empresas (`403`) e ser autoridade de concessão (`403`). Fora do prazo, código divergente, já descartado ou bloqueio liberado pela mesma pessoa nas últimas 24 horas → `409`; caso com bloqueio de descarte → `409`. O parâmetro `demand_id` é o código público do caso (4 caracteres).

📄️Gerar pacote de evidências

Monta na hora o pacote de evidências da organização para fiscalização e responde o ZIP, com hashes nos cabeçalhos `X-Evidence-*`; nada é armazenado além de hashes e metadados no histórico, gravado antes de o ZIP sair. Exige `acknowledge` igual a `true`, com período e empresas opcionais. Exige sessão humana com segundo fator confirmado e vínculo ativo na organização; chaves de API não são aceitas (`403`); requer a permissão `reporting.evidence.export` e acesso a todas as empresas. Limites ou tempo de montagem excedidos → `422` (a recusa fica no histórico); outro pacote em montagem → `409`; limite por hora → `429`; o cabeçalho de idempotência não é aceito.

📄️Prorrogar prazo do caso

Prorroga o prazo do ciclo atual do caso em `hours` (1 a 2400) com um motivo em `reason_code`; a soma das prorrogações do ciclo não pode passar de 2400 horas e um clique repetido em até 15 segundos não duplica a prorrogação. Requer a permissão `requests.demands.transition` e não pode ser feito por chave de API. `demand_id` é o código público do caso; caso inexistente ou que você não pode ver responde `404`. Caso encerrado responde `409`; caso sem prazo configurado ou dados inválidos, `422`.

📄️Desfazer reclassificação da IA

Restaura a categoria escolhida por quem relatou, a prioridade original e remove a gravidade definida pela IA, enquanto ninguém da equipe começou a tratar o caso; desfazer uma elevação para a fila protegida exige quem pode conceder acesso ao caso (`403`). Requer a permissão `requests.demands.transition`. `demand_id` é o código público do caso; caso inexistente ou que você não pode ver responde `404`. Sem reclassificação para desfazer ou caso já em tratamento responde `409`.