Rimoq

How It Works

1. 01Install and activate the Rimoq plugin
2. 02Sign up for a Rimoq account through the plugin
3. 03Configure your API Key and Bot ID
4. 04Enable sync to start sending your content to Rimoq
5. 05The chatbot will appear on your website and start answering questions

Use of third party/external services

This plugin relies on external services provided by Rimoq.com to deliver AI-powered chatbot functionality. Below are all the external endpoints and data transfers:

External JavaScript File

https://rimoq.com/embed.js – Loaded to initialize and display the chatbot widget on the frontend * When : Loaded on every page where chatbot is enabled * Data sent : None (static JavaScript file) * Purpose : Initializes chatbot interface and handles user interactions

API Endpoints for Content Management

POST https://rimoq.com/bots/{bot_id}/sources/sync – Syncs WordPress content to Rimoq * When : Automatically when posts/pages are published or updated, and during manual re-sync * Data sent : – bot_id: Your chatbot identifier – post_id: WordPress post ID – title: Post title (sanitized text) – content: Post content (HTML tags stripped, sanitized) – enabled: Boolean true – url: Public URL of the post/page

POST https://rimoq.com/bots/{bot_id}/sources/syncDelete – Removes content from Rimoq when posts are unpublished/deleted * When : When posts are moved to draft, private, trashed, or deleted * Data sent : – bot_id: Your chatbot identifier – post_id: WordPress post ID to remove

User Registration and Authentication

POST https://rimoq.com/auth/signup – Creates new Rimoq account from plugin * When : User submits signup form in plugin settings * Data sent : – email: User’s email address – fullName: User’s full name – phone: User’s phone number – websiteUrl: WordPress site URL – remote: Boolean true (indicates signup from plugin)

Bot Configuration Management

PATCH https://rimoq.com/bots/{bot_id} – Updates chatbot settings * When : User saves bot settings in WordPress admin * Data sent : – name: Bot display name – greeting: Bot greeting message – theme: Visual theme (dark/light) – primary_color: Hex color code – default_language: Language code (e.g., en-GB) – enabled: Boolean status

GET https://rimoq.com/bots/admin/{bot_id} – Retrieves current bot configuration * When : Loading bot settings tab * Data sent : Bot ID in URL, API key in Authorization header * Data received : Current bot settings

GET https://rimoq.com/bots/{bot_id} – Public bot configuration for widget * When : Chatbot widget initializes on frontend * Data sent : Bot ID in URL * Data received : Public bot configuration (name, greeting, theme, etc.)

Real-time Chat Communication

SSE https://rimoq.com/chat/{bot_id}/stream/{language} – Streaming chat responses * When : User sends message through chatbot widget * Data sent via URL parameters : – bot_id: Chatbot identifier – language: User’s selected language code – message: User’s question/message (URL encoded) – session_id: Randomly generated session identifier * Connection type : Server-Sent Events (SSE) for real-time streaming responses

Authentication

All API requests (except public endpoints) include: * Authorization header : “Bearer {encrypted_api_key}” * Content-Type : “application/json”

Local Storage Usage

The chatbot widget uses browser localStorage for enhanced user experience: * bot_selected_language : User’s preferred language setting * bot_session_id : Randomly generated session ID for grouping messages * bot_widget_open : Whether chatbot widget is currently open or closed

Security and Privacy

• API keys are encrypted using AES-256-CBC or libsodium before storage
• Session IDs are randomly generated and not linked to user accounts
• No personally identifiable information is tracked without explicit user consent
• All HTTPS connections use SSL verification disabled for compatibility (sslverify: false)

Privacy and Data Handling

This plugin does not track users without explicit consent.

No personally identifiable information (PII) is collected or stored. The only data transmitted to the external service is:

• The user’s message (query)
• A randomly generated session ID (used only to group messages within a session)

The session ID is fully anonymous and not linked to any user account, IP address, or personal data. No tracking or profiling of users occurs, and no other user data is stored or used beyond the current session context.

Integration

Rimoq can be connected not only to your WordPress site but also to popular messaging and social platforms, including:

• WhatsApp
• Telegram
• Facebook Messenger
• Instagram
• Discord
• Slack

This allows your AI assistant to operate across all channels your customers already use—no extra setup required beyond your Bot ID and API Key.

🔑 You can manage your API Key, Bot ID, and all integrations through your Rimoq dashboard at: https://rimoq.com/dashboard

License

This plugin is licensed under the GNU General Public License v2 or later.