Description
Ringbot AI Chat Voice Agent connects your WordPress site to Ringbot’s hosted chat and form experience.
This plugin is intentionally thin:
- WordPress handles installation, placement, and site-level settings
- Ringbot handles AI behavior, conversation state, Pro features, human handoff, and analytics
The MVP plugin currently supports:
- WordPress Setup Key connection flow
- Floating widget injection
- Inline embed with
[ringbot_chat] - Synced Ringbot forms stored locally inside WordPress
- Inline and popup form embeds with
[ringbot_form] - Ringbot Form Gutenberg block
- Classic Editor form insert helper
- Forms admin screen with sync health, recent activity, and recovery actions
- Natural-language Pro status for human handoff
- Basic diagnostics
External Services
This plugin connects to Ringbot’s hosted service to work.
The plugin contacts Ringbot in these cases:
- When an admin submits a WordPress Setup Key to connect the site
- When the plugin validates an existing installation
- When Ringbot sends signed form snapshots to WordPress after a form save or re-sync
- When a visitor submits a synced Ringbot form from WordPress
- When the floating widget loader is requested from the configured Ringbot Base URL
- When the inline or floating chat experience is opened by a visitor
Data sent to Ringbot can include:
- The WordPress site URL
- Plugin version
- Installation identifiers such as install ID and site token
- The selected Ringbot Base URL and agent binding
- Synced form submission payloads and related client metadata
- Visitor chat content and related chat metadata after the widget is opened
The service is provided by Ringbot and requires a Ringbot account.
Terms of Service: https://ringbot.au/terms
Privacy Policy: https://ringbot.au/privacy
Screenshots
Setup screen for connecting a WordPress site to Ringbot with a WordPress Setup Key. 
Forms screen showing synced forms, shortcode actions, and sync health. 
Gutenberg block and Classic Editor helper for inserting Ringbot forms into content. 
Diagnostics screen showing connection checks and forms sync recovery guidance, plus a live floating Ringbot chat widget and synced Ringbot form on the public site.
Blocks
This plugin provides 1 block.
- Ringbot Form
Installation
- Upload the plugin to
/wp-content/plugins/or install it through WordPress. - Activate the plugin.
- Open
Ringbot AI Chat Voice Agentin the WordPress admin menu. - Generate a WordPress Setup Key in Ringbot.
- Paste the setup key into the Setup screen and save.
- Review the Display page to choose where the floating widget appears.
- Open the Forms screen after saving a Ringbot form to confirm the latest synced copy is available in WordPress.
FAQ
-
Do I need a Ringbot account?
-
Yes. This plugin connects to Ringbot’s hosted chat service.
-
Where do I control the chat design and advanced styling?
-
Design, branding, and advanced widget styling are managed in Ringbot Agent Design. The WordPress plugin focuses on placement, connection, and site targeting.
-
Does this plugin run the AI locally inside WordPress?
-
No. The AI runtime and handoff logic remain in Ringbot.
-
How do I add inline chat?
-
Use the shortcode
[ringbot_chat]on any page or post. -
How do I add a Ringbot form to WordPress?
-
Save the form in Ringbot first, then open the plugin’s Forms screen in WordPress. You can copy a shortcode, insert the form from the Ringbot Form Gutenberg block, or use the Classic Editor helper button.
-
Does WordPress fetch the form definition from Ringbot on every page view?
-
No. WordPress stores synced form snapshots locally and renders them from local storage. Only form submissions go back to Ringbot.
-
What should I do if forms stop syncing?
-
Open the Forms screen to review Sync health and Recent activity. Use
Revalidate installation, thenSync now. If signature or timestamp issues continue, disconnect the site and reconnect it with a fresh WordPress Setup Key.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Ringbot AI Chat Voice Agent” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Ringbot AI Chat Voice Agent” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.0
- Added local WordPress tables for synced Ringbot forms and sync log storage
- Added a signed REST sync endpoint for incoming Ringbot form snapshots
- Added stale-version and duplicate-delivery handling for synced forms
- Added a Forms admin screen for inspecting synced form IDs, versions, and last sync time
- Added form shortcode rendering, popup mode, and Ringbot form submissions from WordPress
- Added Ringbot Form Gutenberg block and Classic Editor insertion helper
- Added forms sync diagnostics, cleanup actions, and recovery guidance
0.1.6
- Repackaged the plugin for a fresh WordPress.org submission after the listing rename
0.1.5
- Renamed the plugin to Ringbot AI Chat Voice Agent for a unique WordPress.org listing
- Updated contributor metadata to use the official WordPress.org account
- Aligned the text domain with the new plugin slug
0.1.4
- Reworked admin POST helpers to satisfy Plugin Check input sanitization rules
0.1.3
- Switched the floating loader to WordPress-standard script enqueueing
- Improved admin form input handling for Plugin Check compatibility
- Removed deprecated translation bootstrap and tightened request sanitization
0.1.2
- Manual embed placement in Agent Design now stays inside generated snippets and no longer overrides WordPress plugin targeting
- WordPress plugin Display page now focuses on floating widget placement only
- Removed legacy inline and both display mode options from the plugin UI
0.1.1
- Compact WordPress setup panel in Agent Design
- Setup guidance and sign-up flow improvements
- Default Ringbot workspace updated to ringbot.au
- Frontend display targeting and optional-field UX improvements
- Upgrade migration framework for future plugin updates
0.1.0
- Initial MVP plugin structure
- Setup, Display, and Diagnostics admin screens
- Floating widget loader
- Inline shortcode embed