Sondages

L'API publique permet de consulter les sondages actifs et de recuperer les reponses collectees. La creation et la gestion des sondages se font via le dashboard.

L'objet Survey

{
  "id": "64d4e5f6789012345678901a",
  "boardId": "64a1b2c3d4e5f6789012345a",
  "title": "Satisfaction produit",
  "type": "nps",
  "status": "active",
  "questions": [
    {
      "id": "64d4e5f6789012345678901b",
      "text": "Sur une echelle de 0 a 10, recommanderais-tu notre produit ?",
      "type": "scale",
      "required": true
    },
    {
      "id": "64d4e5f6789012345678901c",
      "text": "Qu'est-ce qui pourrait etre ameliore ?",
      "type": "text",
      "required": false
    }
  ],
  "targeting": {
    "percentage": 50
  },
  "responseCount": 127,
  "createdAt": "2024-02-01T10:00:00.000Z",
  "updatedAt": "2024-03-15T08:00:00.000Z"
}

Champ	Type	Description
`id`	`string`	Identifiant unique du sondage.
`boardId`	`string`	Board associe.
`title`	`string`	Titre du sondage.
`type`	`string`	Type : `nps`, `csat`, `pmf`, `open` ou `poll`.
`status`	`string`	Statut : `draft`, `active`, `paused` ou `closed`.
`questions`	`array`	Liste des questions.
`targeting`	`object`	Configuration de ciblage (pourcentage, attributs).
`responseCount`	`integer`	Nombre total de reponses.

L'objet Question

Champ	Type	Description
`id`	`string`	Identifiant de la question.
`text`	`string`	Texte de la question.
`type`	`string`	Type : `rating`, `scale`, `single_choice`, `multiple_choice` ou `text`.
`options`	`array`	Options de choix (pour `single_choice` et `multiple_choice`).
`required`	`boolean`	Si la reponse est obligatoire.

Lister les sondages

GET/api/v1/surveys