=== 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 콘텐츠를 학습하고 방문자의 질문에 실시간으로 답변하는 AI 기반 챗봇을 웹사이트에 추가하세요.

== Description ==

Rimoq는 방문자가 웹사이트에서 정보를 빠르고 효율적으로 찾을 수 있도록 돕는 AI 기반 챗봇 서비스입니다. 콘텐츠를 학습하고 사용자 질문에 즉시 답변을 제공합니다.

Rimoq 플러그인을 사용하면 다음을 할 수 있습니다:

* WordPress 게시물과 페이지를 Rimoq와 자동 동기화
* 간단한 설정으로 Rimoq 챗봇을 웹사이트에 임베드
* 방문자의 질문에 즉시 답변 제공
* 사용자 경험 개선 및 지원 요청 감소
* 사용자 상호작용 추적 및 방문자가 찾고 있는 것에 대한 인사이트 획득

Rimoq는 WhatsApp, Telegram, Facebook Messenger, Instagram, Discord, Slack과 같은 인기 메시징 플랫폼과의 통합도 지원하여 AI 어시스턴트가 웹사이트를 넘어 사용자와 상호작용할 수 있게 합니다.

🌐 Rimoq는 기본적으로 15개 이상의 언어를 지원하며 데스크톱, 모바일, 태블릿 기기에서 작동합니다.

참고: 이 플러그인은 AI 기반 기능을 제공하기 위해 Rimoq 클라우드 서비스에 의존합니다. 플러그인 자체는 자격 증명 없이 활성화되고 로드되지만, 챗봇 기능을 활성화하려면 유효한 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 키를 입력하세요.

== 제3자/외부 서비스 사용 ==

이 플러그인은 AI 기반 챗봇 기능을 제공하기 위해 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: WordPress 게시물 ID
  - title: 게시물 제목 (정리된 텍스트)
  - content: 게시물 내용 (HTML 태그 제거됨, 정리됨)
  - enabled: 참 불린값
  - 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: 참 불린값 (플러그인에서 가입을 나타냄)

= 봇 구성 관리 =

**PATCH https://rimoq.com/bots/{bot_id}** - 챗봇 설정 업데이트
* **언제**: 사용자가 WordPress 관리자에서 봇 설정을 저장할 때
* **전송 데이터**:
  - name: 봇 표시 이름
  - greeting: 봇 인사말 메시지
  - theme: 시각적 테마 (다크/라이트)
  - primary_color: 16진 색상 코드
  - 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: 무작위 생성된 세션 식별자
* **연결 유형**: 실시간 스트리밍 응답을 위한 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**

이를 통해 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 General Public License v2 이상으로 라이선스됩니다. 