=== Rimoq ===
Contributors: rimoq ,  InfinitAtitude lda.
Tags: ai, chatbot, assistant, customer support, faq
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 1.4.1
Requires PHP: 7.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Добавьте на ваш сайт чат-бота на основе ИИ, который учится на вашем контенте WordPress и предоставляет ответы в реальном времени на вопросы посетителей.

== Description ==

Rimoq — это сервис чат-бота на основе ИИ, который помогает вашим посетителям быстро и эффективно находить информацию на вашем сайте. Он обучается на вашем контенте и предоставляет мгновенные ответы на вопросы пользователей.

С плагином Rimoq вы можете:

* Автоматически синхронизировать ваши записи и страницы WordPress с Rimoq
* Встраивать чат-бота Rimoq на ваш сайт с простой настройкой
* Предоставлять мгновенные ответы на вопросы ваших посетителей
* Улучшать пользовательский опыт и сокращать запросы в поддержку
* Отслеживать взаимодействия пользователей и получать понимание того, что ищут ваши посетители

Rimoq также поддерживает интеграцию с популярными платформами обмена сообщениями, такими как WhatsApp, Telegram, Facebook Messenger, Instagram, Discord и Slack — позволяя вашему ИИ-помощнику взаимодействовать с пользователями за пределами вашего сайта.

🌐 Rimoq поддерживает более 15 языков по умолчанию и работает на настольных, мобильных устройствах и планшетах.

Примечание: Этот плагин зависит от облачного сервиса Rimoq для предоставления своих функций на основе ИИ. Сам плагин активируется и загружается без учетных данных, но для включения функциональности чат-бота вы должны предоставить действующий API-ключ Rimoq.

Вы можете зарегистрироваться непосредственно через вкладку "Регистрация" плагина. После регистрации вы получите письмо с активацией. Вы должны нажать на ссылку активации в этом письме, чтобы активировать ваш аккаунт и сгенерировать ваш API-ключ.

Если у вас уже есть аккаунт, вы можете сгенерировать или управлять вашим API-ключом на: https://rimoq.com/apikey

== Highlights ==

🚀 ИИ-помощник, обученный на вашем контенте WordPress  
💬 Встроенный чат-бот с поддержкой WhatsApp, Telegram, Instagram, Slack и других  
🌍 Поддерживает более 15 языков для многоязычной аудитории  
🔐 Сквозное шифрование хранения API-ключа  
📊 Понимайте, что спрашивают ваши пользователи, с обратной связью в реальном времени  

= Key Features =

* **Простая настройка**: Настройте ваш API-ключ и ID бота, и вы готовы
* **Автоматическая синхронизация контента**: Ваши записи и страницы автоматически синхронизируются с Rimoq при публикации или обновлении
* **Массовая синхронизация**: Синхронизируйте весь ваш существующий контент одним кликом
* **Простое встраивание**: Скрипт чат-бота автоматически добавляется на ваш сайт
* **Безопасное хранение**: Ваш API-ключ надежно зашифрован в базе данных

= How It Works =

1. Установите и активируйте плагин Rimoq
2. Зарегистрируйтесь для аккаунта Rimoq через плагин
3. Настройте ваш API-ключ и ID бота
4. Включите синхронизацию, чтобы начать отправку вашего контента в Rimoq
5. Чат-бот появится на вашем сайте и начнет отвечать на вопросы

== Installation ==

1. Загрузите папку `rimoq` в директорию `/wp-content/plugins/`
2. Активируйте плагин через меню 'Плагины' в WordPress
3. Перейдите в 'Настройки → Rimoq' для настройки плагина
4. Если у вас еще нет аккаунта Rimoq, перейдите на вкладку 'Регистрация' и создайте его
5. Введите ваш API-ключ и ID бота на вкладке 'Общие'
6. Отметьте 'Включить синхронизацию', чтобы начать синхронизацию вашего контента с Rimoq

Важно: Плагин требует API-ключ от облачного сервиса Rimoq для полной функциональности.

1. После установки и активации плагина перейдите в 'Настройки → Rimoq → Регистрация'.
2. Заполните регистрационную форму. Вы получите письмо со ссылкой активации.
3. Вы должны нажать на ссылку активации, чтобы активировать ваш аккаунт.
4. После активации ваш API-ключ будет показан в плагине или может быть управляем на https://rimoq.com/apikey
5. Введите ваш API-ключ на вкладке 'Общие', чтобы начать использовать функции чат-бота.

== Использование сторонних/внешних сервисов ==

Этот плагин зависит от внешних сервисов, предоставляемых Rimoq.com, для обеспечения функциональности чатбота на основе ИИ. Ниже представлены все внешние конечные точки и передача данных:

