
Embed Convly ChatBuilder chat widgets into WordPress with global defaults, per-page overrides, and category-based scenario routing.
| Author: | convly (profile at wordpress.org) |
| WordPress version required: | 6.0 |
| WordPress version tested: | 6.9.4 |
| Plugin version: | 1.0.4 |
| Added to WordPress repository: | 02-04-2026 |
| Last updated: | 02-04-2026 |
| Rating, %: | 0 |
| Rated by: | 0 |
| Plugin URI: | https://app.convly.jp/ |
| Total downloads: | 42 |
![]() Click to start download |
|
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
- Set
Default Scenario IDfirst (this is the main ID used on normal pages). - If you run multilingual pages, also set
Default Scenario ID (JA)andDefault Scenario ID (EN). - Use
Exclude Page/Post IDswith comma-separated numeric IDs (example:12,45,102). - Use
Category Ruleswith one rule per line in this format:
category-slug|defaultScenarioId|jaScenarioId|enScenarioId - Example category rules:
news|k98e449d1991|k98e449d1991|x54b0d5c7341
support|k98e449d1991||x54b0d5c7341 - For per-page overrides, open a post or page editor and configure the
Convly Chat Widgetmeta 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.
FAQ
ChangeLog
