Plugin WooCommerce

Plugin WooCommerce SMS & WhatsApp : confirmez vos commandes COD au Maroc

envoisms-woocommerce est le plugin WordPress officiel d'EnvoiSMS.ma. Il fait deux choses, chacune optionnelle : il fait confirmer chaque commande payée à la livraison par WhatsApp, depuis votre propre numéro, avec deux boutons Confirmer / Annuler dont le tap met la commande à jour tout seul ; et il envoie un SMS au client quand sa commande passe en cours de traitement puis terminée.

wp-content/plugins/envoisms-woocommerce
# 1. Installer le plugin (zip GitHub ou clone) cd wp-content/plugins git clone https://github.com/envoisms/envoisms-woocommerce.git # 2. Extensions → activer « EnvoiSMS for WooCommerce » # 3. WooCommerce → EnvoiSMS Maroc → coller la clé API, enregistrer # 4. Confirmation COD : cocher « Activer », enregistrer, # puis « Créer les modèles WhatsApp » (français et arabe) # Prérequis : WooCommerce 7.1+, PHP 8.0+, HTTPS public
● Routes locales MarocIAM • Inwi • Orange
https://api.envoisms.ma/v1
Routes locales
Maroc Telecom (IAM) • Inwi • Orange
Accusés réels DLR
Signatures HMAC-SHA256
Tarifs clairs en MAD
dès 0,60 MAD/SMS • 5 MAD offerts

La confirmation COD par WhatsApp, commande par commande

Quand un client choisit le paiement à la livraison, la commande passe en « En attente de confirmation » (le stock reste réservé) et le client reçoit, depuis votre numéro WhatsApp, un message avec deux boutons. Une colonne « WhatsApp » dans la liste des commandes suit chaque étape.

  • Confirmer → la commande passe en cours de traitement, avec un remerciement WhatsApp et sans SMS en double
  • Annuler → la commande est signalée pour vous, ou annulée avec remise en stock si vous avez choisi l'annulation automatique
  • Pas de réponse après N heures → une relance ; toujours rien → « Sans réponse — à appeler », avec un SMS optionnel au client
  • Envoi WhatsApp refusé (numéro non connecté, modèle non approuvé…) → « Échec WhatsApp », avec un SMS optionnel

Une réponse ne peut pas être forgée

En activant le COD, le plugin enregistre l'adresse de votre site auprès d'EnvoiSMS (POST /v1/webhooks, événement message.inbound) et garde le secret de signature renvoyé. Chaque réponse du client arrive sur /wp-json/envoisms/v1/webhook signée HMAC-SHA256 dans l'en-tête X-EnvoiSMS-Signature-256 ; une signature fausse ou vieille de plus de 5 minutes est refusée.

  • La réponse n'est acceptée que depuis le numéro de facturation de la commande
  • Chaque bouton porte une étiquette dérivée de la clé de la commande : impossible de viser une autre commande
  • Un second tap, ou un webhook rejoué, ne change jamais une commande déjà confirmée ou annulée

Les SMS de suivi de commande

Deux messages, chacun modifiable : quand la commande passe en cours de traitement, et quand elle est terminée. Laissez un message vide pour ne rien envoyer.

  • Variables : {first_name}, {last_name}, {order_id}, {order_total}, {billing_city}
  • Votre Sender ID de marque (le nom d'expéditeur que vous avez enregistré)
  • Numéros normalisés en E.164 selon le pays de facturation (06…, +212…, 00212…)
  • Chaque envoi porte un Idempotency-Key : un hook de statut déclenché deux fois envoie un seul message

Prérequis

Pour la confirmation COD : votre numéro WhatsApp connecté dans le tableau de bord EnvoiSMS.ma (en coexistence, vous gardez l'application WhatsApp Business sur votre téléphone), le modèle de confirmation approuvé, et votre site joignable en HTTPS public. Les SMS de suivi ne demandent que votre clé API.

  • WooCommerce 7.1+ et PHP 8.0+
  • Compatible High-Performance Order Storage (HPOS)
  • Le modèle se crée depuis les réglages du plugin (bouton « Créer les modèles WhatsApp », en français et en arabe) ; EnvoiSMS le relit puis le soumet à Meta, et son statut s'affiche sur la même page

Installation en cinq étapes

Le plugin s'installe comme toute extension WordPress, puis se configure depuis WooCommerce.

  • Téléchargez le zip du plugin depuis GitHub, ou clonez le dépôt dans /wp-content/plugins/envoisms-woocommerce.
  • Activez « EnvoiSMS for WooCommerce » dans Extensions.
  • Ouvrez WooCommerce → EnvoiSMS Maroc.
  • Collez votre clé API (tableau de bord EnvoiSMS.ma) et enregistrez.
  • Pour la confirmation COD : cochez « Activer », enregistrez, puis cliquez sur « Créer les modèles WhatsApp ».
  • Code source : github.com/envoisms/envoisms-woocommerce
  • Licence MIT, sans abonnement au plugin : vous payez les messages envoyés, en dirhams

Tout savoir sur Plugin WooCommerce.

Le plugin est-il gratuit ?
Oui. Le plugin est open source sous licence MIT. Vous ne payez que les SMS et messages WhatsApp réellement envoyés, débités de votre solde prépayé en dirhams.
Faut-il un numéro WhatsApp Business pour utiliser le plugin ?
Seulement pour la confirmation COD, qui part de votre propre numéro. Les SMS de suivi de commande fonctionnent avec votre seule clé API.
Que se passe-t-il si le client ne répond pas sur WhatsApp ?
Après le délai que vous choisissez, le client reçoit une relance. Sans réponse après un second délai, la commande reste inchangée et passe en « Sans réponse — à appeler » ; vous pouvez aussi faire partir un SMS d'information au client.
Le plugin peut-il annuler une commande tout seul ?
Seulement si vous le choisissez. Par défaut, un tap sur Annuler signale la commande pour que vous décidiez ; avec l'annulation automatique, elle passe en Annulée et le stock est remis.
Puis-je tester avant de passer en production ?
Oui. Une clé sandbox env_test_ rejoue tout le parcours d'envoi sans rien livrer ni débiter, et 5 MAD de crédit réel sont offerts à l'inscription pour vos premiers envois.

Prêt à intégrer Plugin WooCommerce ?

Créez votre compte en moins de 2 minutes. Bénéficiez immédiatement de 5 MAD de crédit gratuit pour tester l'API.