Intégration WordPress

Business Messaging for WbizTool est le plugin WordPress officiel. Il envoie des messages WhatsApp depuis votre numéro connecté lorsqu'un événement se produit sur votre site : le statut d'une commande WooCommerce change, une réservation WP Amelia est reprogrammée ou annulée, ou un formulaire Contact Form 7 est envoyé.

Avant de commencer#

• Un compte Wbiztool avec un numéro WhatsApp connecté dans les paramètres WhatsApp.
• Votre Client ID et votre clé API, disponibles dans Paramètres → Clés API.
• Le WhatsApp Client ID du numéro d'envoi, affiché dans les paramètres WhatsApp.

Installer le plugin#

1. Installez-le depuis WordPress

   Dans l'administration WordPress, allez dans Plugins → Add New (Extensions → Ajouter en français), recherchez Business Messaging for WbizTool, cliquez sur Install Now (Installer maintenant) puis sur Activate (Activer). Vous pouvez aussi le télécharger depuis le répertoire des extensions WordPress et téléverser le fichier zip via Plugins → Add New → Upload Plugin (Extensions → Ajouter → Téléverser une extension). Si le téléversement échoue (par exemple à cause d'une limite de taille de fichier), décompressez le fichier et copiez le dossier business-messaging-for-wbiztool dans /wp-content/plugins/ par FTP, puis activez le plugin dans Plugins (Extensions).

2. Ouvrez les réglages du plugin

   Un nouveau menu WbizTool apparaît dans la barre latérale de l'administration, avec quatre pages : Settings (réglages), Templates (modèles), Test Messages (messages de test) et Logs (journaux).

Configurer le plugin#

1. Saisissez vos identifiants API

   Sur WbizTool → Settings, sous API Configuration (configuration de l'API), renseignez Client ID, API Key et WhatsApp Client ID, puis cliquez sur Test Connection (tester la connexion).

   Avec des identifiants corrects, Test Connection met en file d'attente un vrai message de test vers le numéro fictif 10000000000 : il apparaît donc dans votre historique des messages Wbiztool. Il ne peut pas être remis et y apparaît en échec ; vous pouvez l'ignorer. Si vous voyez Unable to connect to WbizTool API. Please check your internet connection. (impossible de se connecter à l'API WbizTool), votre Client ID, votre clé API ou votre WhatsApp Client ID est très probablement incorrect, ou votre forfait n'a plus de messages. Cela indique rarement un problème de connexion Internet.

2. Définissez les options générales

   Sous General Settings (réglages généraux) :

   • Default Country Code (indicatif pays par défaut) : utilisé lorsque le pays de facturation d'une commande WooCommerce ne peut pas être associé à un indicatif téléphonique. La valeur par défaut est 1 : remplacez-la par celle de votre pays principal, par exemple 91.
   • Test Mode (mode test) : lorsqu'il est activé, les messages sont inscrits dans le journal mais ne sont pas envoyés.
   • Admin Notifications (notifications admin) : cette case n'a aucun effet visible dans la version 1.0.3, car la page de réglages ne propose pas de champ pour le numéro de téléphone admin qu'elle utilise. Pour recevoir des alertes admin lors de l'envoi de formulaires, utilisez les réglages Contact Form 7 ci-dessous.

3. Activez les intégrations et les événements

   Sous Integration Settings (réglages des intégrations), activez chaque plugin que vous utilisez et cochez les événements qui doivent envoyer un message. Une intégration n'affiche ses options que si le plugin correspondant est actif sur votre site. Cliquez sur Save Settings (enregistrer les réglages).

4. Modifiez les modèles de message

   Sur WbizTool → Templates, choisissez l'onglet WooCommerce, Amelia ou Contact Form 7, sélectionnez un événement et modifiez son texte. La page liste les variables utilisables et affiche un aperçu en direct. Reset (réinitialiser) restaure le texte par défaut.

5. Envoyez un test

   Sur WbizTool → Test Messages, envoyez un message à votre propre numéro pour vérifier que tout fonctionne, puis consultez WbizTool → Logs.

WooCommerce#

Les messages sont envoyés au téléphone de facturation de la commande. L'indicatif pays est déterminé à partir du pays de facturation ; si ce pays n'est pas reconnu, le Default Country Code est utilisé.

Variables de modèle :

Exemple de modèle :

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Les messages sont envoyés au téléphone du client indiqué dans la réservation. La page de réglages liste six événements :

• Booking Added (Frontend bookings) (réservation ajoutée depuis le site)
• Booking Rescheduled (réservation reprogrammée)
• Booking Cancelled (réservation annulée)
• Appointment Added (Backend) (rendez-vous ajouté depuis l'administration)
• Event Booking Saved (réservation d'événement enregistrée)
• Event Booking Updated (réservation d'événement mise à jour)

Variables disponibles dans les modèles Amelia :

Contact Form 7#

Lorsqu'un formulaire est envoyé, le plugin peut vous écrire (à l'administrateur), écrire à la personne qui a rempli le formulaire, ou les deux.

Le plugin retrouve le nom, l'email, le téléphone et le message dans votre formulaire grâce au nom des champs. Utilisez des noms courants comme your-name, your-email, your-phone (ou phone, mobile, whatsapp), your-subject et your-message. La réponse automatique au client n'est envoyée que si un champ de téléphone est trouvé. Demandez le numéro avec son indicatif pays : le plugin ne reconnaît que certains indicatifs et utilise sinon le Default Country Code.

Variables de modèle :

Chaque champ du formulaire est aussi disponible sous son propre nom, les tirets étant remplacés par des tirets bas. Par exemple, un champ nommé your-city devient {your_city}.

Exemple de notification pour l'administrateur :

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Les retours à la ligne du message du visiteur sont supprimés : {message} arrive donc sur une seule ligne.

Journaux#

WbizTool → Logs liste les messages que le plugin a tenté d'envoyer, avec la date, le type d'événement, l'intégration, le téléphone, le message et le statut. Utilisez-le pour vérifier si un événement s'est déclenché et si le message a été envoyé. Il n'indique pas pourquoi un message a échoué.

Dépannage#

Pour voir les erreurs PHP du plugin, activez la journalisation de débogage de WordPress dans wp-config.php. Les erreurs sont écrites dans wp-content/debug.log. Désactivez-la une fois que vous avez terminé.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);