إضافة ووكومرس

إضافة ووكومرس للرسائل القصيرة وواتساب: أكّد طلبات الدفع عند الاستلام في المغرب

envoisms-woocommerce هي إضافة ووردبريس الرسمية من EnvoiSMS.ma. تقوم بأمرين، كلاهما اختياري: تطلب تأكيد كل طلب يُدفع عند الاستلام عبر واتساب، من رقمك الخاص، بزرّين — «تأكيد» و«إلغاء» — تُحدَّث الطلبية تلقائيًا بمجرد الضغط على أحدهما؛ وترسل رسالة SMS إلى الزبون عندما تنتقل طلبيته إلى «قيد المعالجة» ثم إلى «مكتملة».

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
توجيه محلي
Maroc Telecom (IAM) • Inwi • Orange
إشعارات تسليم حقيقية DLR
توقيع HMAC-SHA256
تسعير واضح بالدرهم
dès 0,60 MAD/SMS • 5 MAD offerts

تأكيد الدفع عند الاستلام عبر واتساب، طلبية بطلبية

عندما يختار الزبون الدفع عند الاستلام، تبقى الطلبية في حالة «في انتظار التأكيد» (مع حجز المخزون) بينما يتلقى الزبون، من رقم واتساب الخاص بك، رسالة بزرّين. يتتبّع عمود «واتساب» في قائمة الطلبات كل مرحلة.

  • تأكيد ← تنتقل الطلبية إلى «قيد المعالجة»، مع رسالة شكر عبر واتساب ودون رسالة SMS مكررة
  • إلغاء ← تُعلَّم الطلبية لتقرر أنت، أو تُلغى مع إرجاع المخزون إذا اخترت الإلغاء التلقائي
  • لا رد بعد N ساعة ← تذكير واحد؛ وإن بقي الصمت ← «بدون رد — يجب الاتصال»، مع رسالة SMS اختيارية للزبون
  • رفض واتساب الإرسال (رقم غير مربوط، قالب غير معتمد…) ← «فشل واتساب»، مع رسالة SMS اختيارية

لا يمكن تزوير الرد

عند تفعيل الدفع عند الاستلام، تسجّل الإضافة موقعك لدى EnvoiSMS (POST /v1/webhooks، الحدث message.inbound) وتحتفظ بسرّ التوقيع المُعاد. يصل كل رد من الزبون إلى ‎/wp-json/envoisms/v1/webhook موقّعًا بـ HMAC-SHA256 في الترويسة X-EnvoiSMS-Signature-256؛ ويُرفض كل توقيع خاطئ أو أقدم من 5 دقائق.

  • لا يُقبل الرد إلا من رقم الفوترة الخاص بالطلبية
  • يحمل كل زر وسمًا مشتقًا من مفتاح الطلبية، فلا يمكن توجيهه إلى طلبية أخرى
  • الضغطة الثانية أو إعادة إرسال الويب هوك لا تغيّر أبدًا طلبية مؤكدة أو ملغاة

رسائل SMS لتتبع الطلبيات

رسالتان، كل واحدة قابلة للتعديل: عند انتقال الطلبية إلى «قيد المعالجة» وعند اكتمالها. اترك إحداهما فارغة كي لا يُرسل شيء.

  • المتغيرات: {first_name}، {last_name}، {order_id}، {order_total}، {billing_city}
  • اسم المرسل (Sender ID) الخاص بعلامتك التجارية
  • تُوحَّد الأرقام بصيغة E.164 حسب بلد الفوترة (06…، ‎+212…، 00212…)
  • يحمل كل إرسال مفتاح Idempotency-Key، فإذا انطلق حدث الحالة مرتين تُرسل رسالة واحدة

المتطلبات

لتأكيد الدفع عند الاستلام: رقم واتساب مربوط في لوحة تحكم EnvoiSMS.ma (مع ميزة التعايش تواصل استخدام تطبيق WhatsApp Business على هاتفك)، وقالب التأكيد معتمد، وموقعك متاح عبر HTTPS عام. أما رسائل SMS للطلبيات فتكفيها مفتاح API.

  • WooCommerce 7.1 فما فوق وPHP 8.0 فما فوق
  • متوافقة مع High-Performance Order Storage (HPOS)
  • يُنشأ القالب من إعدادات الإضافة (زر «إنشاء قوالب واتساب»، بالفرنسية والعربية)؛ تراجعه EnvoiSMS ثم ترسله إلى Meta، وتظهر حالته في الصفحة نفسها

التثبيت في خمس خطوات

تُثبَّت الإضافة مثل أي إضافة ووردبريس، ثم تُضبط من WooCommerce.

  • نزّل ملف zip للإضافة من GitHub، أو انسخ المستودع إلى ‎/wp-content/plugins/envoisms-woocommerce.
  • فعّل «EnvoiSMS for WooCommerce» من قائمة الإضافات.
  • افتح WooCommerce ← EnvoiSMS Maroc.
  • أدخل مفتاح API من لوحة تحكم EnvoiSMS.ma واحفظ.
  • لتأكيد الدفع عند الاستلام: فعّل الخيار، احفظ، ثم اضغط «إنشاء قوالب واتساب».
  • الشيفرة المصدرية: github.com/envoisms/envoisms-woocommerce
  • رخصة MIT، بدون اشتراك في الإضافة: تدفع ثمن الرسائل المرسلة فقط، بالدرهم

كل ما تحتاج معرفته عن إضافة ووكومرس.

هل الإضافة مجانية؟
نعم. الإضافة مفتوحة المصدر برخصة MIT. لا تدفع إلا ثمن رسائل SMS وواتساب المرسلة فعلًا، وتُخصم من رصيدك المدفوع مسبقًا بالدرهم.
هل أحتاج إلى رقم WhatsApp Business لاستخدام الإضافة؟
فقط لتأكيد الدفع عند الاستلام، لأنه يُرسل من رقمك الخاص. أما رسائل SMS لتتبع الطلبيات فتعمل بمفتاح API وحده.
ماذا يحدث إذا لم يرد الزبون على واتساب؟
بعد المهلة التي تحددها، يتلقى الزبون تذكيرًا واحدًا. وإن لم يرد بعد مهلة ثانية، تبقى الطلبية دون تغيير وتُعلَّم «بدون رد — يجب الاتصال»؛ ويمكنك أيضًا إرسال رسالة SMS إعلامية إلى الزبون.
هل يمكن للإضافة إلغاء طلبية من تلقاء نفسها؟
فقط إذا اخترت ذلك. افتراضيًا، الضغط على «إلغاء» يعلّم الطلبية لتقرر أنت؛ ومع الإلغاء التلقائي تنتقل إلى «ملغاة» ويُرجَع المخزون.
هل يمكنني التجربة قبل الانتقال إلى الإنتاج؟
نعم. مفتاح Sandbox من نوع env_test_ يعيد تنفيذ مسار الإرسال كاملًا دون تسليم أو خصم، وتحصل عند التسجيل على 5 دراهم رصيدًا حقيقيًا لأول عمليات الإرسال.

ابدأ التكامل مع إضافة ووكومرس الآن

أنشئ حسابك في أقل من دقيقتين. احصل فوراً على رصيد 5 دراهم مجاناً لاختبار الـ API.