Configuring the Linguineo conversation component

Introduction

The Linguineo Conversation Player is a powerful HTML component that embeds AI-driven conversational language learning into your LMS or digital learning environment. It enables real-time, interactive practice for learners with detailed feedback and flexible configurations. Organizations such as educational publishers or language schools can customize the player to fit their pedagogical goals and technical setup.

You embed the player as a custom HTML tag:

<linguineo-conversation ... ></linguineo-conversation>

This documentation provides a detailed overview of all the configuration options available, grouped by functional area.

1. Connection Configuration

These properties manage how the player connects to the Linguineo back end.

connection-config

JSON object specifying backend paths. Change only if you received custom endpoints or use a proxy.

2. Authentication

Defines how the user is authenticated with the Linguineo platform.

auth-method	Authentication method. Use `"bearer"` in most cases. Options: `bearer`, `default`, `none`.
access-token	The (bearer) token received from your identity provider.
user-id	Only relevant if using `"default"` authentication. Not needed for `bearer`.

3. Content Selection

These properties determine the language and scenario used during the conversation.

language	ISO 639-1 code of the learning language (e.g., `"fr"` for French).
`tutor-language`	ISO 639-1 code for the user’s tutor language (e.g., `"nl"` for Dutch).
application	App identifier. Set this only if provided by Linguineo.
scenario-id	Unique ID identifying the scenario for the conversation.
scenario-tag	Alternative to `scenario-id`. Requires pairing with `language`. Ignored if `scenario-id` is set.

4. Answering

Controls how learners provide answers during conversations.

answer-type User response method. Options: MULTIPLE_CHOICE, WRITING, SPEAKING, WRITING_AND_SPEAKING, SPEAKING_WITH_INTERMEDIATE_WRITING.

5. Feedback

Customizes the kind and depth of corrective feedback shown to learners.

`show-feedback-in-conversations`	Toggle all types of feedback.
inline-feedback	Show feedback inline (always visible) or as a toggle.
`show-pronunciation-feedback`	Show basic pronunciation feedback.
do-additional-pronunciation-analysis	Enable deep pronunciation analysis.
show-simple-corrective-feedback	Show brief, non-metalinguistic corrections (instead of more complicated metalinguistic ones).
additional-corrective-feedback	Enable extensive grammar feedback.
`enable-contextualized-grammar-corrections`	Add semantic/contextual insights to feedback.

6. Support for the user

Determines which tools and support are shown to the learner during the conversation.

generate-hints-for-open-flow	Generate hints in open-ended flows.
show-translations-in-conversation	Show translations of utterances in the conversation.
allow-word-lookup	Enable users to tap/click on words in bot messages for translations.

7. Bot Behaviour

Manage the pacing, flow, and progression of conversations.

always-wait-for-bot-to-finish-speaking	If `true`, user must wait for bot to finish speaking before responding.
offer-to-let-bot-proceed-if-applicable	Allow bot to offer to continue when applicable.
automatic-progression-if-too-many-misses	Automatically move forward after multiple failed attempts.
show-full-bot-responses	Show bot’s internal interpretation and reasoning during task misses.
speaking-rate-of-bot	Determines how fast the bot speaks (0 to 2). Default (normal speed): `1`.

8. Speech Recognition

Fine-tunes how spoken responses are recognized.

speech-recognition-strategy	Strategy for interpreting speech. Options: `DEFAULT`, `AUTOCORRECT_TO_CONTEXT`. In case of AUTOCORRECT_TO_CONTEXT, the speech recognition heavily leans into recognizing something that fits the context.
forgiveness	Decimal value (0 to 1). Higher values make recognition lean toward expected answers. Default: `0.08`.

9. Difficulty

Adjusts challenge level based on learner performance.

switch-to-easier-based-on-frustration

Automatically lower difficulty after repeated errors.

10. Recordings

Control how user speech recordings are handled.

stop-recording-automatically-on-silence

Automatically stop recording after detecting silence.

11. UX Options

Configures user interface and interaction.

ui-theme	Theme of the interface. Default options: `light`, `dark`.
animated-reward-icons	Show a visual reward upon task completion.
sound-effects-enabled	Enable interface sound effects.
with-back-button	Add a back button to the player.
blinking-clues-enabled	Blink hints if user is inactive.
show-progress-bar	Display a progress bar during the conversation.
allow-corrections-by-user	Enable (expert) users to correct bot output.
bot-name	Custom name for the bot character.
user-photo-url	Custom URL for user portrait image.
bot-image-url	Custom URL for bot portrait image.

Example configuration

<linguineo-conversation
    access-token="{YOUR_TOKEN}"
    auth-method="bearer"
    bot-name="Anna"
    language="fr"
    tutor-language="nl"
    scenario-id="503"
    answer-type="SPEAKING_WITH_INTERMEDIATE_WRITING"
    show-pronunciation-feedback="true"
    show-simple-corrective-feedback="true"
    additional-corrective-feedback="true"
    ui-theme="dark"
    user-photo-url="https://example.com/user.svg"
    bot-image-url="https://example.com/bot.svg"
></linguineo-conversation>