Levar a pesquisa de clima para o BI

A pesquisa de clima organizacional roda na TAI: o RH abre um ciclo, cada pessoa do público recebe um convite pessoal por e-mail e responde de forma anônima, e no encerramento a plataforma calcula a favorabilidade por dimensão, o eNPS e os resultados por área. A integração típica leva esses números para o BI — ao lado de turnover, absenteísmo e desempenho — e acompanha a adesão enquanto o ciclo está aberto.


Quando usar	Painel de clima no BI, cruzamento de clima com outros indicadores, acompanhamento de adesão por área
Porta	REST · Webhook assinando eventos · Agente (MCP)
Você vai precisar	Módulo `PESQUISAS`; permissão `CLIMA`; token JWT de um usuário de integração

Como funciona

RH (ou seu sistema) ── POST /clima/campanha ─────────▶ TAI  (ciclo em RASCUNHO)
                    ── POST /clima/campanha/{id}/lancar ▶ TAI  (convites por e-mail, coleta aberta)
colaboradores ── respondem pelo link pessoal, anônimos ──▶ TAI
seu BI ── GET /clima/participacao/campanha/{id}/adesao ──▶ TAI  (adesão durante a coleta)
prazo vence ── rotina clima-ciclo encerra e calcula ──────▶ resultado materializado
TAI ── webhook: CLIMA_CAMPANHA_ENCERRADA (campanhaId) ────▶ seu BI
seu BI ── GET /clima/resultado/campanha/{id} ─────────────▶ TAI  (geral, por área, item a item)

O ciclo passa por RASCUNHO → PUBLICADA (em coleta, pode ser PAUSADA) → ENCERRADA. O resultado só existe depois do encerramento.

Passo a passo

Crie o ciclo — ou deixe o RH criar em Desempenho → Clima organizacional → Ciclos de clima → Novo ciclo e pule para o passo 3.
```
POST /clima/campanha
Authorization: Bearer $TAI_TOKEN
Content-Type: application/json

{
  "titulo": "Clima 2026",
  "tipo": "CENSO",
  "dataInicio": "2026-10-13",
  "dataFim": "2026-10-31",
  "publicoTipo": "GERAL",
  "lembretesDias": "7,12",
  "lembrete48h": true
}
```
Sem instrumento informado, o ciclo recebe uma cópia do modelo padrão da plataforma; GET /clima/campanha/modelos lista os modelos e modeloId escolhe outro. tipo é CENSO (instrumento completo) ou PULSE (pesquisa curta). publicoTipo pode restringir o público a um SETOR, DEPARTAMENTO ou SUBDEPARTAMENTO, com publicoId.
Confira o público e lance.
```
GET /clima/campanha/18/previa-publico
POST /clima/campanha/18/lancar
```
Lançar congela o instrumento, convida cada pessoa do público por e-mail e abre a coleta.
Acompanhe a adesão.
```
GET /clima/participacao/campanha/18/adesao
```
Traz convidados, respondidos, pendentes, dispensados, adesaoPct, diasRestantes e atingiuMinimo. A lista nominal (GET /clima/participacao/campanha/18) diz quem respondeu, nunca o quê.
Saiba quando o resultado sai. O encerramento — pelo botão, pela API ou pela rotina no fim do prazo — calcula o resultado e publica Uma pesquisa de clima é encerrada (CLIMA_CAMPANHA_ENCERRADA). Assine-o num webhook, e o BI lê o resultado assim que ele existe:
```
{
  "id": "evt_64012",
  "tipo": "CLIMA_CAMPANHA_ENCERRADA",
  "descricao": "Uma pesquisa de clima é encerrada",
  "versao": 1,
  "ocorridoEm": "2026-11-01T09:00:14.602Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "campanhaId": 18,
    "titulo": "Clima 2026",
    "totalConvidados": 412,
    "totalRespondidos": 327
  }
}
```
O evento traz só contagens, nunca respostas. Uma pesquisa de clima é lançada (CLIMA_CAMPANHA_LANCADA) avisa o início da coleta.
Leia o resultado depois do encerramento.
```
GET /clima/resultado/campanha/18
```
O resultado geral traz n, favoravelPctGeral, mediaGeral, enps (com promotores, neutros e detratores) e as dimensoes, cada uma com sua favorabilidade.
Abra por área. Uma linha por recorte de um nível — a base de um mapa de calor:
```
GET /clima/resultado/campanha/18/nivel/DEPARTAMENTO
```
nivel é SETOR, DEPARTAMENTO ou SUBDEPARTAMENTO. Para um recorte só, use GET /clima/resultado/campanha/18/recorte?nivel=DEPARTAMENTO&id=40; para o resultado de cada pergunta, GET /clima/resultado/campanha/18/itens (com os mesmos filtros e, opcionalmente, secaoId para uma dimensão).

Anonimato

A regra é do servidor e vale para a tela, para a API e para o agente:

A resposta não guarda quem respondeu. A participação (convidado, respondeu, dispensado) e a resposta ficam separadas.
Mínimo de respostas por recorte: nminimo, 5 por padrão e nunca menos que 5. Um recorte com menos respostas vem com suprimido: true e motivo: "N_MINIMO", sem números, e nivelDisponivel aponta o recorte acima que pode ser lido.
Complemento: um recorte também é suprimido (motivo: "COMPLEMENTO") quando exibi-lo permitiria deduzir, por subtração, o resultado de um grupo pequeno ao lado.
Comentários só aparecem em recortes com ao menos nminimoComentarios respostas com texto (10 por padrão).
Em coleta não há resultado: antes do encerramento, as rotas de resultado respondem suprimido: true com motivo: "EM_COLETA".

O resultado geral do ciclo sempre aparece; com menos respostas que o mínimo, ele vem marcado com abaixoDoMinimo: true.

Os comentários abertos têm uma síntese por IA: GET /clima/resultado/campanha/{id}/sintese devolve a última gerada (sem custo) e se dá para gerar; POST na mesma rota gera, agrupando os comentários em até seis temas, com a contagem feita por regra, não pela IA. Ela só existe para o ciclo inteiro, encerrado, e com comentários de ao menos nminimoComentarios pessoas.

Automatize

Rotina	O que faz	Começa ligada?
Ciclo do clima (`clima-ciclo`)	Todo dia de manhã, encerra o ciclo cujo prazo acabou — o resultado sai sozinho — e lembra quem não respondeu nos dias de `lembretesDias` (contados do lançamento) e 48 horas antes do fim	Não — a empresa liga na Central

Com a rotina desligada, o ciclo fica em coleta até alguém encerrar: na tela, Encerrar e calcular, ou POST /clima/campanha/{id}/encerrar. Lembretes avulsos: POST /clima/participacao/campanha/{id}/enviar-lembretes.

Pelo seu agente de IA

“Como ficou a favorabilidade por departamento no Clima 2026? Quais dimensões caíram em relação ao ciclo anterior?”

O agente lê o resultado com as mesmas regras de anonimato — recortes suprimidos chegam suprimidos. Veja Ferramentas.

Cuidados

Encerrar é definitivo: o resultado é calculado uma vez, no encerramento, e todo leitor recebe o mesmo conjunto. Um ciclo encerrado não volta a coletar.
Depois de lançado, só título, mensagens, data de fim e lembretes mudam (PUT /clima/campanha); o instrumento fica congelado para que os ciclos sejam comparáveis.
O link de resposta é pessoal e de uso único, enviado por e-mail. Reenviar o convite (POST /clima/participacao/{id}/reenviar) gera um link novo.
Datas do ciclo são dias do calendário: envie yyyy-MM-dd — veja Datas e formatos.

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