WordPress Plugin Documentation
Install the Ryvet plugin to add AI-powered chat forms to your WordPress site. Replace Contact Form 7 or any form with one click.
Requirements
Setup Guide
Install the plugin
- Download the Ryvet plugin ZIP file from the link below or from the WordPress Plugin Directory.
- In your WordPress admin, go to Plugins → Add Plugin → Upload Plugin.
- Click Choose file, select the
ryvet.zipfile, then click Install Now. - Click Activate once the installation is complete.
Connect your Ryvet account
- After activation, click Ryvet in the WordPress sidebar (or go to Ryvet → Settings).
- You need an API key to connect. Log into your Ryvet dashboard at app.ryvet.io/settings.
- Click Generate API Key — you'll get a key starting with
ryv_. - Copy the key and paste it into the API Key field in the WordPress plugin settings.
- Click Connect Account. The plugin will verify your key and fetch your flows.
Select a flow
- Once connected, you'll see a Default Flow dropdown with all your Ryvet flows.
- Select the flow you want to use as your chat widget.
- Choose a Display Mode: Floating Chat Bubble (appears in the corner of every page) or Inline Embed (renders inside a specific page element).
- If you chose inline mode, enter the Container CSS Selector (e.g.
#contact-formor.chat-section). - Click Save Settings.
Replace existing forms (optional)
- Go to Ryvet → Form Replacement in the WordPress sidebar.
- The plugin automatically detects forms from Contact Form 7, WPForms, Gravity Forms, Ninja Forms, and Formidable Forms.
- Toggle Replace All to replace every detected form with your default Ryvet flow — one click migration.
- Or use the Replace With Flow dropdown per form to assign different Ryvet flows to different forms.
- Click Save Changes. Visit any page with a form — it's now a Ryvet AI chat.
- Turn it off any time — your original forms come back instantly. Ryvet never modifies your form plugin data.
Shortcode Reference
Use the [ryvet] shortcode to embed a Ryvet flow anywhere in your WordPress pages, posts, or widgets.
[ryvet]Embed your default flow inline on any page or post.
[ryvet flow="clx1abc2def3ghi"]Embed a specific flow by its Flow ID.
Supported form plugins
The plugin auto-detects and can replace forms from these plugins:
Frequently Asked Questions
Where do I find my Flow ID?
In your Ryvet dashboard at app.ryvet.io, click on any flow. The Flow ID is shown prominently at the top of the flow detail page with a copy button.
Where do I get my API key?
Go to app.ryvet.io/settings and click "Generate API Key". The key starts with ryv_ and is shown once — copy it immediately.
Will this break my existing forms?
No. When you deactivate the plugin or turn off replacement, your original forms come back instantly. Ryvet replaces the form output at render time — it never modifies your form plugin data.
Can I use different flows on different pages?
Yes. Use the [ryvet flow="FLOW_ID"] shortcode to embed a specific flow on any page. You can also assign different flows to different forms in the Form Replacement settings.
Does it work with caching plugins?
Yes. The Ryvet embed script loads asynchronously and works with WP Super Cache, W3 Total Cache, LiteSpeed Cache, and all major caching plugins.
What about plain HTML forms not from a plugin?
Enable "HTML Form Replacement" in Ryvet → Form Replacement. This uses JavaScript to detect and replace <form> elements at page load. It automatically skips WordPress login, search, comment, and WooCommerce forms.
What happens to form submissions?
Leads captured through Ryvet appear in your Ryvet dashboard at app.ryvet.io. You can also send them to your existing CRM via Zapier, or set up email notifications.
Can I remove the "Powered by Ryvet" branding?
Yes, on the Standard plan ($39/mo) and above. The Free plan includes a small "Powered by Ryvet" badge.
How do I disconnect my account?
Go to Ryvet → Settings in WordPress and click the "Disconnect" button. Your settings will be cleared but your Ryvet account and flows are unaffected.
Do I need a Ryvet account?
Yes. Sign up free at ryvet.io/signup — no credit card required. The free plan includes 1 flow and 20 leads/month.
Troubleshooting
Widget not appearing
- • Check that the plugin is activated and enabled (Ryvet → Settings → Enable Ryvet toggle)
- • Verify your API key is connected (green “Connected” status in Settings)
- • Make sure a default flow is selected from the dropdown
- • Clear your caching plugin cache (WP Super Cache, LiteSpeed, etc.)
- • Check the browser console for JavaScript errors
Form not being replaced
- • Go to Ryvet → Form Replacement and verify the form appears in the detected forms table
- • Check that “Replace All” is toggled on, or a specific flow is assigned to that form
- • If using a page builder (Elementor, Divi), the form might render via a widget rather than a shortcode — try enabling “HTML Form Replacement”
- • Clear your page cache after making changes
API key not working
- • Keys start with
ryv_— make sure you copied the full key - • If you regenerated your key in the Ryvet dashboard, the old one is revoked. Disconnect and reconnect with the new key.
- • Your WordPress server needs outbound HTTPS access to app.ryvet.io
Ready to replace your forms?
Create your free Ryvet account, install the plugin, and launch your first AI chat form in under 5 minutes.