Enviar questionários comportamentais e ler o perfil

Os questionários da TAI medem o perfil comportamental (DISC), a cultura organizacional e, para a gestão de saúde e segurança, os riscos psicossociais e o bem-estar. A pessoa recebe um convite por e-mail, responde no portal da TAI e o resultado fica no cadastro dela — e no do candidato, quando o convite sai de um processo seletivo. A integração típica dispara convites a partir de outro sistema (o ATS, o onboarding) e leva o perfil DISC para onde ele é usado.

Quando usar	DISC de todo candidato que chega a uma etapa, perfil comportamental no onboarding, mapa de perfis da equipe no BI
Porta	REST · Automação · Webhook assinando eventos · Agente (MCP)
Você vai precisar	Módulo PESSOAS e permissão QUESTIONARIO (convites e resultados de colaboradores); para resultados de candidatos, módulo CONTRATACOES e permissão CANDIDATO; token JWT de um usuário de integração

Como funciona

seu sistema ── POST /convite-questionario/criar-equipe ─────▶ TAI  (convites a colaboradores)
            ── POST /convite-questionario/candidatura ──────▶ TAI  (convite a um candidato)
TAI ── e-mail com o link ──▶ pessoa responde no portal (identifica-se pelo CPF ou e-mail)
seu sistema ── GET /convite-questionario/page-custom ───────▶ TAI  (status dos convites)
seu sistema ── GET /resposta-questionario/colaborador/{id}/ultimo-questionario/PERFIL_COMPORTAMENTAL ▶ TAI

Os tipos (tiposQuestionario) são PERFIL_COMPORTAMENTAL (DISC), CULTURA_ORGANIZACIONAL, PSICOSSOCIAL, OLBI (bem-estar no trabalho) e DASS21 (bem-estar emocional). Um convite pode levar vários tipos de uma vez.

Passo a passo

1. Convide colaboradores.

   POST /convite-questionario/criar-equipe
   Authorization: Bearer $TAI_TOKEN
   Content-Type: application/json
   
   {
     "colaboradorIds": [1043, 1051, 1077],
     "tiposQuestionario": ["PERFIL_COMPORTAMENTAL", "CULTURA_ORGANIZACIONAL"],
     "dataLimite": "2026-10-20",
     "observacoes": "Parte do onboarding"
   }

   A resposta é a lista de convites (id, statusGeral PENDENTE, tiposQuestionario). Cada pessoa recebe um e-mail com o link; no portal, ela se identifica pelo CPF ou pelo e-mail. Para uma pessoa só, há também POST /convite-questionario/criar-individual?colaboradorId=1043&tiposQuestionario=PERFIL_COMPORTAMENTAL&dataLimite=2026-10-20.

2. Ou convide um candidato. O convite fica ligado à candidatura da vaga.

   POST /convite-questionario/candidatura
   
   { "candidaturaId": 905, "tiposQuestionario": ["PERFIL_COMPORTAMENTAL"], "dataLimite": "2026-10-10" }

   Para várias candidaturas, POST /convite-questionario/candidatura/lote com candidaturaIds.

3. Acompanhe os convites.

   GET /convite-questionario/page-custom?tipoQuestionario=PERFIL_COMPORTAMENTAL&status=PENDENTE&page=0&size=50

   Filtros: status, tipoQuestionario, colaboradorId, departamentoId, setorId, dataConviteInicio, dataConviteFim. Cada convite traz statusGeral (PENDENTE, RESPONDIDO, EXPIRADO, CANCELADO), tiposRespondidos, tiposPendentes e a entrega do e-mail (statusEmail, emailDestino). De uma candidatura: GET /convite-questionario/candidatura/{candidaturaId}.

   Para saber quem nunca respondeu um tipo, numa consulta só: GET /resposta-questionario/pendentes/PERFIL_COMPORTAMENTAL.

