Localization

To override SDK string resources, add them with the same name to your app's strings.xml — the Android Resource Merger will substitute the SDK value during the build. The file is located at res/values-<locale>/strings.xml (e.g., values-ru/ for the Russian locale; see Supporting different languages).

Default values

In the tables below, the "Default value" column shows the text from values-ru/strings.xml (the Russian locale). For other locales, the default value is the text from values/strings.xml (English) — for example, for ecc_push_title it is Threads, not ChatCenter; for ecc_empty_chat_placeholder_title — Welcome!, not Добро пожаловать.

Some keys are defined simultaneously in the chatcenter-core and chatcenterui modules (ecc_alert_timeout_message, ecc_chat_client_name, ecc_chat_title_waiting_for_specialist, ecc_error_when_history_load, ecc_errors_during_load_file, ecc_settings_not_loaded) — overriding in the app's strings.xml covers both copies thanks to the standard Android Resource Merger.

Reserved keys

Some keys are marked in the tables as "Reserved." — these keys are defined in the SDK's strings.xml, but there are no references to them (R.string.<key> / @string/<key>) in the chatcenterui/chatcenter-core modules' code. Overriding such keys in the app's strings.xml will have no effect on the UI until the SDK starts using them.

Localization keys

Actions and buttons

Key	Default value	Usage example / Notes	Usage
ecc_action_title_repeat	Повторить	SDK init retry button
ecc_action_title_cancel	Отмена	Cancel button while recording a voice message
ecc_action_title_yes	Да	Rating on response
ecc_action_title_no	Нет	Rating on response
ecc_permissions_access_allow	Разрешить	Permission request
ecc_permissions_close_dialog	Закрыть	Dialog close button
ecc_alert_resend_failed_ message_retry_btn	Повторить отправку	Message menu
ecc_alert_resend_failed_ message_delete_btn	Удалить	Message menu

Chat and titles

Key	Default value	Usage example / Notes	Usage
ecc_chat_title_working	Контакт центр	Chat title
ecc_chat_title_opened	Контакт центр	Title of an opened chat
ecc_chat_title_ waiting_for_specialist	Поиск оператора…	Waiting status in the toolbar
ecc_chat_title_typing	оператор печатает…	Typing indicator in the toolbar
ecc_chat_title_ unknown_operator	Неизвестный	Reserved. Intended — operator name when not provided by the server
ecc_chat_title_connecting	Подключение...	Toolbar title during automatic WebSocket reconnect
ecc_chat_client_name	Вы	User name (in quotes)
ecc_operator_bot	Бот	Bot name
ecc_chat_available_ readonly_text	Данный чат доступен только для просмотра	Read-only mode

Attachments menu

Key	Default value	Usage example / Notes	Usage
ecc_attachments_ menu_take_photo	Камера	Bottom menu item
ecc_attachments_ menu_my_albums	Галерея	Bottom menu item
ecc_attachments_menu_files	Файл	Bottom menu item

Messages and statuses

Key	Default value	Usage example / Notes	Usage
ecc_message_system_ leave_chat_female	покинула диалог в	Reserved. System (female)
ecc_message_system_ leave_chat_male	покинул диалог в	Reserved. System (male)
ecc_message_system_ join_chat_female	подключилась к диалогу в	Reserved. System (female)
ecc_message_system_ join_chat_male	подключился к диалогу в	Reserved. System (male)
ecc_message_system_ date_recently	Недавно	Message time
ecc_message_system_ date_yesterday	Вчера	Reserved. Intended — "Yesterday" timestamp
ecc_message_deleted_text	Сообщение удалено	Placeholder for a deleted message
ecc_message_system_ quote_content_descr	Цитата	For TalkBack

Input and recording

Key	Default value	Usage example / Notes	Usage
ecc_input_placeholder	Ваше сообщение…	Input field hint
ecc_input_voice_ recording_hint	Удерживайте, чтобы начать запись	Microphone hint
ecc_message_voice_ slide_to_cancel	Влево - отмена	Voice recording animation (swipe left to cancel)

Search

Key	Default value	Usage example / Notes	Usage
ecc_search_ placeholder_title	Поиск сообщений	Search input field
ecc_search_ not_found_title	Результатов не найдено	No messages found in search

Push notifications

Key	Default value	Usage example / Notes	Usage
ecc_push_title	ChatCenter	Notification title

Survey

