Changeset 3774969

Timestamp:

10/30/2026 10:51:28 AM (35 hours ago)

Author:

techshah

Message:

Version 1.2.0: connect WhatsApp from the plugin

Location:

clientager

Files:

• tags/1.2.0 (copied) (copied from clientager/trunk )
• tags/1.2.0/assets/admin.css (modified) (1 diff)
• tags/1.2.0/assets/admin.js (modified) (1 diff)
• tags/1.2.0/clientager.php (modified) (2 diffs)
• tags/1.2.0/includes/class-clientager-admin.php (modified) (5 diffs)
• tags/1.2.0/readme.txt (modified) (4 diffs)
• trunk/assets/admin.css (modified) (1 diff)
• trunk/assets/admin.js (modified) (1 diff)
• trunk/clientager.php (modified) (2 diffs)
• trunk/includes/class-clientager-admin.php (modified) (5 diffs)
• trunk/readme.txt (modified) (4 diffs)

clientager/tags/1.2.0/assets/admin.css

@@ -728 +728 @@
 .cg-form-fields { gap: 20px; }
 @media (max-width: 600px) { .cg-form-field { gap: 8px; } }
+
+/* WhatsApp card (Settings → Chat & websites) */
+.cg-wa-list { list-style: none; margin: 4px 0 0; padding: 0; display: flex; flex-direction: column; gap: 10px; }
+.cg-wa-list li { display: flex; align-items: flex-start; gap: 10px; margin: 0; color: var(--cg-ink-2, #334155); }
+.cg-wa-list svg { flex-shrink: 0; margin-top: 1px; color: var(--cg-ok, #16a34a); }
+#clientager-wa .cg-actions { margin-top: 20px; }

clientager/tags/1.2.0/assets/admin.js

@@ -1014 +1014 @@
                 }
 
+                /* WhatsApp: Meta's sign-in runs in a pop-up on clientager.com; the page reloads when it closes. */
+                var waOn = $( 'clientager-wa-connect' );
+                if ( waOn ) {
+                        waOn.addEventListener( 'click', function () {
+                                var msg = $( 'clientager-wa-msg' );
+                                // Opened inside the click, so pop-up blockers allow it; the address comes a moment later.
+                                var win = window.open( '', 'clientager_whatsapp', 'width=560,height=760,left=' + Math.max( 0, ( screen.width - 560 ) / 2 ) + ',top=' + Math.max( 0, ( screen.height - 760 ) / 2 ) );
+                                if ( ! win ) {
+                                        say( msg, t.waBlocked, 'error' );
+                                        return;
+                                }
+                                busy( waOn, true, t.waOpening );
+                                call( 'whatsapp', { op: 'connect' } ).then( function ( r ) {
+                                        if ( ! r.success || ! r.data.url ) {
+                                                win.close();
+                                                busy( waOn, false );
+                                                say( msg, ( r.data && r.data.message ) || t.error, 'error' );
+                                                return;
+                                        }
+                                        win.location.href = r.data.url;
+                                        busy( waOn, false );
+                                        say( msg, t.waWaiting, 'info' );
+                                        if ( waOn.dataset.watching ) {
+                                                return;
+                                        }
+                                        waOn.dataset.watching = '1';
+                                        // Meta's pages can cut this page's link to the window, so the connection is checked on the server
+                                        // (every 5 seconds for 20 minutes, and when you come back to this tab).
+                                        var until = Date.now() + 20 * 60 * 1000;
+                                        var check = function () {
+                                                call( 'whatsapp', { op: 'status' } ).then( function ( s ) {
+                                                        if ( s.success && s.data.connected ) {
+                                                                window.location.reload();
+                                                        }
+                                                } );
+                                        };
+                                        var timer = setInterval( function () {
+                                                if ( Date.now() > until ) {
+                                                        clearInterval( timer );
+                                                        delete waOn.dataset.watching;
+                                                        return;
+                                                }
+                                                if ( ! document.hidden ) {
+                                                        check();
+                                                }
+                                        }, 5000 );
+                                        window.addEventListener( 'focus', check );
+                                } );
+                        } );
+                }
+                var waOff = $( 'clientager-wa-off' );
+                if ( waOff ) {
+                        waOff.addEventListener( 'click', function () {
+                                if ( ! window.confirm( t.waOff ) ) {
+                                        return;
+                                }
+                                busy( waOff, true, t.sending );
+                                call( 'whatsapp', { op: 'disconnect' } ).then( function ( r ) {
+                                        if ( r.success ) {
+                                                window.location.reload();
+                                                return;
+                                        }
+                                        busy( waOff, false );
+                                        say( $( 'clientager-wa-msg' ), ( r.data && r.data.message ) || t.error, 'error' );
+                                } );
+                        } );
+                }
+
                 /* Help: a message to the Clientager team */
                 var help = $( 'clientager-help' );

clientager/tags/1.2.0/clientager.php

@@ -4 +4 @@
  * Plugin URI:        https://www.clientager.com/wordpress
  * Description:       An AI assistant that learns your website in minutes, answers visitors 24/7, captures leads and replies to form submissions. Try it free before you pay.
- * Version:           1.1.9
+ * Version:           1.2.0
  * Requires at least: 6.0
  * Requires PHP:      7.4
@@ -20 +20 @@
 }
 
-define( 'CLIENTAGER_VERSION', '1.1.9' );
+define( 'CLIENTAGER_VERSION', '1.2.0' );
 define( 'CLIENTAGER_FILE', __FILE__ );
 define( 'CLIENTAGER_DIR', plugin_dir_path( __FILE__ ) );

clientager/tags/1.2.0/includes/class-clientager-admin.php

@@ -75 +75 @@
                 add_action( 'in_admin_header', array( __CLASS__, 'hide_notices' ), 1000 );
                 add_action( 'admin_post_clientager_leads_csv', array( __CLASS__, 'leads_csv' ) );
-                foreach ( array( 'connect_start', 'connect_verify', 'learn', 'preview', 'live', 'widget_save', 'notify_save', 'origins_save', 'convo_reply', 'disconnect', 'trial', 'request_update', 'form_save', 'email_look', 'chat_rules', 'review', 'lead_status', 'help' ) as $action ) {
+                foreach ( array( 'connect_start', 'connect_verify', 'learn', 'preview', 'live', 'widget_save', 'notify_save', 'origins_save', 'convo_reply', 'disconnect', 'trial', 'request_update', 'form_save', 'email_look', 'chat_rules', 'review', 'lead_status', 'help', 'whatsapp' ) as $action ) {
                         add_action( 'wp_ajax_clientager_' . $action, array( __CLASS__, 'ajax_' . $action ) );
                 }
@@ -172 +172 @@
                                         'saved'        => __( 'Saved. Your chat uses the new settings now.', 'clientager' ),
                                         'savedLimits'  => __( 'Saved. New messages follow these limits.', 'clientager' ),
+                                        'waOpening'    => __( 'Opening the secure WhatsApp window…', 'clientager' ),
+                                        'waWaiting'    => __( 'Finish the steps in the WhatsApp window. This page updates by itself when you are done.', 'clientager' ),
+                                        'waBlocked'    => __( 'Your browser blocked the window. Allow pop-ups for this page and try again.', 'clientager' ),
+                                        'waOff'        => __( 'Disconnect WhatsApp? Your AI stops answering it. The number stays yours.', 'clientager' ),
                                         'helpSent'     => __( 'Thanks, we got your message. We will reply to your email, usually within one business day.', 'clientager' ),
                                         'badColor'     => __( 'Pick a colour like #2563eb.', 'clientager' ),
@@ -1980 +1984 @@
                                         </div>
 
+                                        <?php self::whatsapp_card(); ?>
                                         <?php self::origins_card( $s ); ?>
                                         <?php self::chat_rules_card( $s ); ?>
@@ -2062 +2067 @@
                                 </section>
                         </div>
+                </div>
+                <?php
+        }
+
+        /**
+         * WhatsApp: the connected number, or Connect (Meta's sign-in opens in a pop-up on clientager.com).
+         */
+        private static function whatsapp_card() {
+                $res  = Clientager_Api::request( 'GET', '/whatsapp' );
+                $wa   = $res['ok'] && is_array( $res['data'] ) ? $res['data'] : array();
+                $conn = ! empty( $wa['connected']['number'] ) ? $wa['connected'] : null;
+                ?>
+                <div class="cg-card" id="clientager-wa">
+                        <?php self::card_head( __( 'WhatsApp', 'clientager' ), __( 'Your AI answers customers on your own WhatsApp number, 24/7.', 'clientager' ), 'whatsapp' ); ?>
+                        <?php if ( $conn ) : ?>
+                                <div class="cg-switch-row">
+                                        <div>
+                                                <strong><?php esc_html_e( 'Connected', 'clientager' ); ?></strong>
+                                                <span>
+                                                <?php
+                                                /* translators: %s: WhatsApp phone number. */
+                                                echo esc_html( sprintf( __( 'Your AI answers WhatsApp messages on %s.', 'clientager' ), (string) $conn['number'] ) );
+                                                ?>
+                                                </span>
+                                        </div>
+                                        <span class="cg-badge is-won"><?php esc_html_e( 'Live', 'clientager' ); ?></span>
+                                </div>
+                                <div class="cg-actions">
+                                        <a class="cg-btn cg-btn-secondary" href="<?php echo esc_url( 'https://wa.me/' . preg_replace( '/\D/', '', (string) $conn['number'] ) ); ?>" target="_blank" rel="noopener"><?php self::icon( 'whatsapp' ); ?><?php esc_html_e( 'Send a test message', 'clientager' ); ?></a>
+                                        <button type="button" class="cg-btn cg-btn-secondary" id="clientager-wa-off"><?php esc_html_e( 'Disconnect', 'clientager' ); ?></button>
+                                </div>
+                                <p class="cg-help"><?php echo esc_html( ! empty( $conn['app'] ) ? __( 'You can keep using the WhatsApp Business app. When you reply from the app, the AI leaves that chat to you.', 'clientager' ) : __( 'Chats show up in your Inbox, where you can take over any time.', 'clientager' ) ); ?></p>
+                        <?php elseif ( empty( $wa['allowed'] ) ) : ?>
+                                <p class="cg-help"><?php esc_html_e( 'Included in the 7-day free trial and from the Starter plan. Choose a plan to connect your number.', 'clientager' ); ?></p>
+                        <?php elseif ( empty( $wa['available'] ) ) : ?>
+                                <p class="cg-help"><?php esc_html_e( 'WhatsApp connect opens soon. We will email you when you can connect your number.', 'clientager' ); ?></p>
+                        <?php else : ?>
+                                <ul class="cg-wa-list">
+                                        <li><?php self::icon( 'check' ); ?><?php esc_html_e( 'Use a new number, or the one on your WhatsApp Business app (you keep the app and your chats).', 'clientager' ); ?></li>
+                                        <li><?php self::icon( 'check' ); ?><?php esc_html_e( 'Sign in with Facebook in a secure window. Takes about 5 minutes.', 'clientager' ); ?></li>
+                                        <li><?php self::icon( 'check' ); ?><?php esc_html_e( 'The number stays yours. Replies within 24 hours of a customer message are free.', 'clientager' ); ?></li>
+                                </ul>
+                                <div class="cg-actions"><button type="button" class="cg-btn cg-btn-primary" id="clientager-wa-connect"><?php self::icon( 'whatsapp' ); ?><?php esc_html_e( 'Connect WhatsApp', 'clientager' ); ?></button></div>
+                        <?php endif; ?>
+                        <div id="clientager-wa-msg" class="clientager-msg" role="status" aria-live="polite"></div>
                 </div>
                 <?php
@@ -2779 +2829 @@
 
         /**
+         * WhatsApp: op=connect returns the sign-in address (on clientager.com, valid 30 minutes), op=status says whether a
+         * number is connected, op=disconnect stops it.
+         */
+        public static function ajax_whatsapp() {
+                check_ajax_referer( self::NONCE, 'nonce' );
+                self::guard();
+                $op = isset( $_POST['op'] ) ? sanitize_key( wp_unslash( $_POST['op'] ) ) : '';
+                if ( 'disconnect' === $op ) {
+                        self::reply( Clientager_Api::request( 'POST', '/whatsapp', array( 'action' => 'disconnect' ) ) );
+                }
+                $res = Clientager_Api::request( 'GET', '/whatsapp' );
+                if ( 'status' === $op ) {
+                        self::reply( $res, array( 'connected' => ! empty( $res['data']['connected'] ) ) );
+                }
+                $url = $res['ok'] && ! empty( $res['data']['connect_url'] ) ? esc_url_raw( (string) $res['data']['connect_url'] ) : '';
+                if ( $res['ok'] && ! $url ) {
+                        $res = array( 'ok' => false, 'status' => 409, 'code' => 'wa_unavailable', 'error' => ! empty( $res['data']['connected'] ) ? __( 'WhatsApp is already connected. Reload this page.', 'clientager' ) : __( 'WhatsApp cannot be connected on this plan yet.', 'clientager' ), 'data' => array() );
+                }
+                self::reply( $res, array( 'url' => $url, 'connected' => ! empty( $res['data']['connected'] ) ) );
+        }
+
+        /**
          * Saves the contact form's fields, texts and look. The server checks them again and is the only place they are stored.
          */

clientager/tags/1.2.0/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.1.9
+Stable tag: 1.2.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -61 +61 @@
 * **When a WooCommerce order is paid after the shopper chatted with the AI:** the order id, order number, total and currency, with the chat's id, for the "Sales made by AI" card. No customer or product details are sent. The chat window sets a first-party cookie (clientager_chat, 30 days) holding only a random chat id once the AI has replied, so the order can be matched to that chat.
 * **When you send a message from the Help tab:** what you wrote, the type you picked (question, problem or feature request), the reply-to email you entered, your site address and the plugin version, so our team can answer you by email.
+* **When you connect WhatsApp (Settings):** a request for a short-lived sign-in link. Facebook's sign-in then opens in a window on app.clientager.com; your Facebook password goes only to Facebook, and Clientager receives permission to send and receive WhatsApp messages for the number you choose ([Meta Privacy Policy](https://www.facebook.com/privacy/policy/)).
 * **When you disconnect or delete the plugin:** a request to disconnect this site.
 
@@ -125 +126 @@
 
 == Changelog ==
+
+= 1.2.0 =
+* Connect WhatsApp from the plugin: Settings → Chat & websites → Connect WhatsApp. Sign in with Facebook in a secure window and your AI answers your own WhatsApp number (new number or your WhatsApp Business app number). Included in the free trial and from Starter.
 
 = 1.1.9 =
@@ -195 +199 @@
 == Upgrade Notice ==
 
+= 1.2.0 =
+Connect your WhatsApp number right from the plugin.
+
 = 1.1.9 =
 Faster screens without page reloads, Settings in clear sections, and product cards in the preview.

clientager/trunk/assets/admin.css

@@ -728 +728 @@
 .cg-form-fields { gap: 20px; }
 @media (max-width: 600px) { .cg-form-field { gap: 8px; } }
+
+/* WhatsApp card (Settings → Chat & websites) */
+.cg-wa-list { list-style: none; margin: 4px 0 0; padding: 0; display: flex; flex-direction: column; gap: 10px; }
+.cg-wa-list li { display: flex; align-items: flex-start; gap: 10px; margin: 0; color: var(--cg-ink-2, #334155); }
+.cg-wa-list svg { flex-shrink: 0; margin-top: 1px; color: var(--cg-ok, #16a34a); }
+#clientager-wa .cg-actions { margin-top: 20px; }

clientager/trunk/assets/admin.js

@@ -1014 +1014 @@
                 }
 
+                /* WhatsApp: Meta's sign-in runs in a pop-up on clientager.com; the page reloads when it closes. */
+                var waOn = $( 'clientager-wa-connect' );
+                if ( waOn ) {
+                        waOn.addEventListener( 'click', function () {
+                                var msg = $( 'clientager-wa-msg' );
+                                // Opened inside the click, so pop-up blockers allow it; the address comes a moment later.
+                                var win = window.open( '', 'clientager_whatsapp', 'width=560,height=760,left=' + Math.max( 0, ( screen.width - 560 ) / 2 ) + ',top=' + Math.max( 0, ( screen.height - 760 ) / 2 ) );
+                                if ( ! win ) {
+                                        say( msg, t.waBlocked, 'error' );
+                                        return;
+                                }
+                                busy( waOn, true, t.waOpening );
+                                call( 'whatsapp', { op: 'connect' } ).then( function ( r ) {
+                                        if ( ! r.success || ! r.data.url ) {
+                                                win.close();
+                                                busy( waOn, false );
+                                                say( msg, ( r.data && r.data.message ) || t.error, 'error' );
+                                                return;
+                                        }
+                                        win.location.href = r.data.url;
+                                        busy( waOn, false );
+                                        say( msg, t.waWaiting, 'info' );
+                                        if ( waOn.dataset.watching ) {
+                                                return;
+                                        }
+                                        waOn.dataset.watching = '1';
+                                        // Meta's pages can cut this page's link to the window, so the connection is checked on the server
+                                        // (every 5 seconds for 20 minutes, and when you come back to this tab).
+                                        var until = Date.now() + 20 * 60 * 1000;
+                                        var check = function () {
+                                                call( 'whatsapp', { op: 'status' } ).then( function ( s ) {
+                                                        if ( s.success && s.data.connected ) {
+                                                                window.location.reload();
+                                                        }
+                                                } );
+                                        };
+                                        var timer = setInterval( function () {
+                                                if ( Date.now() > until ) {
+                                                        clearInterval( timer );
+                                                        delete waOn.dataset.watching;
+                                                        return;
+                                                }
+                                                if ( ! document.hidden ) {
+                                                        check();
+                                                }
+                                        }, 5000 );
+                                        window.addEventListener( 'focus', check );
+                                } );
+                        } );
+                }
+                var waOff = $( 'clientager-wa-off' );
+                if ( waOff ) {
+                        waOff.addEventListener( 'click', function () {
+                                if ( ! window.confirm( t.waOff ) ) {
+                                        return;
+                                }
+                                busy( waOff, true, t.sending );
+                                call( 'whatsapp', { op: 'disconnect' } ).then( function ( r ) {
+                                        if ( r.success ) {
+                                                window.location.reload();
+                                                return;
+                                        }
+                                        busy( waOff, false );
+                                        say( $( 'clientager-wa-msg' ), ( r.data && r.data.message ) || t.error, 'error' );
+                                } );
+                        } );
+                }
+
                 /* Help: a message to the Clientager team */
                 var help = $( 'clientager-help' );

clientager/trunk/clientager.php

@@ -4 +4 @@
  * Plugin URI:        https://www.clientager.com/wordpress
  * Description:       An AI assistant that learns your website in minutes, answers visitors 24/7, captures leads and replies to form submissions. Try it free before you pay.
- * Version:           1.1.9
+ * Version:           1.2.0
  * Requires at least: 6.0
  * Requires PHP:      7.4
@@ -20 +20 @@
 }
 
-define( 'CLIENTAGER_VERSION', '1.1.9' );
+define( 'CLIENTAGER_VERSION', '1.2.0' );
 define( 'CLIENTAGER_FILE', __FILE__ );
 define( 'CLIENTAGER_DIR', plugin_dir_path( __FILE__ ) );

clientager/trunk/includes/class-clientager-admin.php

@@ -75 +75 @@
                 add_action( 'in_admin_header', array( __CLASS__, 'hide_notices' ), 1000 );
                 add_action( 'admin_post_clientager_leads_csv', array( __CLASS__, 'leads_csv' ) );
-                foreach ( array( 'connect_start', 'connect_verify', 'learn', 'preview', 'live', 'widget_save', 'notify_save', 'origins_save', 'convo_reply', 'disconnect', 'trial', 'request_update', 'form_save', 'email_look', 'chat_rules', 'review', 'lead_status', 'help' ) as $action ) {
+                foreach ( array( 'connect_start', 'connect_verify', 'learn', 'preview', 'live', 'widget_save', 'notify_save', 'origins_save', 'convo_reply', 'disconnect', 'trial', 'request_update', 'form_save', 'email_look', 'chat_rules', 'review', 'lead_status', 'help', 'whatsapp' ) as $action ) {
                         add_action( 'wp_ajax_clientager_' . $action, array( __CLASS__, 'ajax_' . $action ) );
                 }
@@ -172 +172 @@
                                         'saved'        => __( 'Saved. Your chat uses the new settings now.', 'clientager' ),
                                         'savedLimits'  => __( 'Saved. New messages follow these limits.', 'clientager' ),
+                                        'waOpening'    => __( 'Opening the secure WhatsApp window…', 'clientager' ),
+                                        'waWaiting'    => __( 'Finish the steps in the WhatsApp window. This page updates by itself when you are done.', 'clientager' ),
+                                        'waBlocked'    => __( 'Your browser blocked the window. Allow pop-ups for this page and try again.', 'clientager' ),
+                                        'waOff'        => __( 'Disconnect WhatsApp? Your AI stops answering it. The number stays yours.', 'clientager' ),
                                         'helpSent'     => __( 'Thanks, we got your message. We will reply to your email, usually within one business day.', 'clientager' ),
                                         'badColor'     => __( 'Pick a colour like #2563eb.', 'clientager' ),
@@ -1980 +1984 @@
                                         </div>
 
+                                        <?php self::whatsapp_card(); ?>
                                         <?php self::origins_card( $s ); ?>
                                         <?php self::chat_rules_card( $s ); ?>
@@ -2062 +2067 @@
                                 </section>
                         </div>
+                </div>
+                <?php
+        }
+
+        /**
+         * WhatsApp: the connected number, or Connect (Meta's sign-in opens in a pop-up on clientager.com).
+         */
+        private static function whatsapp_card() {
+                $res  = Clientager_Api::request( 'GET', '/whatsapp' );
+                $wa   = $res['ok'] && is_array( $res['data'] ) ? $res['data'] : array();
+                $conn = ! empty( $wa['connected']['number'] ) ? $wa['connected'] : null;
+                ?>
+                <div class="cg-card" id="clientager-wa">
+                        <?php self::card_head( __( 'WhatsApp', 'clientager' ), __( 'Your AI answers customers on your own WhatsApp number, 24/7.', 'clientager' ), 'whatsapp' ); ?>
+                        <?php if ( $conn ) : ?>
+                                <div class="cg-switch-row">
+                                        <div>
+                                                <strong><?php esc_html_e( 'Connected', 'clientager' ); ?></strong>
+                                                <span>
+                                                <?php
+                                                /* translators: %s: WhatsApp phone number. */
+                                                echo esc_html( sprintf( __( 'Your AI answers WhatsApp messages on %s.', 'clientager' ), (string) $conn['number'] ) );
+                                                ?>
+                                                </span>
+                                        </div>
+                                        <span class="cg-badge is-won"><?php esc_html_e( 'Live', 'clientager' ); ?></span>
+                                </div>
+                                <div class="cg-actions">
+                                        <a class="cg-btn cg-btn-secondary" href="<?php echo esc_url( 'https://wa.me/' . preg_replace( '/\D/', '', (string) $conn['number'] ) ); ?>" target="_blank" rel="noopener"><?php self::icon( 'whatsapp' ); ?><?php esc_html_e( 'Send a test message', 'clientager' ); ?></a>
+                                        <button type="button" class="cg-btn cg-btn-secondary" id="clientager-wa-off"><?php esc_html_e( 'Disconnect', 'clientager' ); ?></button>
+                                </div>
+                                <p class="cg-help"><?php echo esc_html( ! empty( $conn['app'] ) ? __( 'You can keep using the WhatsApp Business app. When you reply from the app, the AI leaves that chat to you.', 'clientager' ) : __( 'Chats show up in your Inbox, where you can take over any time.', 'clientager' ) ); ?></p>
+                        <?php elseif ( empty( $wa['allowed'] ) ) : ?>
+                                <p class="cg-help"><?php esc_html_e( 'Included in the 7-day free trial and from the Starter plan. Choose a plan to connect your number.', 'clientager' ); ?></p>
+                        <?php elseif ( empty( $wa['available'] ) ) : ?>
+                                <p class="cg-help"><?php esc_html_e( 'WhatsApp connect opens soon. We will email you when you can connect your number.', 'clientager' ); ?></p>
+                        <?php else : ?>
+                                <ul class="cg-wa-list">
+                                        <li><?php self::icon( 'check' ); ?><?php esc_html_e( 'Use a new number, or the one on your WhatsApp Business app (you keep the app and your chats).', 'clientager' ); ?></li>
+                                        <li><?php self::icon( 'check' ); ?><?php esc_html_e( 'Sign in with Facebook in a secure window. Takes about 5 minutes.', 'clientager' ); ?></li>
+                                        <li><?php self::icon( 'check' ); ?><?php esc_html_e( 'The number stays yours. Replies within 24 hours of a customer message are free.', 'clientager' ); ?></li>
+                                </ul>
+                                <div class="cg-actions"><button type="button" class="cg-btn cg-btn-primary" id="clientager-wa-connect"><?php self::icon( 'whatsapp' ); ?><?php esc_html_e( 'Connect WhatsApp', 'clientager' ); ?></button></div>
+                        <?php endif; ?>
+                        <div id="clientager-wa-msg" class="clientager-msg" role="status" aria-live="polite"></div>
                 </div>
                 <?php
@@ -2779 +2829 @@
 
         /**
+         * WhatsApp: op=connect returns the sign-in address (on clientager.com, valid 30 minutes), op=status says whether a
+         * number is connected, op=disconnect stops it.
+         */
+        public static function ajax_whatsapp() {
+                check_ajax_referer( self::NONCE, 'nonce' );
+                self::guard();
+                $op = isset( $_POST['op'] ) ? sanitize_key( wp_unslash( $_POST['op'] ) ) : '';
+                if ( 'disconnect' === $op ) {
+                        self::reply( Clientager_Api::request( 'POST', '/whatsapp', array( 'action' => 'disconnect' ) ) );
+                }
+                $res = Clientager_Api::request( 'GET', '/whatsapp' );
+                if ( 'status' === $op ) {
+                        self::reply( $res, array( 'connected' => ! empty( $res['data']['connected'] ) ) );
+                }
+                $url = $res['ok'] && ! empty( $res['data']['connect_url'] ) ? esc_url_raw( (string) $res['data']['connect_url'] ) : '';
+                if ( $res['ok'] && ! $url ) {
+                        $res = array( 'ok' => false, 'status' => 409, 'code' => 'wa_unavailable', 'error' => ! empty( $res['data']['connected'] ) ? __( 'WhatsApp is already connected. Reload this page.', 'clientager' ) : __( 'WhatsApp cannot be connected on this plan yet.', 'clientager' ), 'data' => array() );
+                }
+                self::reply( $res, array( 'url' => $url, 'connected' => ! empty( $res['data']['connected'] ) ) );
+        }
+
+        /**
          * Saves the contact form's fields, texts and look. The server checks them again and is the only place they are stored.
          */

clientager/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.1.9
+Stable tag: 1.2.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -61 +61 @@
 * **When a WooCommerce order is paid after the shopper chatted with the AI:** the order id, order number, total and currency, with the chat's id, for the "Sales made by AI" card. No customer or product details are sent. The chat window sets a first-party cookie (clientager_chat, 30 days) holding only a random chat id once the AI has replied, so the order can be matched to that chat.
 * **When you send a message from the Help tab:** what you wrote, the type you picked (question, problem or feature request), the reply-to email you entered, your site address and the plugin version, so our team can answer you by email.
+* **When you connect WhatsApp (Settings):** a request for a short-lived sign-in link. Facebook's sign-in then opens in a window on app.clientager.com; your Facebook password goes only to Facebook, and Clientager receives permission to send and receive WhatsApp messages for the number you choose ([Meta Privacy Policy](https://www.facebook.com/privacy/policy/)).
 * **When you disconnect or delete the plugin:** a request to disconnect this site.
 
@@ -125 +126 @@
 
 == Changelog ==
+
+= 1.2.0 =
+* Connect WhatsApp from the plugin: Settings → Chat & websites → Connect WhatsApp. Sign in with Facebook in a secure window and your AI answers your own WhatsApp number (new number or your WhatsApp Business app number). Included in the free trial and from Starter.
 
 = 1.1.9 =
@@ -195 +199 @@
 == Upgrade Notice ==
 
+= 1.2.0 =
+Connect your WhatsApp number right from the plugin.
+
 = 1.1.9 =
 Faster screens without page reloads, Settings in clear sections, and product cards in the preview.