Como ler as respostas

As ferramentas da hackÜ não escondem nada, mas vários dos seus campos parecem dizer algo mais simples do que dizem. Esta página reúne os casos em que uma leitura apressada tira uma conclusão errada — todos verificados contra dados reais, não hipotéticos.

Uma pesquisa é compartilhada entre empresas

list_surveys devolve as pesquisas usadas pelos cursos da sua empresa, mas a pesquisa em si é um objeto compartilhado: a mesma pesquisa pode estar nos cursos de várias empresas ao mesmo tempo.

get_survey_results traz dois números por essa razão: responses (as da sua empresa) e responses_all_companies (todas). Um caso real: a pesquisa 679 tem 15.359 respostas de 6 empresas, e só 11.318 são da maior das seis. As porcentagens de cada pergunta são sempre calculadas sobre o primeiro número. Reportar o segundo como se fosse da sua empresa é reportar o resultado de outra.

Revisado não é aprovado

Em list_challenges, reviewed e approved são coisas diferentes: revisado significa que alguém olhou; aprovado, que passou. Um desafio revisado e não aprovado é uma recusa, não algo pendente — já está fechado. Contá-lo junto com a fila de pendentes infla o trabalho que falta.

Para “o que eu devo ao time”, filtre por reviewed=false, ou peça include_summary=true para ter o detalhamento completo em uma única consulta.

“Sem evidência” não é “não chegou”

list_communication_deliveries devolve marcadores por provedor (whatsapp_sent, whatsapp_delivered, whatsapp_read, whatsapp_failed, sms_sent) que não são excludentes entre si: o provedor levanta um sem baixar os outros, então a mesma linha pode acabar marcada de várias formas ao mesmo tempo.

Números reais, de uma única campanha

• 39.151 linhas estão falhadas e entregues ao mesmo tempo.
• 66.854 linhas estão falhadas e lidas ao mesmo tempo.
• 69.535 linhas estão lidas sem terem sido entregues.

no_evidence — o processo de envio fechou e o provedor nunca reportou nada, nem sucesso nem falha — costuma ser o maior grupo de todos. Não é o mesmo que failed, e não é o mesmo que entregue.

Os grupos se sobrepõem: somá-los não dá o total de destinatários. Só recipients (com include_breakdown=true) é um total real. E subtrair falhas dos envios, a fórmula que o painel usa, também não é uma taxa de entrega real — a própria ferramenta diz isso na sua descrição.

Vagas: acima de 9.999 não há limite configurado

get_company_overview reporta membership.unlimited_seats. Quando é true, o número de vagas guardado no banco é um preenchimento, não um plano — não o cite como se fosse o limite real da empresa.

Progresso de 0% em um pensum sem cursos não significa “não começou”

get_pensum calcula enrolment.average_progress a partir dos cursos que o pensum tem configurados. Um pensum sem cursos mantém o último valor que tinha guardado em vez de recalcular — então um 0% ali pode significar “nada configurado”, não “ninguém começou”. Confira pensum.courses antes de ler o número.

has_progress_data: false é desconhecido, não zero

Em list_users e get_user, quando a hackÜ ainda não calculou o avanço de uma pessoa, has_progress_data vem como false e o status é no_data. Isso é desconhecido, não 0% de avanço — são afirmações diferentes, e a segunda é uma acusação que os dados não sustentam.

Passar em uma avaliação depende da avaliação

passed, em list_evaluation_attempts e get_evaluation_attempt, é o veredito da plataforma conforme a nota mínima daquela avaliação em particular. Alguém pode acertar 4 de 5 perguntas e não passar se aquela avaliação pedisse mais. Não dá para recalcular passed contando acertos — é preciso ler do campo.