WooCommerce سے WhatsApp پر آرڈر اپڈیٹس بھیجیں
آرڈر ایونٹس کے لیے WooCommerce میں ایک ویب ہک بنائیں جو ریسیور کی طرف اشارہ کرے، مثلاً n8n ورک فلو یا چھوٹا PHP روٹ۔ ریسیور WooCommerce کے سگنیچر کی تصدیق کرتا ہے، دیکھتا ہے کہ کسٹمر نے WhatsApp میسجز کی اجازت دی ہے، اور جڑے ہوئے نمبر کے phone number id اور ٹوکن کے ساتھ Cloud API سے منظور شدہ ٹیمپلیٹ بھیجتا ہے۔
WooCommerce مسلسل پانچ سے زیادہ ڈیلیوری ناکام ہونے پر ویب ہک بند کر دیتا ہے۔
ہیڈر میں پے لوڈ کا base64 انکوڈڈ HMAC-SHA256 ہوتا ہے، جو ویب ہک کے سیکرٹ سے بنتا ہے۔
کسٹمر سروس ونڈو سے باہر صرف پہلے سے منظور شدہ ٹیمپلیٹ میسجز بھیجے جا سکتے ہیں۔
WooCommerce کا آرڈر WhatsApp میسج کیسے شروع کرتا ہے؟
WooCommerce کے ویب ہک اور ایک ریسیور کے ذریعے۔ WooCommerce میں سیٹنگز، ایڈوانسڈ، ویب ہکس میں جا کر آرڈر ٹاپک (مثلاً order created یا order updated)، ڈیلیوری URL اور سیکرٹ کے ساتھ ایک ویب ہک شامل کریں۔ پھر ہر بار ایونٹ ہونے پر WooCommerce آرڈر کو JSON کی شکل میں اسی URL پر بھیجتا ہے۔
پے لوڈ کی ساخت طے شدہ ہے، اس لیے اسے براہ راست Cloud API کی طرف نہیں بھیجا جا سکتا۔ درمیان میں ایک ریسیور بیٹھتا ہے: n8n کا Webhook نوڈ، اسٹور کے اپنے PHP میں ایک روٹ، یا کوئی بھی چھوٹی سروس۔ وہ آرڈر پڑھتا ہے، کسٹمر کا فون نمبر اور میسج کے لیے درکار تفصیلات نکالتا ہے، اور جڑے ہوئے نمبر کے لیے Cloud API کے میسجز اینڈ پوائنٹ پر ایک HTTPS درخواست بھیجتا ہے، جس میں نمبر کا ایکسیس ٹوکن bearer ٹوکن کے طور پر لگتا ہے۔
order.updated ٹاپک کسی ایک اسٹیٹس سے بندھا نہیں ہوتا، اس لیے ریسیور کو آرڈر کا اسٹیٹس فیلڈ پڑھنا چاہیے اور صرف انہی تبدیلیوں پر ایک بار میسج بھیجنا چاہیے جو اس کے لیے اہم ہیں۔ WooCommerce بطور ڈیفالٹ wp-cron کے ذریعے پس منظر میں ڈیلیوری کرتا ہے، اس لیے میسج آرڈر کے کچھ دیر بعد پہنچ سکتا ہے۔
ریسیور کو کیسے پتا چلتا ہے کہ درخواست اسٹور سے آئی ہے؟
WooCommerce کے سگنیچر سے۔ ہر ڈیلیوری میں X-WC-Webhook-Signature ہیڈر ہوتا ہے، جو خام پے لوڈ کا base64 انکوڈڈ HMAC-SHA256 ہے اور اس سیکرٹ سے بنتا ہے جو آپ نے ویب ہک پر رکھا تھا۔ ریسیور موصول شدہ باڈی پر وہی ہیش بناتا ہے، موازنہ کرتا ہے، اور جو میل نہ کھائے اسے مسترد کر دیتا ہے۔
یہ اسٹور کا اپنا سیکرٹ ہے، اس لیے آنے والے WhatsApp میسجز پر Meta کے سگنیچر کے برعکس اسے جانچا جا سکتا ہے۔ موازنہ constant time میں کریں، اور ہیش خام باڈی پر بنائیں، اس سے پہلے کہ کوئی فریم ورک اسے پارس کرے، کیونکہ دوبارہ انکوڈ کیا ہوا JSON مختلف ہیش دیتا ہے۔
فوراً 2xx جواب دیں۔ WooCommerce ہر اس جواب کو ناکامی گنتا ہے جو 2xx، 301 یا 302 نہ ہو، اور مسلسل پانچ سے زیادہ ناکامیوں کے بعد ویب ہک بند کر دیتا ہے۔ ڈیپلائے کے دوران بند ریسیور، یا جواب دینے سے پہلے Meta کا انتظار کرنے والا سست ریسیور، کسی کو پتا چلے بغیر اسٹور کے میسجز بند کر سکتا ہے۔
اسٹور کیا بھیج سکتا ہے، اور کب؟
جب بھی اسٹور پہلے بات شروع کرے، ایک منظور شدہ ٹیمپلیٹ۔ Meta کی 24 گھنٹے کی کسٹمر سروس ونڈو صرف تب کھلتی ہے جب کسٹمر نمبر کو میسج کرے، اس لیے آرڈر کنفرمیشن یا شپنگ اپڈیٹ کاروبار کی طرف سے شروع ہوتا ہے اور آزاد متن مسترد ہو جاتا ہے۔ ہر اپڈیٹ کے لیے ایک utility ٹیمپلیٹ بنائیں، منظوری کا انتظار کریں، اور اسے نام اور زبان کے ساتھ بھیجیں، جبکہ آرڈر نمبر اور دیگر تفصیلات پیرامیٹرز کے طور پر جائیں۔
Meta opt-in بھی لازمی کرتا ہے: کسٹمر نے اپنا نمبر دیا ہو اور اس کاروبار سے WhatsApp پر رابطے کی اجازت دی ہو۔ چیک آؤٹ پر ایک چیک باکس، جو آرڈر کے ساتھ محفوظ ہو، اس کا آسان ترین ریکارڈ ہے، اور ریسیور کو میسج بھیجنے سے پہلے اسے دیکھنا چاہیے۔
کسٹمر کے جواب دیتے ہی گفتگو عام Coexistence بن جاتی ہے۔ جواب اسٹور کے فون پر WhatsApp Business ایپ میں نظر آتا ہے، آزاد متن کے لیے ونڈو کھل جاتی ہے، اور ٹیم ایپ سے ویسے ہی جواب دیتی ہے جیسے ہمیشہ دیتی آئی ہے۔
عام غلطیاں
- WooCommerce کو جواب دینے سے پہلے Cloud API کال کرنا۔ سست یا ناکام سینڈ ویب ہک کے خلاف گنا جاتا ہے، جو پانچ سے زیادہ ناکامیوں پر بند ہو جاتا ہے۔
- خام باڈی کے بجائے پارس شدہ JSON کو ہیش کرنا۔ سگنیچر کبھی میل نہیں کھاتا اور ہر اصل ڈیلیوری مسترد ہو جاتی ہے۔
- ہر order.updated ڈیلیوری پر میسج بھیجنا۔ ٹاپک کسی ایک اسٹیٹس سے بندھا نہیں، اس لیے یہ ٹریک کیے بغیر کہ کس تبدیلی پر میسج جا چکا ہے، کسٹمرز کو دہرے میسجز ملتے ہیں۔
easycoexistence.com پر اسٹور کا نمبر جوڑیں اور ڈیش بورڈ سے اس کا phone number id اور ٹوکن ریسیور کو دیں۔ قیمت US$ 9 فی نمبر ماہانہ سے شروع ہوتی ہے اور نمبر بڑھانے کے ساتھ US$ 1 تک آ جاتی ہے، اور پہلے 3 دن مفت ہیں۔
اکثر پوچھے جانے والے سوالات
کیا اس کے لیے WordPress پلگ اِن چاہیے؟
نہیں۔ WooCommerce کے بلٹ اِن ویب ہکس اور ایک ریسیور کافی ہیں، اور ریسیور اسی PHP ایپلیکیشن کا ایک روٹ ہو سکتا ہے۔
آرڈر میسجز کا خرچ کون اٹھاتا ہے؟
Meta میسجنگ کا بل براہ راست کاروبار کو اس کے اپنے WhatsApp Business Account پر بھیجتا ہے، اور EasyCoexistence اس پر کوئی اضافہ نہیں لگاتا۔
کیا ٹیم اب بھی فون استعمال کر سکتی ہے؟
جی ہاں۔ Coexistence اسٹور کے نمبر پر WhatsApp Business ایپ کو چالو رکھتا ہے، اور اسٹور کا بھیجا ہوا ٹیمپلیٹ تھریڈ میں نظر آتا ہے۔
اگر ویب ہک بند ہو جائے تو کیا کریں؟
ریسیور درست کریں، پھر WooCommerce میں ویب ہک کا اسٹیٹس دوبارہ فعال کر دیں۔ جو آرڈر اس کے بند ہونے کے دوران بنے، ان پر کوئی میسج نہیں گیا تھا۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