Key	Default value	Usage example / Notes	Usage
ecc_survey_message_ ask_for_rate	Пожалуйста, оцените качество нашего сервиса	Survey title
ecc_survey_message_ thanks_title	Спасибо за вашу оценку	Thanks after the survey is completed
ecc_survey_thanks_ for_buttons_survey	Спасибо за участие в опросе	Thanks after the survey is completed
ecc_survey_item_ user_rate_header	Оценка решения вопроса	Header during the survey
ecc_survey_request_ close_thread_message	Специалист ответил на все ваши вопросы, продолжить консультацию?	Thread close dialog

Empty screen

Key	Default value	Usage example / Notes	Usage
ecc_empty_chat_ placeholder_title	Добро пожаловать	Welcome screen title
ecc_empty_chat_ placeholder_desc	Отправьте ваш вопрос	Welcome screen subtitle
ecc_empty_chat_ placeholder_subtitle	Инициализация клиента	Initialization loader
ecc_empty_chat_ loading_state	Загрузка	Loader text
ecc_restoring_state	Восстановление состояния…	Caption on the full-screen view the SDK shows if the chat is opened before initialization completes

Permissions

Key	Default value	Usage example / Notes	Usage
ecc_permissions_help	Помощь	Dialog title
ecc_permissions_ string_help_text	Отсутствуют разрешения.\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	General dialog text
ecc_permissions_camera_ and_write_external_ storage_help_text	Отсутствуют разрешения на Камеру и Память (Запись на внешнее хранилище).\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	General dialog text
ecc_permissions_write_ external_storage_ help_text	Отсутствует разрешение на Память (Запись на внешнее хранилище).\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	General dialog text
ecc_permissions_record_ audio_help_text	Отсутствует разрешение на Аудиозапись (Микрофон).\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	General dialog text
ecc_permissions_settings	Настройки	Navigation button
ecc_permission_description_ access_to_files_title	Разрешите приложению доступ к файлам на вашем устройстве	Permission request rationale
ecc_permission_description_ access_to_files_message	Это необходимо для отправки файлов	Permission request rationale
ecc_permission_description_ access_to_audio_ recording_title	Разрешите приложению записывать аудио	Permission request rationale
ecc_permission_description_ access_to_audio_ recording_message	Это необходимо для отправки голосовых сообщений	Permission request rationale
ecc_permission_description_ access_to_camera_title	Разрешите приложению снимать фото	Permission request rationale
ecc_permission_description_ access_to_camera_message	Это необходимо для отправки фото	Permission request rationale

Errors and alerts

Key	Default value	Usage example / Notes	Usage
ecc_alert_camera_ not_found	На Вашем устройстве не найдена камера	Reserved. Intended — error when no camera is available
ecc_alert_camera_ could_not_start_error	Не удалось запустить приложение камеры	Camera error
ecc_alert_file_sending_ denied_desc	Отправка файлов отключена на сервере	File send error (no permission)
ecc_alert_resend_failed_ message_desc	Сообщение не было отправлено	Toast on message send error
ecc_alert_text_ copied_message	Текст скопирован в буфер обмена	Notification on text copy
ecc_alert_history_loading_ message_when_search	Выполняется загрузка сообщений из истории, подождите завершения	Reserved. Intended — notification of message loading (e.g., during search)
ecc_alert_timeout_message	Превышен интервал ожидания для запроса	Full-screen error
ecc_alert_saving_logs	Сохраняем логи, пожалуйста, подождите	Message while saving logs after a shake gesture
ecc_errors_no_file_error	Файл удалён на сервере	Error
ecc_errors_check_connection	Проблемы с доступом в интернет, проверьте соединение	Network error
ecc_errors_message_not_sent	Сообщение не отправлено, проверьте настройки подключения	Send error
ecc_error_when_history_load	Ошибка при загрузке истории сообщений	Error
ecc_errors_not_allowed_ file_extension	Недопустимый формат файла	Error
ecc_errors_voice_ message_error	Ошибка обработки голосового сообщения	Error
ecc_errors_disallowed_ file_loading	Загрузка файла не выполнена. Не удалось проверить файл	Error
ecc_errors_timeout_ during_load_file	Не удалось завершить загрузку файла, истек таймаут.\nПопробуйте загрузить файл позже	Error
ecc_errors_unexpected_ error_during_load_file	Не удалось завершить загрузку файла.\nПопробуйте отправить файл позже	Reserved. Intended — error on an unexpected file upload failure
ecc_errors_during_load_file	Произошла ошибка при загрузке\nили проверке файла	Error
ecc_errors_when_chat_init	Ошибка при инициализации чата	Error
ecc_errors_request_failed	Не удалось выполнить запрос, попробуйте повторить	Error
ecc_settings_not_loaded	Не удалось загрузить настройки чата	Error
ecc_errors_load_config	Не удалось загрузить настройки вложений	Reserved. Intended — error loading attachment settings
ecc_errors_code_ from_400_to_500_title	Извините за неудобства, чат в данный момент недоступен. Пожалуйста, попробуйте позднее.	Reserved. Intended — global 4xx/5xx error
ecc_errors_library_not_init	ChatCenter SDK не инициализирован	Error
ecc_message_send_file_ limit_alert_message	Превышен размер файла (%1$d МБ)	Client-side size validation before send. Keep the %1$d placeholder — without it, the string will crash at runtime

