اپنی ایپ میں صارفین کو واٹس ایپ، انسٹاگرام اور ٹک ٹاک اکاؤنٹس کنیکٹ کرنے دیں
اپنی ایپ میں صارفین کو واٹس ایپ، انسٹاگرام اور ٹک ٹاک اکاؤنٹس کنیکٹ کرنے کے لیے، easyCoexistence کے Partner API کے ذریعے کنیکٹ سیشن بنائیں اور صارف کو اس کے ہوسٹڈ URL پر بھیجیں۔ وہاں صارف Meta کے Embedded Signup کے ذریعے واٹس ایپ نمبر جوڑتا ہے، یا Instagram، Facebook، TikTok، YouTube، LinkedIn اور مزید چینلز میں سائن ان کرتا ہے، پھر نئے کنکشن یا چینل آئی ڈی کے ساتھ آپ کے redirect_url پر واپس آتا ہے۔ لنکس ایک گھنٹے تک کام کرتے ہیں۔
کنیکٹ لنک کتنی دیر کام کرتا ہے؛ اس کے بعد سیشن ایکسپائرڈ ظاہر ہوتا ہے اور نیا سیشن درکار ہوتا ہے۔
ایک اکاؤنٹ ایک وقت میں کھلے رکھ سکنے والے کنیکٹ سیشنز کی تعداد، اور ایک گھنٹے میں 100 نئے سیشنز کی حد۔
بنایا گیا، کھولا گیا، کنیکٹ ہوا، منسوخ ہوا یا ایکسپائر ہوا، جیسا کہ GET /connect-sessions/:id بتاتا ہے۔
Meta کی طرف سے واٹس ایپ نمبر کے پیغامات کی ویب ہک کسی اور جگہ روٹ کرنے کے لیے قبول کیے جانے والے متبادل کال بیک URL کی سب سے بڑی لمبائی۔
کنیکٹ لنک کیسے کام کرتا ہے؟
چیک آؤٹ پیج کی طرح۔ آپ کا بیک اینڈ سیشن بناتا ہے، آپ کا انٹرفیس صارف کو اس کے url پر بھیجتا ہے، صارف easycoexistence.com کے ایک صفحے پر کنیکٹ کرتا ہے، اور براؤزر آپ کے redirect_url پر واپس آ جاتا ہے۔ پھر آپ کا بیک اینڈ نتیجے کی تصدیق کرتا ہے اور نئے کنکشن کی کریڈینشیلز حاصل کرتا ہے، یہ سب آپ کی API key کے ساتھ۔
درخواست میں کیا شامل ہوتا ہے؟
JSON باڈی https://easycoexistence.com/api/v1/connect-sessions پر پوسٹ کی جاتی ہے، جس کے ساتھ آپ کی API key بطور Bearer ٹوکن بھیجی جاتی ہے۔ صرف redirect_url لازمی ہے:
redirect_url: ایک https URL جہاں صارف بعد میں پہنچتا ہے۔- channel: whatsapp، جو پہلے سے طے شدہ ہے، یا آپ کے اکاؤنٹ پر کھلا کوئی سوشل نیٹ ورک اس کے چھوٹے حروف والے نام سے، مثلاً instagram، tiktok اور youtube کے نام سے۔
external_ref: اس صارف کے لیے آپ کی اپنی آئی ڈی، 200 حروف تک۔partner_name: وہ نام جو ہوسٹڈ پیج دکھاتا ہے، 80 حروف تک؛ پہلے سے آپ کے اکاؤنٹ کا نام۔webhook_urlاورwebhook_verify_token: صرف نمبروں کے لیے، اور ہمیشہ ایک ساتھ دیے جائیں۔ کنیکٹ ہوتے ہی Meta اس نمبر کے پیغامات وہیں پہنچانا شروع کر دیتا ہے۔
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'واپسی میں کیا آتا ہے؟
201 کے ساتھ سیشن آتا ہے۔ صارف کو url پر بھیجیں، اور id محفوظ رکھیں، جو cs_ سے شروع ہوتی ہے، تاکہ بعد میں سیشن دیکھا جا سکے۔ expires_at بنانے کے ایک گھنٹے بعد ختم ہو جاتا ہے، اور صارف کے کنیکٹ ہونے پر سیشن کے چینل کے مطابق connection_id یا channel_id بھر جاتی ہے۔ GET /connect-sessions/:id کسی بھی وقت وہی شکل واپس کرتا ہے۔
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}سیشن بنانے سے کون سی خرابیاں آ سکتی ہیں؟
ہر خرابی کا جسم ایک ہی ہوتا ہے: ایک آبجیکٹ جس میں ایرر کوڈ اور میسج ہوتا ہے، اور میسج بتاتا ہے کہ کیا ٹھیک کرنا ہے۔ سیشن بنانے پر یہ واپس آ سکتا ہے:
- 400
invalid_jsonیاinvalid_request: باڈی JSON آبجیکٹ نہیں، یا کوئی فیلڈ ویلیڈیشن میں ناکام، جیسے وہredirect_urlجو https نہیں۔ - 400
channel_unavailable: یہ چینل اس اکاؤنٹ کے لیے کھلا نہیں؛ میسج ان چینلز کی فہرست دیتا ہے جو کھلے ہیں۔ - 401 unauthorized: API key موجود نہیں یا غلط ہے۔
- 402
billing_required: اکاؤنٹ کے پاس ابھی کارڈ نہیں، اور اس کے ذریعے کنیکٹ ہونے والی ہر چیز اسی پر بل ہوتی ہے۔ - 429
cap_reached: 50 سیشن پہلے سے کھلے ہیں؛ کچھ کے مکمل ہونے یا ایکسپائر ہونے کا انتظار کریں۔ - 429
rate_limited: اس گھنٹے میں 100 سے زیادہ سیشن؛ میسج بتاتا ہے کہ کتنی دیر انتظار کرنا ہے۔
صارف بعد میں کہاں پہنچتا ہے؟
آپ کے redirect_url پر، جس کی کوئری اسٹرنگ میں نتیجہ شامل ہوتا ہے۔ وہی نتیجہ سیشن پر بھی ہوتا ہے، جسے آپ کا بیک اینڈ GET /connect-sessions/:id سے پڑھتا ہے:
- session: سیشن کی آئی ڈی، cs_ کے بعد بے ترتیب حروف۔
- status: connected، یا cancelled جب صارف نے Cancel and go back کو چنا۔
external_ref: آپ کی وہ آئی ڈی جو صارف کے لیے دی گئی، اگر سیشن میں تھی۔connection_id: نئے نمبر کی آئی ڈی، /connections کے لیے۔channel_id: نئے سوشل اکاؤنٹ کی آئی ڈی، /channels کے لیے۔
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…سیشن کے کون سے اسٹیٹس ہو سکتے ہیں؟
پانچ۔ GET /connect-sessions/:id موجودہ اسٹیٹس بتاتا ہے، ساتھ opened_at، finished_at اور last_error، جو بتاتا ہے کہ آخری کوشش کیوں ناکام ہوئی:
- created: آپ کے بیک اینڈ نے بنایا، ابھی کھولا نہیں گیا۔
- opened: صارف نے ہوسٹڈ پیج لوڈ کر لیا ہے۔
- connected: کوئی نمبر یا سوشل اکاؤنٹ کنیکٹ ہو گیا، اور اس کی آئی ڈی سیشن پر ہے۔
- cancelled: صارف Cancel and go back سے باہر نکل گیا۔
- expired: سیشن مکمل ہونے سے پہلے ایک گھنٹہ ختم ہو گیا۔
لنک کتنی دیر کام کرتا ہے؟
بنانے کے ایک گھنٹے تک۔ اس کے بعد ہوسٹڈ پیج صارف کو بتاتا ہے کہ لنک ایکسپائر ہو گیا ہے، ساتھ ایک بٹن جو آپ کے redirect_url پر واپس لے جاتا ہے جس پر status=cancelled ہوتا ہے، اور سیشن ایکسپائرڈ پڑھا جاتا ہے۔ ایک اکاؤنٹ 50 کھلے سیشن رکھ سکتا ہے اور ایک گھنٹے میں 100 بنا سکتا ہے، کیونکہ Meta ہر پہلی بار کی آن بورڈنگ کو ایک ایپ کی سطح کی حد میں گنتا ہے جو ہر اکاؤنٹ شیئر کرتا ہے۔
external_ref کیا کرتا ہے؟
ہر کنکشن کو آپ کے صارف سے جوڑتا ہے۔ آپ کی بھیجی گئی ویلیو اس نمبر یا چینل پر محفوظ ہوتی ہے جو سیشن بناتا ہے، ری ڈائریکٹ میں شامل ہوتی ہے، اور اس کے بارے میں ہر اسٹیٹس ایونٹ میں شامل ہوتی ہے۔ اس لیے GET /connections?external_ref=customer_4821 اور GET /channels?external_ref=customer_4821 وہ سب دکھاتے ہیں جو اس صارف نے کنیکٹ کیا ہے۔ Facebook یا LinkedIn سائن ان ایک ساتھ کئی Pages لا سکتا ہے: ری ڈائریکٹ پہلا نام دیتا ہے، اور فلٹر باقی سب کی فہرست دیتا ہے۔ اپنے ڈیٹا بیس کی مستحکم آئی ڈی استعمال کریں، ای میل نہیں جو بدل سکتی ہے۔
اگر صارف منسوخ کرے یا سائن ان ناکام ہو تو؟
یہ اس پر منحصر ہے کہ کہاں ہوا، اور سیشن ریکارڈ رکھتا ہے:
- Meta کا پاپ اپ ناکام ہو یا بند ہو جائے: لنک کھلا ہو تو صارف اسی صفحے پر دوبارہ Connect دبائے۔
- سوشل سائن ان منسوخ ہو یا رد ہو جائے: صارف وجہ کے ساتھ ہوسٹڈ پیج پر واپس آتا ہے اور لنک ایکسپائر ہونے تک دوبارہ کوشش کر سکتا ہے۔
- اکاؤنٹ کسی اور easyCoexistence اکاؤنٹ کے ذریعے پہلے ہی کنیکٹ ہے:
last_errorیہ بتاتا ہے، اور صارف کسی اور اکاؤنٹ سے سائن ان کرتا ہے۔ - صارف Cancel and go back منتخب کرے: آپ کے
redirect_urlکو status=cancelled ملتا ہے اور سیشن بند ہو جاتا ہے، اس لیے دوسری کوشش کے لیے نیا سیشن بنائیں۔ - لنک ایکسپائر ہو گیا: نیا سیشن بنائیں۔
اگر نمبر صارف کے ٹوکن کے بغیر کنیکٹ ہو جائے تو؟
Meta کبھی کبھی Embedded Signup صارف کا اپنا بزنس ٹوکن جاری کیے بغیر مکمل کر دیتا ہے۔ اس صورت میں ہوسٹڈ پیج ایک بار اور چلانے کو کہتا ہے، جس میں چند سیکنڈ لگتے ہیں۔ اگر صارف اسے چھوڑ دے تو سیشن connected پڑھا جاتا ہے جس میں token_ready false ہوتا ہے، اور آپ کے ایونٹس URL پر connection.token_missing آتا ہے: نمبر پیغامات وصول کرتا ہے، کیونکہ اس کی آئی ڈیز درست ہیں، لیکن ایک نیا کنیکٹ سیشن اسے دوبارہ کنیکٹ کر کے ٹوکن جاری کرنے تک پیغام نہیں بھیج سکتا۔
اگر webhook_url Meta کی جانچ میں ناکام ہو تو؟
نمبر پھر بھی کنیکٹ ہو جاتا ہے۔ Meta webhook_url کو GET ہینڈ شیک سے جانچتا ہے، جسے آپ کا اینڈ پوائنٹ پاس کرتا ہے جب hub.verify_token ملنے پر hub.challenge واپس لوٹائے۔ اگر ناکام ہو تو سیشن کا last_error webhook_url was not applied سے شروع ہوتا ہے اور Meta کی وجہ دیتا ہے، اور جب اینڈ پوائنٹ جواب دے تو PUT /connections/:id/webhook منزل سیٹ کرتا ہے۔ کنیکٹ کے 24 گھنٹے کے اندر سیٹ ہو تو یہ اب بھی رابطوں کا ایک بار کا امپورٹ اور، اگر صارف نے شیئر کرنے کی اجازت دی ہو، چیٹ ہسٹری وصول کرتا ہے۔
صارف کیا دیکھتا ہے؟
easycoexistence.com پر ایک صفحہ جس میں partner_name سے آپ کا نام ہوتا ہے، اور بھرنے کے لیے کوئی اکاؤنٹ، ای میل یا کارڈ نہیں۔ واٹس ایپ نمبر کے لیے ایک مختصر اہلیت کی چیک لسٹ دکھائی جاتی ہے، پھر Meta کا پاپ اپ اور ایک QR کوڈ جسے WhatsApp Business ایپ سے اسکین کیا جاتا ہے۔ سوشل اکاؤنٹ کے لیے ایک بٹن دکھایا جاتا ہے، جیسے Continue with TikTok، جو اسی ٹیب میں نیٹ ورک کی اپنی رضامندی کی اسکرین کھولتا ہے، اس لیے یہ فون پر بھی کام کرتا ہے۔
عام غلطیاں
- کوئری اسٹرنگ پر اکیلے بھروسہ کرنا۔ کوئی بھی URL میں status=connected لکھ سکتا ہے، اس لیے صارف کو کنیکٹ ہوا نشان زد کرنے سے پہلے اپنے بیک اینڈ سے GET /connect-sessions/:id کے ذریعے تصدیق کریں۔
- لنک کو iframe میں ایمبیڈ کرنا۔ صارف کو ری ڈائریکٹ یا نئے ٹیب کے ذریعے بھیجیں، کیونکہ ہوسٹڈ پیج اور اس سے کھلنے والے سائن ان اسی طرح چلنے کے لیے بنائے گئے ہیں۔
- لنک پہلے سے بنانا۔ ہر لنک ایک گھنٹے تک کام کرتا ہے اور ہر کھلا لنک 50 کی حد میں شمار ہوتا ہے، اس لیے سیشن اس وقت بنائیں جب صارف کنیکٹ کرنے والا ہو۔
- 200 حروف سے لمبا webhook_url بھیجنا۔ Meta 200 حروف تک کے متبادل کال بیک URL قبول کرتا ہے، اس لیے اس سے لمبا لاگو نہیں ہوتا اور نمبر اس کے بغیر کنیکٹ ہو جاتا ہے۔
easyCoexistence آپ کے صارفین کے واٹس ایپ نمبرز اور ان کے Instagram، Facebook، TikTok، YouTube اور LinkedIn اکاؤنٹس، اور مزید چینلز کو ایک ہوسٹڈ لنک کے ذریعے آپ کے سافٹ ویئر سے جوڑتا ہے، پھر آپ کے بیک اینڈ کو ہر کنکشن کی کریڈینشیلز، ویب ہکس اور دستخط شدہ اسٹیٹس ایونٹس دیتا ہے۔ US$ 9 سے US$ 0.75 فی کنکشن فی مہینہ، جیسے جیسے آپ کنکشن بڑھاتے ہیں قیمت کم ہوتی جاتی ہے، اور پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
کیا ایک کنیکٹ لنک دو بار استعمال ہو سکتا ہے؟
نہیں۔ لنک ایک نمبر یا ایک سوشل سائن ان پر مکمل ہوتا ہے، جو Facebook یا LinkedIn پر کئی Pages بھی لا سکتا ہے۔ اس کے بعد وہ connected ظاہر ہوتا ہے، اس لیے اگلے کنکشن کے لیے نیا سیشن بنائیں۔
کیا میں لنک ای میل یا چیٹ پر بھیج سکتا ہوں؟
ہاں، بشرطیکہ صارف اسے ایک گھنٹے کے اندر کھولے۔ URL میں موجود سیشن آئی ڈی ہی صفحے کو اجازت دیتی ہے، اس لیے ہر لنک صرف اسی صارف کو بھیجیں جس کے لیے بنایا گیا تھا۔
کیا ہوسٹڈ پیج فون پر کام کرتا ہے؟
سوشل سائن ان فون پر کام کرتے ہیں، کیونکہ وہ اسی ٹیب میں کھلتے ہیں۔ واٹس ایپ نمبر بہتر طور پر کمپیوٹر سے کنیکٹ ہوتا ہے: فون پر Meta کا پاپ اپ نئے ٹیب میں کھلتا ہے، اور QR کوڈ اسکین کرنے کے لیے فون خود درکار ہے۔
پولنگ کے بغیر کیسے معلوم ہو کہ صارف کنیکٹ ہو گیا؟
ڈیش بورڈ میں Profile، Developers کے تحت ایک اسٹیٹس ایونٹس URL سیٹ کریں۔ کنکشن بنتے ہی easyCoexistence connection.connected یا channel.connected بھیجتا ہے، دستخط شدہ اور آپ کے external_ref کے ساتھ۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