=== 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

为您的网站添加一个由AI驱动的聊天机器人，它可以从您的WordPress内容中学习，并为访问者的问题提供实时答案。

== Description ==

Rimoq是一个由AI驱动的聊天机器人服务，可帮助您的访问者快速高效地在您的网站上查找信息。它从您的内容中学习，并为用户问题提供即时答案。

使用Rimoq插件，您可以：

* 自动将您的WordPress文章和页面与Rimoq同步
* 通过简单配置将Rimoq聊天机器人嵌入您的网站
* 为访问者的问题提供即时答案
* 改善用户体验并减少支持请求
* 跟踪用户互动并获得关于访问者所寻找内容的见解

Rimoq还支持与WhatsApp、Telegram、Facebook Messenger、Instagram、Discord和Slack等流行消息平台的集成——让您的AI助手能够与用户在您的网站之外进行互动。

🌐 Rimoq默认支持15+种语言，并在桌面、移动和平板设备上运行。

注意：此插件依赖Rimoq云服务来提供其AI驱动的功能。插件本身将在没有凭据的情况下激活和加载，但要启用聊天机器人功能，您必须提供有效的Rimoq API密钥。

您可以直接通过插件的"注册"选项卡进行注册。注册后，您将收到一封激活电子邮件。您必须点击该电子邮件中的激活链接来激活您的账户并生成您的API密钥。

如果您已经有账户，可以在以下位置生成或管理您的API密钥：https://rimoq.com/apikey

== Highlights ==

🚀 基于您的WordPress内容训练的AI助手  
💬 支持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同步

重要提示：插件需要来自Rimoq云服务的API密钥才能完全运行。

1. 安装并激活插件后，转到"设置 → Rimoq → 注册"。
2. 填写注册表单。您将收到包含激活链接的电子邮件。
3. 您必须点击激活链接来激活您的账户。
4. 激活后，您的API密钥将显示在插件中，或可在https://rimoq.com/apikey进行管理
5. 在"常规"选项卡中输入您的API密钥以开始使用聊天机器人功能。

== 第三方/外部服务使用 ==

此插件依赖于Rimoq.com提供的外部服务来提供AI驱动的聊天机器人功能。以下是所有外部端点和数据传输：

= 外部JavaScript文件 =

**https://rimoq.com/embed.js** - 加载以在前端初始化和显示聊天机器人小部件
* **何时**: 在启用聊天机器人的每个页面上加载
* **发送数据**: 无（静态JavaScript文件）
* **目的**: 初始化聊天机器人界面并处理用户交互

= 内容管理API端点 =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - 将WordPress内容与Rimoq同步
* **何时**: 发布或更新帖子/页面时自动执行，以及手动重新同步期间
* **发送数据**: 
  - bot_id: 您的聊天机器人标识符
  - post_id: WordPress帖子ID
  - title: 帖子标题（清理的文本）
  - content: 帖子内容（已删除HTML标签，已清理）
  - enabled: 布尔值true
  - url: 帖子/页面的公共URL

**POST https://rimoq.com/bots/{bot_id}/sources/syncDelete** - 当帖子取消发布/删除时从Rimoq删除内容
* **何时**: 当帖子移动到草稿、私有、垃圾箱或删除时
* **发送数据**:
  - bot_id: 您的聊天机器人标识符
  - post_id: 要删除的WordPress帖子ID

= 用户注册和身份验证 =

**POST https://rimoq.com/auth/signup** - 从插件创建新的Rimoq账户
* **何时**: 用户在插件设置中提交注册表单时
* **发送数据**:
  - email: 用户电子邮件地址
  - fullName: 用户全名
  - phone: 用户电话号码
  - websiteUrl: WordPress网站URL
  - 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}** - 获取当前机器人配置
* **何时**: 加载机器人设置选项卡时
* **发送数据**: URL中的机器人ID，Authorization标头中的API密钥
* **接收数据**: 当前机器人设置

**GET https://rimoq.com/bots/{bot_id}** - 小部件的公共机器人配置
* **何时**: 聊天机器人小部件在前端初始化时
* **发送数据**: URL中的机器人ID
* **接收数据**: 公共机器人配置（名称、问候、主题等）