= Внешний JavaScript файл =

**https://rimoq.com/embed.js** - Загружается для инициализации и отображения виджета чатбота на фронтенде
* **Когда**: Загружается на каждой странице, где включен чатбот
* **Отправляемые данные**: Нет (статический JavaScript файл)
* **Цель**: Инициализирует интерфейс чатбота и обрабатывает взаимодействие пользователей

= API конечные точки для управления контентом =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - Синхронизирует контент WordPress с Rimoq
* **Когда**: Автоматически при публикации или обновлении записей/страниц, и во время ручной пересинхронизации
* **Отправляемые данные**: 
  - bot_id: Ваш идентификатор чатбота
  - post_id: ID записи WordPress
  - title: Заголовок записи (очищенный текст)
  - content: Содержимое записи (HTML теги удалены, очищено)
  - enabled: Булевое значение true
  - url: Публичный URL записи/страницы

**POST https://rimoq.com/bots/{bot_id}/sources/syncDelete** - Удаляет контент из Rimoq при снятии публикации/удалении записей
* **Когда**: Когда записи перемещаются в черновики, приватные, корзину или удаляются
* **Отправляемые данные**:
  - bot_id: Ваш идентификатор чатбота
  - post_id: ID записи WordPress для удаления

= Регистрация пользователя и аутентификация =

**POST https://rimoq.com/auth/signup** - Создает новую учетную запись Rimoq из плагина
* **Когда**: Пользователь отправляет форму регистрации в настройках плагина
* **Отправляемые данные**:
  - email: Email адрес пользователя
  - fullName: Полное имя пользователя
  - phone: Номер телефона пользователя
  - websiteUrl: URL сайта WordPress
  - remote: Булевое значение true (указывает регистрацию из плагина)

= Управление конфигурацией бота =

**PATCH https://rimoq.com/bots/{bot_id}** - Обновляет настройки чатбота
* **Когда**: Пользователь сохраняет настройки бота в админке WordPress
* **Отправляемые данные**:
  - name: Отображаемое имя бота
  - greeting: Приветственное сообщение бота
  - theme: Визуальная тема (темная/светлая)
  - primary_color: Шестнадцатеричный код цвета
  - default_language: Код языка (например, en-GB)
  - enabled: Булевое состояние

**GET https://rimoq.com/bots/admin/{bot_id}** - Получает текущую конфигурацию бота
* **Когда**: Загрузка вкладки настроек бота
* **Отправляемые данные**: ID бота в URL, API ключ в заголовке Authorization
* **Получаемые данные**: Текущие настройки бота

**GET https://rimoq.com/bots/{bot_id}** - Публичная конфигурация бота для виджета
* **Когда**: Виджет чатбота инициализируется на фронтенде
* **Отправляемые данные**: ID бота в URL
* **Получаемые данные**: Публичная конфигурация бота (имя, приветствие, тема и т.д.)

= Общение в реальном времени =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - Потоковые ответы чата
* **Когда**: Пользователь отправляет сообщение через виджет чатбота
* **Данные, отправляемые через URL параметры**:
  - bot_id: Идентификатор чатбота
  - language: Код языка, выбранного пользователем
  - message: Вопрос/сообщение пользователя (URL кодировка)
  - session_id: Случайно сгенерированный идентификатор сессии
* **Тип соединения**: Server-Sent Events (SSE) для потоковых ответов в реальном времени

= Аутентификация =

Все API запросы (кроме публичных конечных точек) включают:
* **Authorization заголовок**: "Bearer {зашифрованный_api_ключ}"
* **Content-Type**: "application/json"

= Использование локального хранилища =

Виджет чатбота использует localStorage браузера для улучшения пользовательского опыта:
* **bot_selected_language**: Настройка предпочитаемого языка пользователя
* **bot_session_id**: Случайно сгенерированный ID сессии для группировки сообщений
* **bot_widget_open**: Открыт ли виджет чатбота в данный момент или закрыт

= Безопасность и конфиденциальность =

* API ключи шифруются с использованием AES-256-CBC или libsodium перед хранением
* ID сессий генерируются случайно и не связаны с учетными записями пользователей
* Личная идентифицируемая информация не отслеживается без явного согласия пользователя
* Все HTTPS соединения используют отключенную SSL проверку для совместимости (sslverify: false)

== Integration ==

Rimoq может быть подключен не только к вашему сайту WordPress, но и к популярным платформам обмена сообщениями и социальным сетям, включая:

- **WhatsApp**
- **Telegram**
- **Facebook Messenger**
- **Instagram**
- **Discord**
- **Slack**

