VisWapp Chat Widget
| 开发者 | vectorilo |
|---|---|
| 更新时间 | 2026年10月17日 01:56 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Paste the snippet once; the plugin reads your widget ID and settings from it.
- Show the widget on every page, every page except some, or only some pages.
- Hide it from roles such as Administrator or Shop manager.
- Optional: identify logged-in customers so chats arrive with their name, email and phone (WooCommerce billing phone supported). Identities are signed on your server with your Identity secret, which never reaches the browser.
- When an identified customer logs out, their chat is cleared from that browser.
- Login with WhatsApp: a "Continue with WhatsApp" button on the WordPress login page, WooCommerce My account and checkout, or anywhere with the [viswapp_login] shortcode. WhatsApp opens with a message ready; the customer taps send and is logged in. Existing users are matched by WhatsApp number or WooCommerce billing phone; new numbers can get an account automatically.
- Lead forms: add a form from VisWapp → Web Forms to any page with the "VisWapp form" block or the [viswapp_form] shortcode, in the page or as a popup button. Every response becomes a VisWapp contact and can create a lead, send a WhatsApp message, add a Google Sheet row or call your webhook.
- Abandoned cart recovery (WooCommerce): carts are sent to VisWapp once the shopper's phone or email is known, and VisWapp sends a WhatsApp reminder with a link that restores the cart and opens checkout.
安装:
- In WordPress, go to Plugins → Add New → Upload Plugin, choose viswapp-chat-widget.zip, then Install Now and Activate.
- In VisWapp, open Chat Widget, save your widget, and copy the Install snippet.
- In WordPress, go to Settings → VisWapp, open the Chat widget tab, paste the snippet, and Save Changes.
- In VisWapp, add your site's domain under Chat Widget → Domains & identity → Allowed websites.
- Open your site in a private window: the chat bubble appears in the corner.
- In VisWapp, copy the Identity secret from Chat Widget → Domains & identity.
- In WordPress, on the plugin's settings page, turn on "Identify logged-in users", paste the secret, and save.
- In VisWapp, open Integrations → WhatsApp Login. Under Setup add your site's domain to Allowed domains, and add the Redirect URL shown on the plugin's settings page.
- Under Developers, copy the Client ID and the Client secret (Reveal).
- In WordPress, go to Settings → VisWapp, open the Login with WhatsApp tab, turn it on, paste both, choose where the button shows, and save.
- In VisWapp, click Go live when you are ready (test mode works on your allowed domains too).
- In VisWapp, build and publish a form under Web Forms, and copy its form key (vw_frm_…) from the Share tab.
- In WordPress, add the "VisWapp form" block to a page and paste the key, or use the shortcode [viswapp_form id="vw_frm_…"].
- Forms use the chat widget's API address. Without the chat widget, paste the form's "Embed on a page" code in Settings → VisWapp → Web forms.
- In VisWapp, open Integrations → WooCommerce → Abandoned carts and copy the Delivery URL and the Webhook secret.
- In WordPress, go to Settings → VisWapp, open the WooCommerce tab, turn on "Capture abandoned carts", paste both, and save.
- Click "Send test event". "HTTP 200" means VisWapp received a signed test cart.
屏幕截图:
常见问题:
How do I add a lead form?
Add the "VisWapp form" block and paste the form key (vw_frm_…) from VisWapp → Web Forms → Share, or use [viswapp_form id="vw_frm_…"]. Set mode="popup" for a floating button instead. The form must be published in VisWapp; until then visitors see that it is not accepting responses.
The form says it is not available on this website
The form only allows some websites. In VisWapp → Web Forms → Share → Where can it be embedded?, add your site's domain.
Can I put the WhatsApp login button on my own page?
Yes, with the shortcode: [viswapp_login label="Sign up with WhatsApp" redirect="/my-account/"] Or link any button to /wp-json/viswapp/v1/login/start to use the hosted VisWapp login page.
How are WhatsApp logins matched to users?
By the viswapp_phone user meta (set on first login), then the WooCommerce billing phone. Developers can change this with the viswapp_login_find_user filter, and react to logins with the viswapp_login_success action: add_action( 'viswapp_login_success', function ( $user, $claims ) { // $claims: phone_number, name, whatsapp_opt_in, new_user, ... }, 10, 2 );
The chat bubble doesn't appear
Check that the settings page says "The widget is live on your site", that your domain is in Allowed websites in VisWapp, and that you are not logged in with a role you chose to hide it from. Clear your caching plugin's cache after saving.
Does it work with caching plugins?
Yes. The widget loads in the browser, so cached pages show it. If you identify logged-in users, make sure pages for logged-in visitors are not cached (most caching plugins already skip them).
Can a developer change what is sent for a customer?
Yes, with the viswapp_widget_identity filter. Return null to skip identifying a user: add_filter( 'viswapp_widget_identity', function ( $identity, $user ) { $identity['phone'] = get_user_meta( $user->ID, 'mobile', true ); return $identity; }, 10, 2 ); Use the viswapp_widget_show filter to show or hide the widget on a request: add_filter( 'viswapp_widget_show', function ( $show ) { return $show && ! is_page( 'careers' ); } );
Can I open the chat from my own button?
Yes. Add this to the button's link or a script on the page: Chat with us
Does abandoned cart capture work with caching plugins?
Yes, as long as the cart and checkout pages are not cached (WooCommerce tells caching plugins not to cache them). Carts are sent from the server during the request that changed them, so a cached product page doesn't stop capture.
What happens when I delete the plugin?
Its settings (including the Web forms tab), the saved Identity secret, the WhatsApp Login and abandoned-cart secrets, and saved cart links are removed from WordPress. Chats, contacts and carts stay in VisWapp.
更新日志:
- Lead forms from VisWapp → Web Forms: the "VisWapp form" block (with a preview of the form in the editor) and the [viswapp_form] shortcode, in the page or as a popup button. The forms script loads only on pages with a form.
- Settings → VisWapp → Web forms tab: paste a form's embed code, or let forms use the chat widget's API address.
- The chat widget tells VisWapp the page language (data-lang, follows WPML / Polylang / TranslatePress), so multi-language chat flows can open in it. Filter: viswapp_widget_language.
- Abandoned cart recovery for WooCommerce: signed cart.updated / cart.converted events to VisWapp, guest phone and email capture on the classic and block checkout, optional WhatsApp consent checkbox, cart links that rebuild the cart and open checkout (with an optional coupon), and a Send test event button.
- Privacy policy suggestion for the data sent to VisWapp.
- Login with WhatsApp inside WhatsApp's own browser: the Continue button in WhatsApp's reply signs the customer in and brings them back to the page they were on.
- login.js is loaded with the plugin version, so updates reach browsers straight away.
- Login with WhatsApp: wp-login, WooCommerce My account and checkout, [viswapp_login] shortcode, hosted login page and chat-flow sign-in links.
- First release.