Files and miscellaneous

Key	Default value	Usage example / Notes	Usage
ecc_attachments_ failed_to_open_file	Невозможно открыть выбранный файл	File open error
ecc_attachments_ saved_to_downloads	Сохранено в Загрузки	Successful image download on the full-view screen
ecc_attachments_ unable_to_save_file	Сейчас невозможно сохранить файл	Save error

Accessibility (TalkBack)

Key	Default value	Usage example / Notes	Usage
ecc_content_descr_ search_talkback_icon	Иконка поиска	Reserved. Intended — description of the search icon for TalkBack
ecc_content_descr_ operator_avatar	Аватар оператора	Element description. Not displayed in the UI. Part of the Android accessibility system (element voice-over)
ecc_content_descr_ play_button	Кнопка воспроизведения	Element description. Not displayed in the UI. Part of the Android accessibility system (element voice-over)
ecc_content_descr_ loading_animation	Загрузка	Element description. Not displayed in the UI. Part of the Android accessibility system (element voice-over)
ecc_content_descr_ error_image	Изображение с ошибкой	Element description. Not displayed in the UI. Part of the Android accessibility system (element voice-over)
ecc_content_descr_info_btn	Кнопка информации	Element description. Not displayed in the UI. Part of the Android accessibility system (element voice-over)

Additional keys

Below are the string resources defined in the SDK modules' strings.xml that are not included in the main categories above.

Module chatcenterui

Key	Default value (values-ru/)	Purpose
ecc_attachments_file_time_label_preposition	в	Preposition in a file time label ("saved at 12:30")
ecc_attachments_file_download	Загрузить	The "Download" action next to an attachment
ecc_message_system_quote_image	изображение	"image" label in a quote of a message with a picture
ecc_message_voice_title	Голосовое сообщение	Voice message title
ecc_message_photo	Фото	"Photo" label (e.g., in a quote of a message with a photo)
ecc_message_voice_is_processing	Голосовое сообщение обрабатывается	Voice message processing state
ecc_push_channel_name	Контакт центр	Android notification channel name (visible in system app settings)
ecc_survey_message_vote_from_title	из	The "of" word in the "4 of 5" survey rating scale
ecc_survey_popup_close	Закрыть	Survey popup close button
ecc_survey_popup_send	Отправить	Survey result submit button
ecc_survey_popup_textbox_hint	Ваш комментарий	Survey comment field hint
ecc_alert_back_camera_could_not_start_error	Не удалось запустить тыльную камеру	Reserved. Intended — error starting the back camera
ecc_search_files	Искать файлы	Reserved. Intended — file search title

Module chatcenter-core

Key	Default value (values-ru/)	Purpose
ecc_message_status_not_delivered	Не доставлено	Status of an undelivered message
ecc_attachments_download_media_description	ChatCenter	Source description when saving media to the system Downloads
ecc_attachments_bytes	Б	File size unit — bytes
ecc_attachments_kbytes	КБ	File size unit — kilobytes
ecc_attachments_mbytes	МБ	File size unit — megabytes
ecc_attachments_gbytes	ГБ	File size unit — gigabytes
ecc_attachments_tbytes	ТБ	File size unit — terabytes
ecc_alert_not_enough_space	Недостаточно места в памяти устройства	Error: not enough space
ecc_alert_file_restricted_type_error_during_load_file	Файл с таким расширением запрещен к загрузке	Server error: forbidden file type (code file.restricted.type)
ecc_alert_file_restricted_size_error_during_load_file	Размер файла превышает допустимое значение	Server error: file size limit exceeded (code file.restricted.size)
ecc_alert_file_not_found_error_during_load_file	Файл для загрузки не найден	Server error: file not found (code file.not-found)
ecc_errors_no_user_id	Пользователь не установлен, выполните авторизацию	Error: attempt to send a message without an authorized user
ecc_error_websocket	Ошибка при получении сообщения в чате	WebSocket error when delivering incoming messages