MWD AI Assistant - Local Lead Generation
| 开发者 | arashkhalaj |
|---|---|
| 更新时间 | 2026年10月22日 12:29 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Help visitors find answers about your business while they are still on your site. MWD AI Assistant uses the instructions, business details and answers you provide to respond through your own OpenAI API account. You decide what information it can use, where the chat appears and how it looks.
The free plugin is a complete assistant for answering visitor questions. It does not require an MWD account, license key or subscription. OpenAI charges separately for API usage on your own account.
Give visitors useful business answers
- Add your business name, phone number, email, contact page, address, map link and weekly opening hours.
- Write approved questions and answers about your services, policies and common enquiries. Each answer can include a public link.
- Set business instructions for the assistant's tone and scope.
- Let the assistant reply in the visitor's language, match the site's language or use a language you choose.
- Show one assistant as a floating chat widget, place it inline with
[mwd_ai_assistant], or use both.
- Test your OpenAI connection and follow the setup checklist before enabling the assistant.
- Set a daily token safety limit and message rate limits for visitors and IP addresses.
- Review recent conversations in your WordPress dashboard. Visitors can start a new chat or erase their conversation.
- Store your OpenAI API key encrypted on your server, with an option to define it in
wp-config.php. - Choose a conversation retention period from one to seven days. Expired chats are removed by scheduled cleanup.
- Use WordPress privacy export and erasure tools for visitor data.
- Your API key is encrypted on your server and never sent to the browser.
- Common email addresses, North American phone numbers and Canadian postal codes are masked in visitor messages before they are stored or sent to the AI service. Replies can include your own business contact details. This reduces exposure; it is not complete anonymization.
- Conversations expire after seven days by default (one to seven days, your choice).
- The browser keeps only a session token, never the transcript.
- No tracking, fonts or marketing calls load from third-party servers.
安装:
- Install and activate the plugin from Plugins > Add New, or upload the ZIP file.
- Open MWD AI Assistant > Setup and paste your OpenAI API key. You can create one at https://platform.openai.com/api-keys. A ChatGPT subscription does not include API credits.
- Click Test saved provider connection to confirm your key and model work.
- Write your business instructions under Assistant and add your business details, location and approved answers under Manual Knowledge.
- Turn on Enable assistant and choose Floating widget, Shortcode only, or both.
- For inline placement, add
[mwd_ai_assistant]to a Shortcode block or a page builder shortcode widget. - Review Privacy & Usage, then clear any page cache so visitors see the assistant.
常见问题:
Do I need an account with MWD?
No. You only need your own OpenAI API key. The plugin never contacts MWD during normal use.
How much does it cost to run?
The plugin is free. OpenAI charges your API account for each reply. The daily token safety limit (500,000 tokens by default) caps how much the assistant can use per day. Provider invoices are the authoritative record of your usage.
Why does the chat say it is unavailable?
Check that the assistant is enabled, that a readable API key is saved, that your OpenAI account has billing and access to the selected model, and that today's safety limit has not been reached. The Diagnostics page shows the last provider status without exposing the key.
How is my API key stored?
It is encrypted with AES-256-GCM using keys derived from your WordPress salts. Leaving the field blank keeps the saved key; Clear saved key removes it. If your salts change, enter the key again. You can also define MWDAI_CORE_OPENAI_API_KEY in wp-config.php to manage the key outside the dashboard.
How long are conversations kept?
Seven days by default, adjustable from one to seven days. Expired conversations become inaccessible immediately, and an hourly task deletes them. Deletion can be delayed while WordPress cron is disabled or the plugin is inactive, and your backups may keep older copies.
Does it work with page caching?
Yes. The widget loads its settings and a fresh session from the server, so cached pages stay correct. After changing appearance or display mode, clear your page cache.
Can many visitors chat at the same time?
Yes. The whole-site limits (3,000 new chats and 6,000 messages a minute) are far above what real visitors reach, and visitors behind one shared address (an office or a mobile network) are not refused in normal use. Each message keeps one PHP worker busy while the AI replies, so the host must have enough workers: 5 to 10 are enough for about ten people chatting at once, 20 to 30 for about a hundred active chats, and around 50 if hundreds of visitors may send at the same moment. The bundled documentation explains how to size them.
My site is behind a CDN or reverse proxy. Are rate limits shared?
Core uses the address PHP receives and does not trust forwarding headers, so visitors can share a per-IP limit behind a proxy. If you control the proxy, return the verified visitor address with the mwdai_core_client_ip filter, or raise the per-IP limit.
Can the assistant take actions or submit forms?
Core answers questions and can show approved public links. It cannot submit forms or perform actions on its own. Extensions such as the Pro add-on can register confirmed actions, which always require the visitor to confirm first.
What happens when I uninstall?
By default all data is kept. If you tick Permanently delete Core data on uninstall under Privacy & Usage, uninstalling removes this plugin's tables and settings on a single-site installation. On multisite, data is always kept. Other plugins, including the Pro add-on and its license, are not changed. Deactivating only stops the scheduled cleanup.
更新日志:
2.12.2
- Chat buttons that start a conversation (such as conversation starters from an add-on) can now hide themselves once the visitor has sent a message, also when a page is reloaded during a conversation, and come back when the conversation is reset. Developers: the widget script's
registerControl()acceptsbefore_message: true(widget API 1.2).
- Many visitors can chat at the same time: the whole-site limits of 120 messages and 120 new chats a minute are now 6,000 messages and 3,000 new chats, far above what real visitors reach, so busy moments are no longer refused. An IPv6 visitor is counted by its /64 network. The per-visitor and per-IP limits and the daily token limit still protect the site.
- Visitors behind one shared address (an office, a school, a mobile network) are no longer refused: one IP may now start 300 new chats a minute (was 15) and send 600 messages a minute by default (was 30). A per-IP message limit still at the old default of 30 is raised to 600 once; any other value you chose is kept.
- The daily token limit now counts real use: each reply reserves a realistic estimate and then counts the usage OpenAI reports, so many replies can run at once without reaching the limit early.
- When OpenAI is briefly overloaded or rate-limits a request, Core tries again (at most twice, within a few seconds) before giving up, and the visitor sees a clear "please send again in a moment" message. When the OpenAI account is out of credit, the chat stops at once with its own message and Diagnostics shows "quota".
- Manual Knowledge answers can have link text, other ways visitors ask (keywords, never shown to visitors), up to three follow-up suggestions, a priority and up to two more links. Links may now carry a query string or a fragment, such as a booking link.
- Import and export Manual Knowledge as JSON, with a preview of new, updated, unchanged and invalid rows before anything is saved; also from WP-CLI (wp mwdai knowledge import and export).
- Search, filter by visibility and publish, draft or delete several answers at once.
- Better matching: Persian and Arabic letter variants and digits, non-English capital letters, two-letter words in non-Latin scripts, and words matched from their start, so "son" no longer finds "season". A short follow-up such as "yes, send the link" still finds the answer asked about before.
- Links are shown as separate link buttons below the reply and stay after a reload; web addresses the assistant did not get from your approved answers are removed from replies.
- After a reply, the follow-up suggestions of the answer appear as buttons the visitor can tap.
- A reply can show an approved link and open a request form together. Oversized requests are shortened instead of failing, and an add-on's guidance that breaks a size or format rule is skipped and reported in Diagnostics.
- On phones and tablets, opening the chat no longer opens the keyboard by itself; the keyboard opens when the visitor taps the message field.
- On phones the open chat keeps its usual size and place, and when the keyboard leaves too little room it fills the visible part of the screen, so the chat's name and the close button always stay in view.
- The page behind the open chat no longer scrolls on phones, and it returns to the same place when the chat is closed.
- The chat header keeps its layout (logo, name and buttons) on pages built with Elementor and other page builders or themes that style images, in both the floating chat and the shortcode.
- The close button is hidden when the chat is placed on a page with the shortcode.
- Message bubbles no longer have a border; the assistant's bubble is slightly darker so it stays distinct.
- When an add-on provides a request form, the assistant opens it as soon as a visitor asks for a quote, order, booking or to be contacted, instead of asking for contact details in the chat.
- Admin pages show saved values right away: the Getting started checklist and the location count update after a save without reloading the page.
- The admin menu icon keeps its size on pages of plugins that remove other plugins' styles, such as Gravity Forms in No-Conflict Mode.
- New Business details and Location sections in Manual Knowledge, with weekly opening hours: the assistant always knows your contact details and shares them with visitors who want to visit, order, book or get in touch.
- The assistant no longer offers a request form this chat cannot send. It says so and points visitors to your contact details, and it uses your site name instead of placeholders.
- Setup now shows a Getting started checklist and a direct link to create an OpenAI API key.
- The floating chat keeps the same conversation while a visitor moves between pages.
- The widget sends its session token in its own header, so it works on sites that use HTTP Basic authentication, JWT or OAuth plugins, or hosts that strip the Authorization header.
- Expired login nonces in long-open tabs are refreshed automatically instead of failing.
- Network errors, timeouts and server error pages now show a clear message instead of technical text.
- Fixed the chat script failing to start on older Safari versions.
- A visitor can send a new message after an interrupted request without reloading the page.
- A reply that reaches the maximum output length is shown instead of reported as an error.
- Manual Knowledge now ranks the best matching answers in the database, ignoring common filler words.
- Shortcode-only mode loads the chat assets only on pages that show the assistant, and the page no longer makes a background request until a visitor chats.
- Added GPT-4.1 and GPT-4.1 nano model choices.
- Added the
mwdai_core_client_ipfilter for sites behind a trusted proxy. - Updated the Upgrade page for the Pro add-on and refreshed the bundled documentation.
- Extension API 1.9 for the Pro add-on: settings validation, conversation erase and bounded cleanup helpers.
- Rebuilt as an independent free Core with its own storage, one chat engine and a versioned extension API.