Recursos técnicos

Integrar com o Portal DeHu

O que é público, o que é combinado caso a caso e o que não existe. Sem promessa de capacidade que a plataforma não tem hoje.

Não existe API pública de auto-serviço para operar a conta

Não há API REST aberta para criar convite, ler resposta ou gerar relatório, nem OAuth, chave emitida por conta própria ou portal de desenvolvedor. O portal recebe webhooks dos provedores de pagamento e e-mail; ele não emite webhooks para clientes. Integração de máquina existe, é liberada caso a caso por contrato, com credencial emitida pela DeHu e escopo definido em acordo. Fale com a gente para pedir uma.

A exceção é só leitura: o catálogo de testes, planos e preços responde em JSON, sem chave, em /api/publico/catalogo, descrito na especificação OpenAPI 3.1.

O que o Portal DeHu é, em termos de sistema

Aplicação web para aplicar testes comportamentais (DISC e Eneagrama) e para inventariar riscos psicossociais da NR-1. O relatório do DISC tem 53 páginas e o do Eneagrama, 67; a resposta leva 15 e 20 minutos, respectivamente.

O cálculo é determinístico e auditável, escrito em TypeScript: as mesmas respostas produzem sempre o mesmo retrato. Inteligência artificial não calcula nada — quando participa, é só para redigir sobre números já prontos.

Como os dados entram e saem

Entrada

· Convite por campanha ou link avulso, criado no portal.
· Importação de respondentes por CSV.
· Integração de máquina, sob acordo.

Saída

· Exportação em CSV pelo portal.
· PDF do relatório e link de resultado do respondente.
· Exportação programática para integrações contratadas, liberada caso a caso.

Contratos de URL

Os endereços que já são públicos

Estes formatos já circulam impressos em PDF, em QR code e em e-mail. Em todos, o código na URL é a própria autenticação: são links pessoais, expiram, podem ser revogados e não devem ser indexados nem colados em canal público.

Formato	O que é	Quem recebe
/a/disc?invite=CODE	Responder o DISC por convite pessoal	Quem recebe: o respondente
/a/eneagrama?invite=CODE	Responder o Eneagrama por convite pessoal	Quem recebe: o respondente
/nr1/TOKEN	Avaliação psicossocial anônima da empresa	Quem recebe: toda a equipe
/resultado/TOKEN	Página de resultado do respondente	Quem recebe: o respondente
/verificar/CODIGO	Conferência pública do QR impresso no relatório	Quem recebe: qualquer pessoa
/p/TOKEN	Proposta comercial com aceite	Quem recebe: o prospect

Vocabulário

O modelo de dados que o cliente enxerga

Os cinco termos que respondem quase toda pergunta sobre como o portal se organiza.

Organização: A conta que paga. Pode ter sub-organizações, uma por cliente atendido, cada uma com saldo e escopo próprios.
Acesso: Uma pessoa que entra no portal. É o eixo do preço do plano — não o teste.
Crédito: Uma aplicação de teste. Comprado por volume e consumido no envio do convite.
Convite: O direito de uma pessoa responder um teste, com código próprio e prazo de validade.
Resposta e resultado: O que a pessoa respondeu e o retrato calculado a partir disso, guardado de forma canônica e recalculável.

NR-1

O que o portal faz, e o que continua sendo de profissional habilitado

O portal faz

· Coleta anônima por setor, com instrumento adaptado do COPSOQ III e escala de 1 a 5.
· Inventário e relatório dos riscos psicossociais.
· Documentação da coleta, com data e setor.

O portal NÃO faz

· Não emite laudo. A interpretação formal e o laudo são de psicólogo ou médico do trabalho.
· DISC e Eneagrama não satisfazem a NR-1: são instrumentos de desenvolvimento, não de risco psicossocial.

Segurança e privacidade

Em nível de política, não de arquitetura

Isolamento por linha em todas as tabelas: cada organização alcança apenas os próprios dados.
Respostas da NR-1 são anônimas por desenho: não se coleta nome nem e-mail, e a resposta é gravada com o setor, não com a pessoa.
Links de resultado são revogáveis a qualquer momento e podem receber prazo de validade; no fluxo padrão nascem sem prazo e valem até serem revogados. Os PDFs ficam em armazenamento com acesso por link expirável.
Quando uma empresa aplica na própria equipe, ela é a controladora e a DeHu é operadora — a política detalha os dois regimes.

Para agentes e crawlers

Formatos legíveis por máquina

As páginas listadas no llms.txt respondem em Markdown: mande Accept: text/markdown na URL canônica, ou acrescente .md ao fim do endereço. As demais respondem só em HTML.

llms.txt

Índice do site para agentes, no formato llmstxt.org: o que existe, quando recorrer à DeHu e quando não.

catálogo em JSON

Testes, planos, preços e escada de crédito — os mesmos números de /precos. Somente leitura, sem chave.

openapi.json

Especificação OpenAPI 3.1 do catálogo e do formato de erro da pasta /api.

sitemap.xml

Mapa completo das páginas indexáveis, com data de modificação.

robots.txt

O que pode e o que não pode ser rastreado, e onde fica o sitemap.

Conferir por conta própria

curl -sI -H "Accept: text/markdown" https://portaldehu.com/precos
curl -s https://portaldehu.com/precos.md
curl -s https://portaldehu.com/llms.txt
curl -s https://portaldehu.com/api/publico/catalogo

As respostas em Markdown trazem Vary: Accept e um cabeçalho Link apontando para a versão canônica e para o llms.txt. Endereço inexistente devolve 404 com corpo em Markdown e os ponteiros de recuperação.

Roadmap

O que não existe, dito com todas as letras

API pública de operação e webhooks de saída não existem hoje e não têm data anunciada — o catálogo somente leitura é a única API aberta. Quem precisa integrar fala com a DeHu, e o escopo é definido no contrato.

Falar sobre uma integração