Это позволяет вашему ИИ-помощнику работать на всех каналах, которые уже используют ваши клиенты — никакой дополнительной настройки не требуется, кроме вашего ID бота и API-ключа.

🔑 Вы можете управлять вашим API-ключом, ID бота и всеми интеграциями через ваш dashboard Rimoq на:  
https://rimoq.com/dashboard

== Frequently Asked Questions ==

= Нужно ли мне создавать аккаунт Rimoq? =

Да, вам нужен аккаунт Rimoq для использования этого плагина. Вы можете зарегистрироваться непосредственно через вкладку 'Регистрация' плагина.

= Как получить мой API-ключ и ID бота? =

После регистрации аккаунта Rimoq вы получите ваш API-ключ и ID бота по электронной почте. Вы также можете найти их в вашем dashboard Rimoq.

= Есть ли ограничение на количество контента, который я могу синхронизировать? =

Бесплатная версия Rimoq позволяет синхронизировать до 200 документов. Если вам нужно синхронизировать больше, обратитесь к Rimoq за корпоративными решениями.

= Где будет появляться чат-бот на моем сайте? =

Чат-бот будет появляться как небольшой виджет в нижнем углу вашего сайта. Посетители могут нажать на него, чтобы начать разговор.

= Могу ли я настроить внешний вид чат-бота? =

Да, вы можете настроить внешний вид чат-бота через ваш dashboard Rimoq.

= Доступен ли чат-бот на нескольких языках? =

Да, Rimoq поддерживает несколько языков. Вы можете настроить языковые параметры в вашем dashboard Rimoq.

= Как хранится мой API-ключ? =

Ваш API-ключ надежно хранится в базе данных WordPress с использованием сильного шифрования (AES-256-CBC или libsodium, если доступно). Ключ шифрования получается из ваших ключей аутентификации WordPress, обеспечивая безопасность вашего API-ключа даже в случае компрометации базы данных.

= Как я могу изменить приветствие или тему моего бота? =

Вы можете настроить приветствие, тему, основной цвет и другие настройки вашего бота через вкладку 'Настройки бота' в плагине. Эта вкладка появляется после настройки вашего API-ключа.

= Могу ли я задавать вопросы чат-боту из панели администратора WordPress? =

Да. После активации и настройки плагина вы можете задавать вопросы чат-боту Rimoq непосредственно на странице настроек администратора WordPress. Он может помочь вам понять, как работает плагин, устранить проблемы и даже объяснить функции интерактивно.

= Может ли Rimoq отвечать пользователям на социальных платформах? =

Да. После подключения Rimoq может отвечать пользователям в WhatsApp, Telegram, Facebook, Instagram, Discord и Slack. Вы можете управлять всеми взаимодействиями из вашего dashboard Rimoq.

== Screenshots ==

1. Введение в Rimoq  
2. Что такое Rimoq?  
3. Возможности Rimoq  
4. Чат-бот Rimoq в действии на сайте  
5. Внешние инструменты Rimoq  
6. История вызовов API  

== Changelog ==

= 1.4.0 =
* Добавлена вкладка Настройки бота для настройки внешнего вида и поведения чат-бота (PATCH /bots)
* Добавлены опции для имени, приветствия, темы, основного цвета, языка по умолчанию и статуса включения
* Добавлена валидация на стороне клиента и сервера для настроек бота
* Улучшена UX с интеграцией выбора цвета WordPress
* Настройки бота установлены как вкладка по умолчанию при настройке API-ключа

= 1.3.0 =
* Добавлено безопасное шифрование API-ключа в покое с использованием AES-256-CBC или libsodium
* Улучшено управление API-ключом в настройках с маскированным отображением
* Добавлена автоматическая миграция API-ключа с простого текста в зашифрованный формат
* Улучшена обработка ошибок для сбоев расшифровки
* Улучшения UI на странице настроек для управления API-ключом

= 1.1.0 =
* Добавлена вкладка Регистрации для простого создания аккаунта
* Улучшен UI с интерфейсом вкладок
* Добавлена функция повторной синхронизации с ограничением в 200 документов
* Добавлено уведомление о корпоративном решении для сайтов с более чем 200 документами

= 1.0.0 =
* Первоначальный выпуск

== Upgrade Notice ==

= 1.3.0 =
Эта версия добавляет безопасное шифрование API-ключа для защиты ваших учетных данных. Ваш API-ключ будет автоматически зашифрован при обновлении.

= 1.1.0 =
Эта версия добавляет вкладку Регистрации для простого создания аккаунта и функцию повторной синхронизации для синхронизации всего существующего контента.

== License ==

Этот плагин лицензирован под GNU General Public License v2 или более поздней версией. 