4. Leia o perfil. O último questionário respondido de um tipo:

   GET /resposta-questionario/colaborador/1043/ultimo-questionario/PERFIL_COMPORTAMENTAL

   Para o DISC, a resposta traz perfilDominante, perfilSecundario, dataResposta e, por fator, pontuacaoDominancia, pontuacaoInfluencia, pontuacaoEstabilidade, pontuacaoConformidade e os percentual… correspondentes. Para cultura, perfilCulturalDominante, perfilCulturalSecundario e os percentuais Colaborativa, Criativa, Competitiva e Estruturada. GET /resposta-questionario/colaborador/{id}/ultimos-questionarios traz o último de cada tipo.

   De um candidato: GET /candidatura/{id}/questionarios/ultimos.

Resultados de saúde mental não saem

PSICOSSOCIAL, OLBI e DASS21 são dados de saúde. O resultado individual desses tipos nunca sai pela API — para nenhum papel, permissão ou canal: as rotas devolvem a resposta com resultadoRestrito: true e sem score, nível de risco ou ações recomendadas. O que a plataforma oferece sobre eles são indicadores agregados, na tela. E OLBI e DASS21 são rastreios clínicos: convidar um candidato para eles é recusado com 400 — triagem de saúde não entra em processo seletivo.

Automatize

Para enviar o DISC a todo candidato, use um fluxo automatizado (Processos › Fluxos › Novo processo › Fluxo automatizado) que começa por Quando algo acontece com o evento Alguém se candidata a uma vaga (CANDIDATURA_CRIADA) e segue para o bloco Fazer algo na plataforma — a operação de criar convite de questionário para candidatura —, com os parâmetros:

{ "body": { "candidaturaId": "{{gatilho.candidaturaId}}", "tiposQuestionario": ["PERFIL_COMPORTAMENTAL"] } }

A operação roda com a permissão de quem publica o fluxo, e o fluxo só age depois de Publicar. Para enviar o DISC só a quem chega a uma etapa, use o evento Um candidato muda de etapa (CANDIDATURA_MOVIDA_ETAPA) e filtre etapaDestino em Só quando — ou assine o evento num webhook, filtre no seu sistema e crie o convite pela API (passo 2). Veja também o Recrutamento.

Lembretes: POST /convite-questionario/{id}/reenviar reenvia um convite (o expirado ganha prazo novo) e POST /convite-questionario/reenviar-pendentes lembra todos os pendentes.

Saber quando o DISC foi respondido

Cada perfil comportamental respondido publica Um questionário de perfil comportamental é respondido (QUESTIONARIO_PERFIL_RESPONDIDO); o convite que vence sem resposta, Um convite de perfil comportamental expira (QUESTIONARIO_PERFIL_EXPIRADO). Assine-os num webhook e o seu sistema lê o perfil (passo 4) assim que ele existe:

{
  "id": "evt_65101",
  "tipo": "QUESTIONARIO_PERFIL_RESPONDIDO",
  "descricao": "Um questionário de perfil comportamental é respondido",
  "versao": 1,
  "ocorridoEm": "2026-10-08T11:27:40.903Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "conviteId": 7710,
    "candidaturaId": 905
  }
}

Num convite de colaborador vem colaboradorId; num de candidato, candidaturaId. O evento traz só ids, nunca o perfil nem as respostas. Só o DISC publica evento: cultura, psicossocial, OLBI e DASS21 são levantamentos coletivos ou dados de saúde, e dizer quem respondeu já seria expor.

Pelo seu agente de IA

“Quem do time de Vendas ainda não fez o DISC? Envie o convite com prazo de uma semana.”

O agente consulta os pendentes e, com escopo de escrita, cria os convites — o seu cliente de IA pede aprovação antes. Somente leitura, ele lê e compara perfis DISC. Veja Escrita e segurança.

Cuidados

• Um convite vigente por tipo. Se a pessoa (ou a candidatura) já tem convite pendente e no prazo para um tipo, criar outro responde 400: reenvie o existente ou cancele-o (PUT /convite-questionario/{id}/cancelar). Convite vencido não bloqueia.
• E-mail e CPF. O convite vai para o e-mail cadastrado; sem e-mail válido a pessoa não recebe o link. Confira statusEmail na listagem.
• ultimo-questionario responde 404 quando a pessoa ainda não respondeu aquele tipo.
• DISC é apoio à decisão. Use o perfil como insumo de conversa e desenvolvimento, nunca como critério eliminatório automático.
• Datas como yyyy-MM-dd — veja Datas e formatos.