Pular para o conteúdo

Prévia de uma ação em lote: quem seria atingido agora

GET
/candidatura/vaga/{vagaId}/previa-lote

Mesma seleção das ações em lote (ids e/ou os filtros da lista de candidatos, ou todos=true). Devolve quantidade, até 10 pessoas com a aderência, resumo pronto, apoiadaPorIa (o filtro usa Aderência) e a assinatura que reprovar-varias/mover-varias/enviar-questionario-varias exigem de volta quando há Aderência. recusa preenchida = este canal não pode executar. Não grava nada.

Autorização
Módulo contratado: CONTRATACOES
Permissão: CANDIDATO

vagaId
required
integer format: int64
ids

Candidaturas escolhidas uma a uma (candidaturaId). Com filtro junto, só as que ainda atendem ao filtro.

Array<integer>

Candidaturas escolhidas uma a uma (candidaturaId). Com filtro junto, só as que ainda atendem ao filtro.

etapa

Etapa pelo NOME (ex.: Triagem)

string

Etapa pelo NOME (ex.: Triagem)

etapaId

Etapa pelo id

integer format: int64

Etapa pelo id

semDecisao

Só quem está sem decisão na etapa

boolean

Só quem está sem decisão na etapa

aderenciaMin

Aderência maior ou igual a (0–100). Usa nota de IA: exige confirmarTotal e assinatura da prévia

integer format: int32

Aderência maior ou igual a (0–100). Usa nota de IA: exige confirmarTotal e assinatura da prévia

aderenciaMax

Aderência ABAIXO de (0–100): ‘abaixo de 40’ = 40. Usa nota de IA: exige confirmarTotal e assinatura da prévia

integer format: int32

Aderência ABAIXO de (0–100): ‘abaixo de 40’ = 40. Usa nota de IA: exige confirmarTotal e assinatura da prévia

semAderencia

Só quem não tem aderência medida

boolean

Só quem não tem aderência medida

origem

Origem da candidatura

string

Origem da candidatura

parada

Só quem passou do prazo da etapa

boolean

Só quem passou do prazo da etapa

busca

Nome ou e-mail, palavra a palavra

string

Nome ou e-mail, palavra a palavra

naoAtende

True = só quem respondeu uma pergunta eliminatória fora do esperado (selo Não atende); false = só quem atende

boolean

True = só quem respondeu uma pergunta eliminatória fora do esperado (selo Não atende); false = só quem atende

todos

True = todas as pessoas ativas da vaga (sem outro critério). Exige confirmarTotal

boolean

True = todas as pessoas ativas da vaga (sem outro critério). Exige confirmarTotal

confirmarTotal

Quantas pessoas a pessoa viu e confirmou (o total da prévia). Obrigatório com filtro; diferente do total de agora = recusa

integer format: int32

Quantas pessoas a pessoa viu e confirmou (o total da prévia). Obrigatório com filtro; diferente do total de agora = recusa

assinatura

A assinatura devolvida pela prévia (ats.candidatura.prever-lote). Obrigatória quando o filtro usa Aderência

string

A assinatura devolvida pela prévia (ats.candidatura.prever-lote). Obrigatória quando o filtro usa Aderência

OK

object
resumo
string
quantidade
integer format: int32
apoiadaPorIa
boolean
recusa
string
assinatura
string
excedeMaximo
boolean
maximo
integer format: int32
pessoas
Array<object>

Objeto relacionado: aqui aparecem só os campos simples. Na escrita, basta enviar o id.

object
prospectId
integer format: int64
nome
string
status
string
aderencia
integer format: int32
email
string
restantes
integer format: int32

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade

© 2026 T AI TECNOLOGIA LTDA