KODA.AI Docs

KODA.AI Docs

  • Web JS SDK

›Config

  • Quick Start
  • Config

    • User Profile
    • Locales
    • Advanced Configuration
  • Browser Compatibility
  • SDK Methods
  • Analytics
  • CSS Properties

Locales

SDK provides an easy way to translate UI based on user locale. User language is detected based on browser configuration. It can be overwritten by setting default_locale property in a settings object, or by updating a locale in user profile.

Example

<script>
    window.initKBWebSDK = function (SDK) {
        const bot = SDK.initKBChatbot({
            token: "TOKEN",
            locales: {
                pl_PL: {
                    promo_message: "Hej, napisz do mnie :)",
                },
                en_US: {
                    promo_message: "Hi, talk to me :)",
                },
            },
        });
    };
</script>

Default translation

{
    "promo_message": "👋 Chat with me",
    "get_started_button": "Get started",
    "get_started_message": "",
    "type_message_placeholder": "Your message",
    "clear_tooltip": "Delete conversation",
    "clear_alert_text": "Are you sure to delete conversation",
    "cancel_upload_alert_text": "Are you sure you want to cancel upload?",
    "cancel_upload": "Cancel upload",
    "clear_alert_btn_config": "Yes",
    "clear_alert_btn_cancel": "Cancel",
    "default_user_signature": "You",
    "feedback_helpfull_tooltip": "Chatbot helped me",
    "feedback_helpfull_chat_comment": "You rated chatbot as helpful",
    "feedback_unhelpfull_tooltip": "Chatbot didn't help me",
    "feedback_unhelpfull_chat_comment": "You rated chatbot as unhelpful",
    "moderator_in_queue": "Waiting in queue. Wait for agent.",
    "start_moderator_session": "Enable moderator mode",
    "archived_conversation": "The conversation has been archived",
    "end_moderator_session": "Disable moderator mode",
    "bot_status": "Online",
    "file_max_size": "Max file size is 10 MB",
    "file_max_size_large": "Max file size is 100 MB",
    "file_invalid_file_type": "Invalid file type",
    "file_invalid_file_type_desc": "Supported: mp3, pdf, gif, png, jpg",
    "file_dropzone": "Drop the file here",
    "file_uploading": "Uploading file:",
    "voice_listening": "Listening",
    "voice_speaking": "Speaking",
    "voicebot_tooltip_enable": "Turn on voice to speak with bot",
    "voicebot_tooltip_disable": "Turn off voicebot",
    "microphone_permistion_denied": "Access to microphone is denied",
    "microphone_permistion_denied_desc": "Do you accept permission in browser?",
    "show_type_message_input": "Show message input",
    "hide_type_message_input": "Hide message input",
    "promo_message_close": "Close",
    "promo_message_header": "Need help?",
    "enable_voicebot_msg": "To use all features of our voicebot, turn on it's voice",
    "enable_voicebot_header": "Voicebot",
    "error_send_message": "An error occurred while sending a message",
    "error_send_message_retry": "Retry",
    "sending_message": "Sending...",
    "error_internet_reconnect": "Reconnecting...",
    "character_limit_left": "Number of characters to use",
    "download": "Download",
    "queue_position": "One of our representatives will be with you shortly. You are number {{position}} in the queue.",
    "submit_feedback_btn": "Submit",
    "submit_feedback_msg": "Thank you for you feedback",
    "submit_feedback_placeholder": "Message (optional)",
    "submit_feedback_feedback_required": "Feedback required",
    "assigned_agent": "Assigned agent",
    "feedback_submitted": "The survey was completed correctly",
    "sources": "Sources",
    "persistent_menu_btn": "Chatbot Menu",
    "file_upload_btn": "Upload file",
    "voicebot_recording_enable": "Enable microphone",
    "voicebot_recording_disable": "Disable microphone",
    "toggle_button": "Toggle Chatbot"
}

Supported locales

If You want to use a different locale- no problem. Remember only to add translations in locales property. If SDK doesn't find a translation string, It will use text from en_US locale.

  • cs_CZ
  • en_GB
  • en_US
  • es_ES
  • hu_HU
  • pl_PL
  • ro_RO
  • ru_RU
  • sk_SK
  • uk_UA
← User ProfileAdvanced Configuration →
  • Example
  • Default translation
  • Supported locales
Copyright © 2025 KODA sp. z o.o . Questions? Sent message to developers@koda.ai