Skip to main content
The Questions tab is where you define every question the NBQ Engine can return. The engine selects from this bank based on the conversation so far and your behaviour configuration.

​
Adding questions

Question categories with priority order in the Zelinqa NBQ Studio
Click Import questions to load many questions at once:
  1. Download the provided template.
  2. Fill in your questions. Only the questions column is mandatory. An optional categorie column lets you assign categories — empty means the default category, and new categories are created automatically.
  3. Upload the file (CSV, up to 2 MB). Imported questions are active by default. Duplicates already present are skipped and reported.

​
Question fields

FieldDescription
Question textThe wording shown to users. The NBQ Engine may refine phrasing at runtime to match your chosen tone.
CategoryThe group this question belongs to (see below).
Active / InactiveOnly active questions are eligible to be returned by the engine. Deactivate without deleting to pause a question.

​
Categories and priority order

A category groups questions that aim to collect the same piece of information — for example, budget, timeline, or use case. By default all categories have equal importance. You can optionally define a priority order by ranking categories top to bottom. The engine then prioritises collecting higher-ranked categories first. You can reorder with the ↑ ↓ controls next to each category, or reset to equal priority at any time.

​
Auto-organise with AI

Questions list in the Zelinqa NBQ Studio
Click Catégoriser automatiquement to let NBQ automatically sort your uncategorised questions into coherent groups. Importantly, it also establishes a priority order for those categories at the same time — ranking them from highest to lowest so the engine targets higher-priority categories first. Review the result and adjust any category or order as needed. Use Ajouter une catégorie to create a group manually, and the ↑ ↓ arrow controls to move categories up or down and set the priority order as you wish. Use Réinitialiser l’ordre to return all categories to equal priority at any time.
Auto-organise only touches questions still in the default category. Anything you have already organised is left untouched. It also sets an initial priority order for the categories it creates — you can freely reorder them afterwards using the ↑ ↓ arrows next to each category. It is the fastest way to finish setup right after a CSV import.

​
How answered questions are tracked

Your application sends the answered_question_ids list with every API request. The engine automatically excludes any question whose external_id appears in that list — it never repeats a question. The engine does not store which questions have been answered. Your application owns that state and sends it with each call — this is what makes the API stateless.