Convly Chat Widget

Convly Chat Widget helps you add Convly chatbots to WordPress without editing theme files.

Key features: – Global default scenario configuration – Per-post and per-page override settings – Category-based scenario routing – Auto inject control by page context – Shortcode support for manual placement – Language-specific scenario IDs (JA / EN) – Safe output with sanitization and escaping

Usage

1. Set Default Scenario ID first (this is the main ID used on normal pages).
2. If you run multilingual pages, also set Default Scenario ID (JA) and Default Scenario ID (EN).
3. Use Exclude Page/Post IDs with comma-separated numeric IDs (example: 12,45,102).
4. Use Category Rules with one rule per line in this format: category-slug|defaultScenarioId|jaScenarioId|enScenarioId
5. Example category rules: news|k98e449d1991|k98e449d1991|x54b0d5c7341 support|k98e449d1991||x54b0d5c7341
6. For per-page overrides, open a post or page editor and configure the Convly Chat Widget meta box.

Language behavior: – The widget uses the current WordPress locale. – If locale starts with ja, scenario_id_ja is preferred. – For other locales, scenario_id_en is preferred. – If a language-specific ID is empty, the plugin falls back to scenario_id.

Scenario ID format: – Use public random IDs (12 chars). – Recommended format is lowercase letters and digits. – Example IDs: k98e449d1991, x54b0d5c7341.

Style defaults: – Leave Button Size, Icon Size, Icon Offset, Z Index, and Font Family empty to use embed.js defaults. – If needed, set values such as 60px, 26px, 12px, 9999, or Inter, sans-serif.