Description
ConvoHub for WordPress brings live chat, customer identification and lead collection to your website. Connect your WordPress site to your ConvoHub account so your team can answer visitor questions, follow up on enquiries and manage customer conversations from ConvoHub.
Add a chat widget that matches your site and choose the pages where it appears. When identity verification is enabled, signed-in WordPress users are securely identified to ConvoHub so your team can recognize returning customers and continue their conversations.
Turn website enquiries into conversations with a configurable lead form. Add the form using the WordPress block editor or a shortcode, choose the fields you need, and collect contact details, messages and custom information. Submissions include page and campaign context, and undelivered leads can be retried automatically or managed from the Logs tab.
Manage your connection, chat inbox, form settings and signed webhooks from the WordPress admin area. Built-in setup guides, searchable help and diagnostics support installation and troubleshooting. A ConvoHub account is required to use the connected messaging service.
Chat widget
- Pick the website inbox that powers your chat, or create one for your site in a click.
- Choose where the widget shows: every page, only some pages, or every page except some. Hide it for signed-in users or on the WooCommerce checkout.
- Set the position, launcher style, color scheme and other options.
- Warns you when your inbox’s allowed-domains list would make the browser block the widget, and fixes it in a click.
Recognized customers
- Signed-in customers are signed on your server, so ConvoHub knows who they are and shows their conversation history on any device.
- The chat resets when someone signs out or a different person signs in on the same browser.
Lead collection
- Add the “ConvoHub Lead Form” block, or use the
[convohub_form]shortcode. - Choose the fields: rename, reorder, hide or require the built-in ones, and add your own (short or long text, number, email, phone, dropdown, checkbox), such as Company or Budget.
- Choose button colour, corners, spacing and width on the Leads tab; use WordPress Additional CSS for other styling.
- Each submission becomes a contact and a conversation in a ConvoHub API inbox, tagged with the page and campaign (UTM) it came from.
- Phone numbers are converted to international format. Spam is limited with a hidden field and a per-visitor rate limit.
- If ConvoHub cannot be reached, the lead is kept and retried automatically. You can see, resend or discard undelivered leads under ConvoHub > Logs.
Help built in
- A Help tab with searchable guides, a setup guide that ticks itself off, and a diagnostics panel you can copy for support. It never includes your token or secrets.
- A setup checklist on the Connection tab shows what is left to do.
Events from ConvoHub
- A signed webhook receiver lets ConvoHub tell your site about new customer messages. Each event is verified, checked for age, and processed once. Developers can react to events with the
convohub_webhook_eventaction.
A companion plugin, ConvoHub Commerce, adds WooCommerce cart recovery and order-aware support. It requires this plugin.
External services
This plugin connects your site to ConvoHub, a customer messaging service, at ConvoHub. That address is fixed. Using this plugin requires a ConvoHub account.
The Connection tab links to ConvoHub so you can create an account. New accounts include a 7-day trial. Opening that link sends nothing from your site. Account details are entered on ConvoHub.
What is sent, and when
- When you press Connect: the connection key you pasted is sent once to ConvoHub, with your site’s address and name and the WordPress and plugin versions. ConvoHub answers with the account and the access this site uses from then on. The key itself is not saved.
- When you test the connection, and when you use the Widget, Leads or Webhook settings: that access is sent to ConvoHub to read your account, inboxes and webhooks, and to create or update them.
- When a visitor loads a page with the chat widget: the visitor’s browser loads the widget script from ConvoHub and exchanges chat data with it. If customer identity verification is on, a signed-in customer’s ID, name and email address, and a signature of the ID, are given to the widget.
- When a visitor submits the lead form: the name, email address, phone number, message, the page address and title, and campaign (UTM) parameters they provided are sent from your server to ConvoHub, and may be retried later if ConvoHub is unreachable.
- When the webhook is registered: ConvoHub sends event data (for example new customer messages) to your site’s address.
This service is provided by ConvoHub (https://www.convohub.io). Terms of Service: https://www.convohub.io/terms. Privacy Policy: https://www.convohub.io/privacy.
Privacy
Undelivered leads expire 30 days after submission. Expired leads are removed by daily WP-Cron cleanup; actual deletion depends on WP-Cron running. Retrying or resending does not renew retention. Connecting a different ConvoHub account deletes previous-account leads and cancels their retries. Disconnecting preserves undelivered leads for reconnection to the same account within the retention period. Leads whose original destination cannot be established are never delivered.
The plugin adds suggested text to your site’s privacy policy guide, and supports the WordPress personal data export and erase tools for form submissions that are waiting to be delivered. It sets a “convohub_logged_in” cookie for signed-in users and keeps the signed-in user’s ID in the browser’s local storage so the chat can detect a change of user. The chat widget loaded from ConvoHub sets its own cookies.
Credits
Admin interface icons include Lucide and Feather artwork under the ISC and MIT licenses. Copyright notices and license text are included in assets/licenses/lucide.txt. Source: https://lucide.dev and https://github.com/lucide-icons/lucide.
Installation
- Upload the plugin and activate it.
- If you need a ConvoHub account, open ConvoHub in the admin menu and on the Connection tab press “Create a ConvoHub account” (new accounts include a 7-day trial). Then in ConvoHub open Settings > Integrations > WordPress and generate a connection key. In WordPress paste the key into “Connection key” on the Connection tab and press Connect.
- On the Widget tab, choose or create the website inbox and turn the widget on.
- On the Leads tab, choose or create the API inbox that receives leads, then add the lead form to a page.
- Optional: on the Connection tab, register the webhook so ConvoHub can send events to your site.
FAQ
Where is the help?
Open ConvoHub in the admin menu and choose the Help tab. It has guides for every setting, a step-by-step setup guide and diagnostics. Small question-mark links next to the more complex settings open the right guide.
I do not have a ConvoHub account.
On the Connection tab press “Create a ConvoHub account”. New accounts include a 7-day trial. After you sign up, open Settings > Integrations > WordPress in ConvoHub, generate a connection key, paste it on the Connection tab and press Connect.
What does “Copy for support” copy?
A short list of facts about your site and settings (versions, whether the widget and webhook are on, and so on). Your connection key, access token, identity secret and webhook secret are never included, and anything that looks like a secret is removed from the text.
Where do I find my connection key?
In ConvoHub, open Settings > Integrations > WordPress and generate a key. Only a ConvoHub administrator can do this. Paste the whole key into the Connection tab. A key works once and is not saved.
It says the key is not valid.
The key may have been used already, revoked or expired, or its owner is no longer an administrator. Generate a new one in ConvoHub. The Help tab explains each message.
My site was connected with an API access token before.
It keeps working. The Connection tab shows a notice until you replace the token: generate a key in ConvoHub and paste it. If the key belongs to the same account, your inbox, identity and webhook settings stay.
The widget does not appear.
Check that the widget is turned on, that the page is not excluded by your display rules, and that your site’s address is in the inbox’s allowed domains. The Widget tab shows a warning and a one-click fix if it is not.
How do I add my own form field?
Go to ConvoHub > Leads > Form fields and choose “Add a field”. Give it a label and a type. The value is added to the first message of the conversation and saved on the contact in ConvoHub under the field name. Changing a field’s name later starts a new attribute in ConvoHub, so choose it once.
How do I style the form?
Use the Appearance section on the Leads tab: a button colour, the corners, the space between fields and a maximum width. What you leave on “Follow the theme” keeps your theme’s look. For anything else use WordPress’s own Additional CSS (Appearance > Customize, or Styles in the Site Editor) with the form’s classes: convohub-lead-form, convohub-lead-form__field, convohub-lead-form__field--email (or any field name), convohub-lead-form__error and convohub-lead-form__success. The plugin does not store or print CSS written by you.
Do leads need an email address?
A lead needs an email address or a phone number. A phone number must include the country code, or you can set a default country code on the Leads tab.
My site is behind a CDN or proxy and visitors get “too many submissions”.
The rate limit uses the visitor’s IP address. Behind a proxy every visitor can look the same. Use the convohub_client_ip filter to return the real client IP from the header your proxy sets.
Does the webhook work on a local or staging site?
ConvoHub must be able to reach your site over the internet using HTTPS, so local addresses cannot receive events.
How do I limit webhook request sizes before they reach PHP?
Ask your hosting provider to enforce a maximum request body of 1 MiB (1,048,576 bytes) at the web server or reverse proxy for ConvoHub webhook traffic. This must cover both /wp-json/convohub/v1/webhook and the equivalent ?rest_route=/convohub/v1/webhook URL, including rewritten routes. The server must count actual incoming bytes, including chunked requests; checking Content-Length alone is insufficient.
The plugin returns HTTP 413 for an oversized body, including before WordPress JSON decoding, but PHP and WordPress have already buffered that body. A plugin callback cannot impose a limit before PHP receives it. The lead endpoint also applies a 32 KiB application limit; the host can enforce that stricter limit upstream where routing permits.
What happens to my data when I uninstall the plugin?
Deleting the plugin removes its settings, undelivered leads, scheduled retries and temporary data from your database. Data already sent to ConvoHub stays in your ConvoHub account.
Screenshots
Changelog
0.4.5
- Protect queued leads from account-switch races, overlapping retries, storage failures and indefinite retention.
- Export and erase all queued leads in batches, including consent and campaign metadata.
- Reject oversized public JSON before parsing, and reject malformed email addresses without changing recipients.
- Repair missing retries, resume work after activation, and fully clean plugin storage on uninstall.
- Add icon license notices and improve source lint and compatibility checks.
0.4.4
- The Connection tab links to ConvoHub signup for people without an account. New accounts include a 7-day trial.
0.4.3
- WordPress.org plugin page assets: banners, icons and screenshots.
0.4.2
- The plugin always connects to ConvoHub. The address is no longer a saved setting, so it cannot be changed in the database.
0.4.1
- The lead form’s look is chosen with fields (button colour, corners, spacing, width) instead of a custom CSS box. CSS saved by earlier versions is no longer used; it is shown once on the Leads tab so you can copy it into Additional CSS.
- The External services section links ConvoHub’s Terms of Service and Privacy Policy.
0.4.0
- Connect with one key. In ConvoHub open Settings > Integrations > WordPress, generate a key and paste it on the Connection tab. The plugin always uses ConvoHub, so there is no URL to type.
- The Connection tab shows the account, who connected it, when, and which key was used, and has a Disconnect button. A key works once and is never saved.
- Sites connected with an API access token keep working. The Connection tab asks you to replace the token with a key; the inbox, identity validation and webhook settings stay when the key is for the same account.
- The Help tab explains the key, every message a refused key can show, and Disconnect. Diagnostics report how the site is connected.
- Plugin Initial commit.




