WhatsApp کو Embedded Signup اور Coexistence کے ذریعے اپنے SaaS میں کیسے شامل کریں
ایک SaaS، Meta کے Embedded Signup اور Coexistence کے ذریعے ہر گاہک کا موجودہ نمبر کنیکٹ کر کے WhatsApp شامل کرتا ہے، تاکہ وہ نمبر WhatsApp Business ایپ میں کام کرتا رہے۔ easyCoexistence کے Partner API کے ساتھ، ہر گاہک کے لیے ایک کنیکٹ سیشن ہوسٹڈ پیج پر یہ فلو چلاتا ہے، Meta نمبر کے میسج آپ کے webhook_url تک پہنچاتا ہے، اور آپ کا بیک اینڈ گاہک کے اپنے ٹوکن کے ساتھ Cloud API کے ذریعے جواب دیتا ہے۔
WhatsApp Business ایپ اور Cloud API دونوں کے ساتھ استعمال ہونے والے نمبر کی مقررہ تھرو پٹ۔
Coexistence کے ذریعے گاہک کا نمبر جس WhatsApp Business ایپ ورژن کے ساتھ کنیکٹ ہو سکتا ہے، اس کا سب سے پرانا ورژن۔
Meta آن بورڈنگ پر جو پرانی چیٹ ہسٹری شیئر کر سکتا ہے، وہ کتنی پرانی ہو سکتی ہے؛ اسے 24 گھنٹے کے اندر سنک ہونا ضروری ہے۔
صارف کے میسج یا کال کے بعد WhatsApp کی کسٹمر سروس ونڈو؛ ہر نیا میسج اسے دوبارہ شروع کرتا ہے۔
وہ تاریخ جب Meta نے Embedded Signup v2 اور v3 کو متروک کیا، اور انٹیگریشنز v4 پر منتقل ہو گئیں۔
WhatsApp انٹیگریشن کے حصے کون سے ہیں؟
پانچ حصے ہیں، اور easyCoexistence پہلا اور آخری حصہ سنبھالتا ہے۔ آپ کی پروڈکٹ گفتگو کی منطق، ان باکس، اور جو کچھ آپ کا ماڈل یا آپ کے گاہکوں کا عملہ لکھے، وہ رکھتی ہے، جبکہ نمبر اور آپ کے سرور کے درمیان میسج Meta پہنچاتا ہے:
Coexistence آپ کے گاہکوں کے لیے کیا بدلتا ہے؟
وہ اپنا نمبر اور اپنا فون رکھتے ہیں۔ WhatsApp Business ایپ Cloud API کے ساتھ ساتھ چلتی رہتی ہے، اس لیے عملہ فون پر جواب دیتا ہے جبکہ آپ کی پروڈکٹ API کے ذریعے جواب دیتی ہے، اور ایپ سے جو کچھ وہ بھیجتے ہیں وہ smb_message_echoes کے طور پر آپ کے ویب ہک تک پہنچتا ہے۔ اس کے ساتھ تین حدیں آتی ہیں: نمبر 20 میسج فی سیکنڈ کی مقررہ رفتار سے بھیجتا ہے، ٹیمپلیٹ صرف API بھیج سکتا ہے، اور اگر فون تقریباً 14 دن تک غیر فعال رہے تو Meta نمبر کو منقطع کر دیتا ہے۔
آپ کی پروڈکٹ میں کنیکٹ کا مرحلہ کیسا دکھتا ہے؟
ایک Connect WhatsApp بٹن ہوتا ہے جو آپ کے بیک اینڈ سے POST /connect-sessions کال کرتا ہے، جس میں redirect_url، آپ کے گاہک کی id بطور external_ref، اور webhook_url کے ساتھ webhook_verify_token ہوتا ہے، تاکہ Meta پہلے ہی منٹ سے نمبر آپ تک روٹ کرے۔ گاہک ہوسٹڈ پیج پر ایک مختصر چیک لسٹ کی تصدیق کرتا ہے، Meta کا پاپ اپ چلاتا ہے، WhatsApp Business ایپ سے QR کوڈ اسکین کرتا ہے، اور connection_id کے ساتھ آپ کے پاس واپس آتا ہے۔ اپنی Tech Provider ایپ سے Embedded Signup چلانا ہے یا نہیں، اس کا فیصلہ Embedded Signup گائیڈ میں دیکھیں۔
میسج آپ کے بیک اینڈ تک کیسے پہنچتے ہیں؟
Meta سے براہ راست webhook_url تک، easyCoexistence پر رکے بغیر اور کوئی کاپی رکھے بغیر۔ messages فیلد میں وہ میسج ہوتے ہیں جو گاہک بھیجتے ہیں اور جو آپ بھیجتے ہیں ان کا اسٹیٹس، جبکہ smb_message_echoes میں وہ ہوتا ہے جو عملہ ایپ سے بھیجتا ہے۔ Meta ہر ڈیلیوری پر easyCoexistence کا app secret دستخط کرتا ہے، جو کبھی شیئر نہیں ہوتا، اس لیے URL کے پاتھ میں ایک لمبا، بے ترتیب secret اسے مستند کرتا ہے۔ ایک WhatsApp Business Account کے دو نمبر ایک ہی منزل شیئر کرتے ہیں: value.metadata.phone_number_id کی بنیاد پر روٹ کریں۔
آپ کا بیک اینڈ جواب اور ٹیمپلیٹ کیسے بھیجتا ہے؟
Meta کے Graph API اور GET /connections/{id}?credentials=1 سے حاصل گاہک کے ٹوکن کے ساتھ، جو send_endpoint بھی واپس کرتا ہے۔ آزاد متن صرف شخص کے آخری میسج کے 24 گھنٹے کے اندر جا سکتا ہے؛ اس کے بعد صرف وہ ٹیمپلیٹ جا سکتا ہے جسے Meta نے منظور کیا ہو:
- جواب: ونڈو کے اندر type text کے ساتھ POST /<
PHONE_NUMBER_ID>/messages۔ - ٹیمپلیٹ: اسی کال کے ساتھ type template، ٹیمپلیٹ کا نام اور اس کا language code۔
- ٹیمپلیٹ بنائیں: POST /<
WABA_ID>/message_templates، پھر اس کا اسٹیٹس چیک کریں، کیونکہ جائزے کے نتائجwebhook_urlتک نہیں پہنچتے۔ - میڈیا: اپ لوڈ کے لیے POST /<
PHONE_NUMBER_ID>/media؛ آنے والا میڈیا ایک ID کی شکل میں آتا ہے جسے اسی ٹوکن سے حاصل کیا جاتا ہے۔
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'کیا آپ کی پروڈکٹ گاہک کی موجودہ چیٹس امپورٹ کر سکتی ہے؟
ایک بار، کنکشن کے وقت۔ سیشن پر webhook_url سیٹ ہونے کی صورت میں easyCoexistence Meta سے کہتا ہے کہ نمبر کے کانٹیکٹس بھیجے اور، اگر گاہک ایپ میں اجازت دے، تو 180 دن تک کی چیٹس بھی، جو smb_app_state_sync اور ہسٹری webhooks کے طور پر آتی ہیں۔ Meta یہ صرف کنکشن کے 24 گھنٹے کے اندر اجازت دیتا ہے، اس لیے لنک جانے سے پہلے اینڈ پوائنٹ کا جواب دیتا ہوا ہونا یقینی بنائیں۔ چیٹ ہسٹری گائیڈ میں payloads کی تفصیل ہے۔
Meta کو میسج کی ادائیگی کون کرتا ہے؟
آپ کا گاہک۔ Meta وہ میسج جو آپ کا بیک اینڈ API کے ذریعے بھیجتا ہے، گاہک کے اپنے WhatsApp Business Account پر بِل کرتا ہے، اس ادائیگی کے طریقے پر جو وہ وہاں شامل کرتا ہے، اور جس کاروبار کے پاس کوئی طریقہ نہ ہو وہ مارکیٹنگ ٹیمپلیٹ نہیں بھیج سکتا۔ easyCoexistence آپ کے اکاؤنٹ سے ہر کنیکٹ شدہ نمبر کا چارج لیتا ہے، میسج پر کبھی چارج نہیں کرتا اور نہ Meta کی قیمتوں پر مارک اپ لگاتا ہے۔
جب کوئی نمبر منقطع ہو جائے تو کیا ہوتا ہے؟
آپ کا events URL connection.disconnected وصول کرتا ہے، اور اگر معلوم ہو تو Meta کی وجہ بھی۔ PRIMARY_INACTIVITY وہ 14 دن کا اصول ہے، اور اس گاہک کا نیا کنیکٹ سیشن وہی نمبر واپس لے آتا ہے۔ connection.token_missing کا مطلب ہے کہ نمبر گاہک کے ٹوکن کے بغیر کنیکٹ ہوا، اس لیے وہ میسج وصول کرتا ہے مگر نیا سیشن اسے دوبارہ کنیکٹ نہ کرے تب تک بھیج نہیں سکتا۔
عام غلطیاں
- آپ کے ویب ہک اینڈ پوائنٹ کا جواب دینے سے پہلے کنیکٹ لنک بھیجنا۔ ہسٹری امپورٹ ایک بار، کنیکٹ کرنے کے 24 گھنٹے کے اندر چلتا ہے، اور جب تک آپ کا URL کام نہ کرے، اس سے پہلے بھیجا گیا مواد ضائع ہو جاتا ہے۔
- ونڈو بند ہونے کے بعد آزاد متن سے جواب دینا۔ شخص کے آخری میسج کے 24 گھنٹے گزرنے کے بعد صرف منظور شدہ ٹیمپلیٹ جاتا ہے۔
- ایک نمبر سے پوری رفتار پر مہم چلانا۔ Coexistence نمبر 20 میسج فی سیکنڈ بھیجتا ہے، اس لیے ہر نمبر کے بھیجے جانے والے میسج اسی رفتار سے قطار میں لگائیں۔
- توقع کرنا کہ عملہ فون سے ٹیمپلیٹ بھیجے گا۔ Coexistence میں صرف API انہیں بھیجتا ہے، اس لیے ٹیمپلیٹ بھیجنا اپنی پروڈکٹ میں رکھیں۔
easyCoexistence Meta کے Embedded Signup اور Coexistence کے ذریعے آپ کے نام والے ہوسٹڈ پیج پر آپ کے SaaS میں WhatsApp شامل کرتا ہے: آپ کے گاہک اپنا نمبر اور WhatsApp Business ایپ برقرار رکھتے ہیں، Meta میسج آپ کے سرور تک پہنچاتا ہے، اور وہ دستخط شدہ ایونٹس کے طور پر آپ تک پہنچتے ہیں۔ یہی API Instagram، Facebook، TikTok، YouTube، LinkedIn اور مزید چینلز کو بھی کنیکٹ کرتا ہے۔ US$ 9 سے US$ 0.75 تک فی کنکشن فی مہینہ، جیسے جیسے کنکشنز بڑھتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن کا فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا کوئی گاہک ایسا نمبر کنیکٹ کر سکتا ہے جو کسی اور WhatsApp API پرووائیڈر پر ہو؟
فی الحال نہیں، جب تک وہ نمبر وہاں موجود ہے۔ ہوسٹڈ چیک لسٹ ایسا نمبر مانگتی ہے جس پر کوئی اور API پرووائیڈر یا آٹومیشن ٹول نہ ہو، اس لیے گاہک پہلے اسے اُس پرووائیڈر سے منقطع کرتا ہے۔
کیا میری SaaS اپنے گاہکوں کے لیے WhatsApp ٹیمپلیٹ بھیج سکتی ہے؟
ہاں، Cloud API کے ذریعے ہر گاہک کے ٹوکن کے ساتھ: ٹیمپلیٹ ان کے WhatsApp Business Account پر بنائیں، Meta کے جائزے کا انتظار کریں، پھر بھیجیں۔
کیا easyCoexistence میرے گاہکوں کے WhatsApp میسج پڑھتا ہے؟
نہیں۔ Meta کسی نمبر کے میسج براہ راست اس webhook_url تک پہنچاتا ہے جو آپ نے سیٹ کیا ہو۔ جس نمبر کا webhook_url نہ ہو وہ easyCoexistence کے کال بیک پر جاتا ہے، جہاں میسج محفوظ کیے بغیر ضائع کر دیے جاتے ہیں۔
easyCoexistence ہر WhatsApp نمبر کے لیے کتنا لگتا ہے؟
US$ 9 سے US$ 0.75 تک فی نمبر فی مہینہ، آپ کے کل کنکشنز کے بینڈ کے مطابق، پہلے 3 دن مفت۔ Meta کے میسج چارجز ہر گاہک کے اپنے WhatsApp Business Account پر جاتے ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