Guide

Construire un questionnaire.

Un questionnaire pose des questions, additionne des scores, et rend un résultat. Deux façons de le rendre : un profil gagnant avec sa page, ou un portrait complet, dimension par dimension. Ce guide prend les deux, de la première question à la mise en ligne.

Le principe : des poids et des profils

Chaque réponse donne des points à un ou plusieurs profils. Le score d'un profil est la somme des points des réponses choisies. Ce que le visiteur voit ensuite dépend du mode de résultat.

Question : « Face à un projet nouveau, vous… »
• foncez sans attendre → { "curiosite": 3 }
• prenez le temps de planifier → { "structure": 3 }
• demandez l'avis de l'équipe → { "accord": 2, "structure": 1 }

Une mention de précaution — « ce questionnaire n'est pas un diagnostic » — peut s'afficher avant la première question, dans les deux modes.

Mode « profil » : un gagnant, une page

C'est le mode par défaut. Un seul profil est retenu, et le visiteur arrive sur la page de résultat de ce profil — une page ordinaire, que vous composez dans l'éditeur.

  1. Les combinaisons désignent le gagnant. Chacune pose des critères (« curiosité ≥ structure », « élan ≥ accord »…) ; la première dont tous les critères sont vrais l'emporte.
  2. À défaut, le score global. Un profil peut être attribué quand la somme de tous les scores tombe dans une fourchette : de 0 à 20, de 20 à 40…

Rangez les pages de résultat dans une catégorie à part : elles n'ont pas à apparaître dans le menu.

Mode « dimensions » : un portrait complet

Le visiteur ne reçoit pas un profil : il les reçoit tous, chacun avec le texte qui correspond à son score. La page de résultat se compose toute seule ; il n'y en a aucune à créer.

  1. Chaque profil devient une dimension, affichée comme une barre sur l'échelle du questionnaire — de 0 à 18, par exemple —, avec ses deux pôles aux extrémités et sa couleur.
  2. Trois tranches par dimension : bas, milieu, haut, bornes incluses (0–6, 7–11, 12–18). Chacune a son titre, son texte, et si vous le souhaitez des forces, un point de vigilance et une piste.
  3. En tête, la ou les dimensions les plus éloignées du milieu de l'échelle. Les autres suivent, dans l'ordre que vous avez choisi.
  4. Profil nuancé : si toutes les dimensions tombent dans leur tranche du milieu, aucune n'est mise en avant et un texte dédié ouvre la page.
  5. En bas, un texte final et un bouton — vers votre prise de rendez-vous, par exemple.

Aucun pourcentage, aucune comparaison avec d'autres répondants : le résultat parle de la personne, pas d'une moyenne.

Une dimension et ses tranches, par l'API

PATCH /api/agent/v1/profils/31/
{ "rang": 1, "couleur": "#2F6F8F",
"pole_bas": "Cap sur l'éprouvé", "pole_haut": "Cap sur le neuf",
"tranches": {
"bas": { "de": 0, "a": 6, "titre": "Cap sur l'éprouvé", "texte": "…",
"forces": ["…", "…"], "vigilance": "…", "piste": "…" },
"milieu": { "de": 7, "a": 11, "titre": "Entre les deux", "texte": "…" },
"haut": { "de": 12, "a": 18, "titre": "Cap sur le neuf", "texte": "…" } } }

Simuler avant de publier

Inutile de répondre vingt fois au questionnaire pour voir chaque cas. La simulation reçoit des scores et dit ce que verrait le visiteur : qui passe en tête, quelle tranche s'affiche pour chaque dimension, et quel score ne tomberait dans aucune tranche. Rien n'est enregistré.

POST /api/agent/v1/questionnaires/7/simuler/
{ "scores": { "curiosite": 15, "structure": 9, "elan": 3,
"accord": 8, "tensions": 10 } }

Testez au moins trois cas : une dimension en tête, une égalité, tout au milieu. Puis mettez le questionnaire en ligne : il naît inactif, c'est à vous de l'activer.

Le style

Chaque questionnaire a le sien, qui habille les questions et la page de résultat : police, couleur principale, fond, titres, tailles par appareil, arrondis des réponses et du bouton. Reprenez la palette du site : le questionnaire doit ressembler au site qui l'héberge.

PATCH /api/agent/v1/questionnaires/7/
{ "style": { "couleur_theme": "#2F6F8F", "couleur_fond": "#F7F4EF",
"police": "Inter, sans-serif", "arrondi_bouton": 8 } }

Les questionnairesLe faire construire par Claude