ان باؤنڈ SMS ویب ہُک: ری ٹرائی، ایونٹ ترتیب اور وصول پر آئیڈیمپوٹنسی

آؤٹ باؤنڈ SMS ڈیش بورڈز لے لیتا ہے۔ ان باؤنڈ وہ جگہ ہے جہاں STOP، HELP اور گاہک کے جوابات حقیقت میں اترتے ہیں — اور جہاں سادہ ہینڈلر ڈپلیکیٹ ٹکٹ، دوہری والیٹ سائیڈ اثر اور “ہمیں STOP کبھی نہیں ملا” compliance بھوت بناتے ہیں۔ اگر آپ کا ریسیو پاتھ exactly-once اور ترتیب وار مانے، تو پہلے اصلی آؤٹیج پر ٹوٹ جائیں گے۔.

IOSOR ان باؤنڈ میسجنگ کو آؤٹ باؤنڈ جیسی ہی وائٹ لیبل پری پیڈ سطح میں پیک کرتا ہے: قابل تصدیق ایونٹس، برانڈ سیف پے لوڈ، بغیر غیر ملکی ops پورٹل میں رہ کر جوابی طوفان ملائے۔.

ویب ہُک بالکل دوبارہ کوشش کیوں کرتے ہیں

زیادہ تر پلیٹ فارمز پر ان باؤنڈ ویب ہُک ری ٹرائی کے ساتھ at-least-once ڈلیوری کا وعدہ کرتے ہیں، جادوئی exactly-once سخت ترتیب کا نہیں۔ آپ کے ہینڈلر کو برداشت کرنا ہوگا:

• ایک ہی منطقی ایونٹ کے ڈپلیکیٹ POST
• ٹائم آؤٹ کے بعد دیر سے آمد
• دوسرے ایونٹ قسم کے مقابلے میں کبھی کبھار out-of-order

پروڈکٹ UX پھر بھی ترتیب وار محسوس ہو سکتا ہے اگر آپ کا اسٹور تعیناتی مرج کرے — اگر امید کریں کہ تار کبھی نہ کانپے، تو نہیں۔.

تین ناکامی طریقے جن کے لیے ڈیزائن ضروری ہے

آئیڈیمپوٹنسی: وہ خاصیت جو تینوں کو ٹھیک کرتی ہے

ایونٹ ترتیب: “last write wins” خطرناک کیوں

عام غلط مفروضے:

1. STOP اگلی مارکیٹنگ سینڈ سے پہلے آئے گی (ریس موجود ہے)
2. آؤٹ باؤنڈ DLR ان باؤنڈ جواب سے پہلے آئے گی (آزاد راستے)
3. پائیدار ایونٹ کلید کے بغیر “پہلا POST جیتتا ہے”

پائیدار event / message id پر ریسیو لیجر بنائیں۔ بزنس قواعد اس لیجر پر سٹیٹ ٹرانزیشن ہوں، “ہر HTTP 200 راستے پر سائیڈ اثر” نہیں۔.

STOP، HELP اور دیگر ان باؤنڈ کلیدی الفاظ کو وہی نظم

IOSOR سے شروع کریں

گزشتہ ہفتے کے آنے والے webhook لاگ کھینچیں اور ایک سے زیادہ بار آنے والے ایونٹ ID گنیں۔ ایک نقل اور ایک ترتیب سے باہر جوڑا چلائیں (failed، پھر delivered)۔ وصول کنندہ ایک اثر رکھے: ایک ان باکس صف، ایک STOP لکھت، ایک بٹوہ چھونا۔ STOP پلٹنے والا last-write-wins ناکامی ہے۔ یہ وصولی پر آئیڈیمپوٹنسی اور دوبارہ کوشش کی ترتیب ہے، دستخط جانچ نہیں، قطار سے پہلے گیٹ وے تالا نہیں۔

متعلقہ: ان باؤنڈ آٹو جواب لوپ · IOSOR میں کیریئر لیٹینسی کے خلاف ان باउंड ویب ہুক بفر کنفیگریشن · پہلی کٹوتی سے پہلے پری پیڈ رقم محفوظ کرنا.

IOSOR خلاصہ

آنے والے webhook پھر کوشش کرتے ہیں۔ وصولی پر آئیڈیمپوٹنسی ہی محفوظ جواب ہے؛ ترتیب وعدہ نہیں۔

کریں: ایونٹ کو کنجی دیں اور جڑواں نظرانداز کریں۔ نہ کریں: STOP پر last-write-wins یا ایک ایونٹ دو کٹوتیاں نہیں।