User, Bot, and Human Color Roles (Free vs Pro)

1. Message Roles in Davix AI Engine #

Your docs distinguish three logical roles in chat:

• User – the site visitor sending messages.
• Bot – the AI assistant (OpenAI).
• Human (Pro) – human agents responding via Telegram handoff.

Each role can be visually distinguished by text color and bubble background.

2. Free: User & Bot Colors #

In Free, the documented color options include:

• light_user_text, light_bot_text
• dark_user_text, dark_bot_text

There are no *_human_* colors applied in Free, because human handoff is Pro-only.

Step-by-step:

1. Set user text colors in light and dark themes:
   • light_user_text
   • dark_user_text
2. Set bot text colors:
   • light_bot_text
   • dark_bot_text
3. Save and test a conversation in both themes.

3. Pro: Human Message Colors #

Pro adds human-specific fields:

• light_human_text
• light_human_bubble_bg
• dark_human_text
• dark_human_bubble_bg

These are used when Telegram live chat / human handoff is enabled and active.

Step-by-step:

1. In Theming section, locate human message colors.
2. For light theme:
   • Set light_human_text (text color of human messages).
   • Set light_human_bubble_bg (bubble background).
3. For dark theme:
   • Set dark_human_text.
   • Set dark_human_bubble_bg.
4. Save changes.
5. Enable human handoff in Telegram integration (described in that module’s docs).
6. Test AI + Human chat mode from front-end and confirm human messages appear with the configured colors.

image IMAGE PLACEHOLDER: Screenshot of chat with three visually distinct message colors: user, bot, and human agent messages. IMAGE image

4. Pro Licensing Behavior #

Your documentation clarifies that:

• All Pro-only options are gated by my_fs()->can_use_premium_code().
• sanitize_options() ignores or clears Pro-only keys if no license is active.

So:

• If you try to set *_human_* colors in Free, they will not be applied; those values are discarded or ignored.
• Once Pro is activated, these fields become usable and are saved correctly.