From a lesson page, administrators can create lessons from scratch, modify custom lessons, or clone existing lessons, as well as manually send lessons.
NOTE: the screenshots in this article are indicative of the current interface version and will be updated shortly.
When you open a lesson, you see the published version in read-only mode. The following actions are available from the toolbar:
- Edit content / See current version: toggles between the lesson editor (available only for custom lessons) and the read-only view of the currently published content.
- Clone lesson: opens the editor on a copy of the current lesson (available for both custom lessons and those provided by Libraesva). Lessons provided by Libraesva cannot be edited directly: to adapt them, you must clone them and modify the copy owned by your company.
- Send now to: immediate sending, useful for testing the lesson or reaching specific users.
- Import JSON: imports content in JSON format.
Lesson Editor
The lesson editor is a sequence of interactions that you can delete or insert. It allows the administrator to modify the name and description of the lesson, as well as the sequence of interactions.
- Click Edit content on an existing lesson page to activate edit mode (when creating a lesson from scratch, the editor opens directly).
- Select the language to edit from the dropdown menu, or add a new translation with the + button.
- Insert, delete, and modify interactions.
Simple Interaction
Each interaction corresponds to a single chatbot message and can be of two types.
Text
A text message that can include personalization macros. Macros are inserted in the format {{variable_name}} (e.g., {{first_name}}) and are replaced with company and recipient data at the time of sending. The variables available in chatbot lessons are:
| Variable |
|---|
first_name |
last_name |
company_name |
ceo_first_name |
ceo_last_name |
hr_director_first_name |
hr_director_last_name |
company_domain |
NOTE: CEO macros ({{ceo_first_name}}, {{ceo_last_name}}) require that the company has the CEO field set: a lesson using them cannot be assigned to a company without a configured CEO. HR Director macros use a default value instead and do not block assignment.
Image
To display a GIF or image, select the img type and enter a public URL. You can use online hosting services such as imgbb.com or imghippo.com.
Interactions with Answers
You can add answers to make the lesson more interactive and for final score calculation. The text of each answer can contain a maximum of 75 characters. There are two types of interactions with answers:
- Not rated — when no answer is marked as correct. It serves to engage the user during the lesson and does not affect the final score.
- Rated — the interaction must have multiple answers, with one marked as correct (the Correct field). It affects the user's final score.
The Reaction is optional and is shown to the user based on the answer chosen. If no reaction is provided, the chatbot moves to the next interaction.
Saving Changes
All changes in the editor are automatically saved as a draft. Lessons with unpublished changes (drafts) are marked with a red dot. Changes are not applied until the administrator clicks Deploy changes.
The latest changes to the English lesson have not been published.
When you click Deploy changes, you can choose whether to publish only the current language (Publish this language only) or all existing drafts (Publish all existing drafts). Publishing promotes the draft to the active version: the draft becomes the published lesson and does not remain a separate editable draft until you click Edit content again. The previous version is retained but replaced.
JSON Import
Awareness lessons can be imported via JSON, with one file per language (max 5 MB each). Below is a guided example:
{
"language": "fr",
"name": "✔ Pourquoi la cybersécurité est-elle importante ?",
"description": "Cette introduction explique pourquoi le risque cyber constitue plus que jamais une menace pour les entreprises et donne quelques exemples d'attaques qui ont eu lieu sur des entreprises françaises.",
"interactions": [
{
"content": "Texte avec 1 réponse de l'utilisateur",
"type": "txt",
"answers": [
{
"content": "réponse de l'utilisateur",
"reaction": "réponse du bot",
"is_correct": false
}
]
},
{
"content": "question à choix multiple qui ne compte pas pour le quizz",
"type": "txt",
"answers": [
{
"content": "choix 1",
"reaction": "réaction du bot",
"is_correct": false
},
{
"content": "choix 2",
"reaction": "réaction du bot",
"is_correct": false
}
]
},
{
"content": "Texte sans interaction",
"type": "txt",
"answers": []
},
{
"content": "{url d'un gif ou d'une image (sera affiché directement)}",
"type": "img",
"answers": []
},
{
"content": "QCM qui compte pour le quizz",
"type": "txt",
"answers": [
{
"content": "réponse 1",
"reaction": "mauvaise réponse",
"is_correct": false
},
{
"content": "réponse 2",
"reaction": "mauvaise réponse",
"is_correct": false
},
{
"content": "réponse 3",
"reaction": "mauvaise réponse",
"is_correct": false
},
{
"content": "réponse 4",
"reaction": "bonne réponse!",
"is_correct": true
},
{
"content": "réponse 5",
"reaction": "mauvaise réponse",
"is_correct": false
}
]
},
// ... (continuer la même logique)
]
}
When at least one answer has the is_correct field set to true, the interaction is counted for quiz scoring purposes (set all to false for unrated interactions).
Send a Lesson Immediately
With the Send now button, the administrator can send content at any time to the entire company or part of it. This action cancels any ongoing progress users may have on their lessons and sends a notification.
Creating a Lesson with AI
Creating a lesson with AI allows administrators to automatically generate a complete conversational awareness lesson from a source document (PDF or Word) using AI. The administrator uploads a document, optionally provides a prompt to guide tone or focus, and receives a ready-to-edit lesson within a few minutes.
From the lesson catalog, click Create lesson with AI to open the generation window.
Input Data
- required — source document (PDF or Word)
- Document quality matters: the more structured and clear the document, the better the generated lesson. Short and well-organized documents tend to produce the best results.
- Very long documents may not be fully covered: the AI focuses on the most relevant sections. You can use the optional prompt to direct focus to specific parts.
- optional — text prompt to guide the AI (e.g., adjust tone, focus on specific topics, specify a language)
- Prompt suggestions: use the optional prompt to specify tone ("professional", "informal"), focus areas ("focus on section 3") or language ("generate in Italian").
Submitting the Request
- After clicking the Generate button, generation takes a few minutes. When the lesson is ready for review, the administrator receives an email with a direct link to the editor.
Data and Privacy
Uploaded documents are processed by a third-party AI provider under contractual data protection terms. Only the uploaded file and the free text of the prompt reach the processing phase: no company identifier is sent. The email address of the administrator initiating generation is used solely to send the completion (or error) notification. After each generation, the uploaded file and AI resources created to process it are explicitly deleted.
Reviewing the AI-Generated Lesson
Although AI produces good quality results, human review is recommended before publishing to users.
The result is a complete lesson (in draft state) with a quiz section, manageable like any other custom lesson.
🌎 The lesson is generated in the language of the source document. To force a different language, the administrator must specify it in the optional prompt (e.g., "Generate this lesson in Italian"). The lesson is not automatically translated into other languages.
Images are not handled by the service and must be added manually.