= 实时聊天通信 =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - 流式聊天响应
* **何时**: 用户通过聊天机器人小部件发送消息时
* **通过URL参数发送的数据**:
  - bot_id: 聊天机器人标识符
  - language: 用户选择的语言代码
  - message: 用户的问题/消息（URL编码）
  - session_id: 随机生成的会话标识符
* **连接类型**: 服务器发送事件（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**

这使您的AI助手能够在客户已经使用的所有渠道上运行——除了您的机器人ID和API密钥外，无需额外设置。

🔑 您可以通过Rimoq仪表板管理您的API密钥、机器人ID和所有集成：  
https://rimoq.com/dashboard

== Frequently Asked Questions ==

= 我需要创建Rimoq账户吗？ =

是的，您需要Rimoq账户来使用此插件。您可以直接通过插件的"注册"选项卡进行注册。

= 如何获取我的API密钥和机器人ID？ =

注册Rimoq账户后，您将通过电子邮件收到API密钥和机器人ID。您也可以在Rimoq仪表板中找到它们。

= 我可以同步的内容数量有限制吗？ =

Rimoq的免费版本允许您同步多达200个文档。如果您需要同步更多内容，请联系Rimoq获取企业解决方案。

= 聊天机器人会在我网站的哪里出现？ =

聊天机器人将作为小部件出现在您网站的底部角落。访问者可以点击它开始对话。

= 我可以自定义聊天机器人的外观吗？ =

是的，您可以通过Rimoq仪表板自定义聊天机器人的外观。

= 聊天机器人支持多种语言吗？ =

是的，Rimoq支持多种语言。您可以在Rimoq仪表板中配置语言设置。

= 我的API密钥如何存储？ =

您的API密钥使用强加密（AES-256-CBC或libsodium如果可用）安全存储在WordPress数据库中。加密密钥来自您的WordPress认证密钥，确保即使数据库被泄露，您的API密钥也保持安全。

= 如何更改机器人的问候语或主题？ =

您可以通过插件中的"机器人设置"选项卡自定义机器人的问候语、主题、主色调和其他设置。此选项卡在您配置API密钥后出现。

= 我可以从WordPress管理面板向聊天机器人提问吗？ =

是的。插件激活和配置后，您可以直接在WordPress管理设置页面内向Rimoq聊天机器人提问。它可以帮助您了解插件的工作原理、解决问题，甚至交互式地解释功能。

= Rimoq可以在社交平台上回复用户吗？ =

是的。连接后，Rimoq可以在WhatsApp、Telegram、Facebook、Instagram、Discord和Slack上回复用户。您可以从Rimoq仪表板管理所有互动。

== Screenshots ==

1. Rimoq 简介  
2. 什么是 Rimoq？  
3. Rimoq 功能  
4. 网站上运行的 Rimoq 聊天机器人  
5. Rimoq 外部工具  
6. API 调用历史  

== Changelog ==

= 1.4.0 =
* 添加了机器人设置选项卡用于配置聊天机器人外观和行为(PATCH /bots)
* 添加了名称、问候语、主题、主色调、默认语言和启用状态选项
* 为机器人设置添加了客户端和服务器端验证
* 通过WordPress颜色选择器集成改进了UX
* 当配置API密钥时，机器人设置设为默认选项卡

= 1.3.0 =
* 使用AES-256-CBC或libsodium添加了静态API密钥安全加密
* 改进了设置中的API密钥管理，带有掩码显示
* 添加了从明文到加密格式的自动API密钥迁移
* 改进了解密失败的错误处理
* 在设置页面中改进了API密钥管理的UI

= 1.1.0 =
* 添加了注册选项卡便于账户创建
* 改进了带有选项卡界面的UI
* 添加了带有200文档限制的重新同步功能
* 为超过200文档的网站添加了企业解决方案通知

= 1.0.0 =
* 初始发布

== Upgrade Notice ==

= 1.3.0 =
此版本添加了安全的API密钥加密以保护您的凭据。更新时您的API密钥将自动加密。

= 1.1.0 =
此版本添加了注册选项卡便于账户创建，以及重新同步功能以同步所有现有内容。

== License ==

此插件使用GNU通用公共许可证v2或更高版本许可。 