ملٹی ٹیننٹ سوشل میڈیا API: ایک API کی، کسٹمرز کے کئی اکاؤنٹس
easyCoexistence کا Partner API ڈیزائن ہی سے ملٹی ٹیننٹ ہے: آپ کے اکاؤنٹ پر موجود ایک ec_live_ کی کئی کسٹمرز کے واٹس ایپ نمبرز اور سوشل اکاؤنٹس کو کنیکٹ اور منیج کرتی ہے۔ ہر کنکشن میں آپ کے کسٹمر کا آئی ڈی بطور external_ref ہوتا ہے، اس کا اپنا ٹوکن ہوتا ہے، اس کی اپنی ویب ہک منزل ہوتی ہے اور وہ سائن شدہ اسٹیٹس ایونٹس میں ظاہر ہوتا ہے، اس لیے GET /channels?external_ref= کسی ایک کسٹمر کے اکاؤنٹس کی فہرست دیتا ہے۔
کنیکٹ سیشن کے external_ref کی زیادہ سے زیادہ لمبائی: کسٹمر کا آپ کا اپنا آئی ڈی، جو اس سے بننے والے کنکشن پر محفوظ ہوتا ہے۔
ایک easyCoexistence اکاؤنٹ ایک وقت میں جتنی API کیز رکھ سکتا ہے؛ الگ کیز کا مطلب ہے الگ اکاؤنٹس اور الگ بلز۔
ایک اکاؤنٹ ایک وقت میں جتنے کنیکٹ سیشنز کھلے رکھ سکتا ہے، اور ساتھ ہی ایک گھنٹے میں 100 نئے سیشنز کی حد بھی ہے۔
وہ عمر جس کے بعد سائن شدہ ایونٹ کا ٹائم اسٹیمپ مسترد کیا جانا چاہیے، اور HMAC مستقل وقت میں موازنہ کیا جاتا ہے۔
ایک اکاؤنٹ کئی کسٹمرز کو کیسے سروس دیتا ہے؟
آپ کا easyCoexistence اکاؤنٹ آپ کی پروڈکٹ کی نمائندگی کرتا ہے، اور ہر کسٹمر ان کنکشنز پر ایک ٹیگ ہے جو وہ لاتے ہیں۔ کسٹمرز کا اپنا کوئی اکاؤنٹ نہیں بنتا، وہ آپ کی کیز نہیں دیکھتے اور ان کا بل آپ بھیجتے ہیں، easyCoexistence نہیں:
ہر کنکشن کو اپنے کسٹمر سے کیسے ٹیگ کریں؟
کنیکٹ سیشن پر external_ref بھیجیں۔ یہ قدر اس نمبر یا چینل پر محفوظ ہوتی ہے جو سیشن بناتا ہے، ری ڈائریکٹ میں شامل ہوتی ہے اور اس کے اسٹیٹس ایونٹس میں آتی ہے۔ فیس بک یا لنکڈ ان سائن ان جو کئی پیجز لائے، وہ ہر ایک کو ٹیگ کرتا ہے۔ کسی ایک کسٹمر کے اکاؤنٹس دیکھنے کے لیے کوئی بھی فہرست فلٹر کریں:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"کسٹمرز کے ٹوکن الگ الگ کیسے رکھے جاتے ہیں؟
ہر کنکشن اپنے کسٹمر کا اپنا ٹوکن رکھتا ہے۔ واٹس ایپ نمبر کا ٹوکن وہ بزنس ٹوکن ہے جو Meta، Embedded Signup کے دوران جاری کرتا ہے اور اس کسٹمر کے اثاثوں تک محدود ہوتا ہے، جب کہ سوشل اکاؤنٹ کا ٹوکن وہ ہے جو اس کے مالک نے دیا۔ کریڈینشلز صرف آپ کی کیز کے ذریعے، آپ کے بیک اینڈ سے آتے ہیں، اور آپ کے اکاؤنٹ پر موجود نہ ہونے والی آئی ڈی 404 not_found دیتی ہے۔ ٹوکن حاصل کرنے سے پہلے، اس کسٹمر کا کنکشن دیکھیں جس سے وہ جاب تعلق رکھتی ہے، تاکہ کسی ایک ٹیننٹ کا کام کسی دوسرے کے اکاؤنٹ پر نہ چلے۔
ہر کسٹمر کے لیے ویب ہکس کیسے کام کرتے ہیں؟
ہر اکاؤنٹ کے لیے ایک ویب ہک منزل، جسے آپ خود چنتے ہیں۔ چینلز کو ایک URL پر مقرر کریں اور باڈی میں account_id کی بنیاد پر روٹ کریں، یا ہر کسٹمر کو اس کا اپنا URL دیں۔ ہر چینل اپنے سیکرٹ سے سائن کرتا ہے، جو PUT /channels/{id}/webhook کے ذریعے مقرر ہوتا ہے، اس لیے account_id بتاتا ہے کہ تصدیق کے لیے کون سا سیکرٹ استعمال کرنا ہے۔ کسی نمبر کے پیغامات Meta سے اس کے webhook_url پر جاتے ہیں، جو WhatsApp Business Account پر مقرر ہوتا ہے، اس لیے انہیں phone_number_id کی بنیاد پر روٹ کریں۔
اسٹیٹس ایونٹس بتاتے ہیں کہ وہ کس کسٹمر سے متعلق ہیں؟
ان میں آپ کا external_ref شامل ہوتا ہے۔ ہر اکاؤنٹ کا ایک ایونٹس URL connection.* اور channel.* ایونٹس وصول کرتا ہے، ہر ایک کے اندر کنکشن یا چینل کا ویو ہوتا ہے، جس میں external_ref بھی شامل ہے۔ post.published اور post.failed، پوسٹ اور اس کے چینل کے ساتھ آتے ہیں۔ ایونٹس اکاؤنٹ کے اپنے سیکرٹ سے X-EC-Signature میں سائن ہوتے ہیں اور آپ کا اینڈ پوائنٹ ناکام ہونے پر دوبارہ بھیجے جاتے ہیں، اس لیے ہر ڈیلیوری آئی ڈی کو صرف ایک بار ہینڈل کریں۔
آپ کتنی تیزی سے کئی کسٹمرز کو آن بورڈ کر سکتے ہیں؟
فی اکاؤنٹ 50 کھلے کنیکٹ سیشنز اور فی گھنٹہ 100 نئے سیشنز کی حد ہے۔ Meta ہر پہلی بار کی واٹس ایپ آن بورڈنگ کو ایک پوری ایپ کی سطح کی حد کے خلاف شمار کرتا ہے، جسے ہر easyCoexistence اکاؤنٹ مشترکہ طور پر استعمال کرتا ہے، اور یہ حدیں یقینی بناتی ہیں کہ کسی ایک پلیٹ فارم کا امپورٹ پوری حد ختم نہ کر دے۔ ہر سیشن اس وقت بنائیں جب اس کا کسٹمر کنیکٹ کرنے والا ہو، اور حد آنے پر 429 cap_reached یا rate_limited جواب ملتا ہے۔
اگر کسی کسٹمر کا اکاؤنٹ پہلے ہی کہیں اور کنیکٹ ہو؟
سائن ان مسترد ہو جاتا ہے۔ سوشل اکاؤنٹ ایک وقت میں ایک easyCoexistence اکاؤنٹ کے ساتھ کنیکٹ ہوتا ہے، اس لیے اگر کوئی اور سروس جو easyCoexistence استعمال کرتی ہے اسے پہلے سے رکھے ہوئے ہے، تو سیشن کا last_error یہی بتاتا ہے اور کسٹمر اسے وہاں سے ہٹا دیتا ہے یا کسی دوسرے اکاؤنٹ سے سائن ان کرتا ہے۔ آپ کے اپنے اکاؤنٹ کے اندر، کسٹمر جتنے بھی اکاؤنٹس چاہے کنیکٹ کر سکتا ہے، اور ہر ایک کو ایک ہی external_ref کے ساتھ ٹیگ کیا جاتا ہے۔
ایک کسٹمر کو کیسے آف بورڈ کریں؟
external_ref کے ذریعے ان کے کنکشنز اور چینلز کی فہرست لیں اور ہر ایک پر DELETE چلائیں۔ نمبر ہٹانے سے easyCoexistence کی Meta پر رسائی منسوخ ہو جاتی ہے اور مانیٹرنگ بند ہو جاتی ہے؛ چینل ہٹانے سے نیٹ ورک پر رسائی منسوخ ہوتی ہے اور قطار میں باقی پوسٹس منسوخ ہو جاتی ہیں۔ ہر ایک کی بلنگ سائیکل کے آخر میں بند ہوتی ہے، اور اس کسٹمر کے باقی کنکشنز اور دوسرے ٹیننٹس کے کنکشنز متاثر نہیں ہوتے۔
عام غلطیاں
- بطور external_ref ای میل استعمال کرنا۔ ای میلز بدلتی ہیں اور یہ قدر ہر کنکشن پر محفوظ ہوتی ہے، اس لیے اپنے ڈیٹا بیس کا مستقل آئی ڈی استعمال کریں۔
- فارورڈ ایونٹس کی تصدیق غلط ٹیننٹ کے سیکرٹ سے کرنا۔ باڈی کے account_id سے سیکرٹ تلاش کریں، کیونکہ ہر چینل اپنے سیکرٹ سے سائن کرتا ہے۔
- پوری کسٹمر بیس کو ایک ساتھ کنیکٹ لنکس بھیجنا۔ ہر اکاؤنٹ پر صرف 50 سیشنز کھلے ہو سکتے ہیں، اس لیے کسٹمرز کو لہروں میں مدعو کریں۔
- صرف اپنے ڈیٹا بیس میں کسٹمر کو حذف کرنا۔ ان کے کنکشنز آپ کے اکاؤنٹ اور آپ کے بل پر رہتے ہیں، جب تک ہر ایک کو API کے ذریعے ہٹا نہ دیا جائے۔
easyCoexistence ایک ہی API کی سے آپ کی پوری کسٹمر بیس کو سروس دینے دیتا ہے: ان کے واٹس ایپ نمبرز اور ان کے Instagram، Facebook، TikTok، YouTube اور LinkedIn اکاؤنٹس، اور مزید چینلز، ہر ایک آپ کے کسٹمر آئی ڈی سے ٹیگ ہو، اپنے ٹوکن، ویب ہک اور سائن شدہ ایونٹس کے ساتھ، اور ہر کنکشن 24/7 مانیٹر ہو۔ فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، کنکشنز بڑھنے کے ساتھ کم ہوتا جاتا ہے، پہلے 3 دن فری ٹرائل ہے۔
اکثر پوچھے جانے والے سوالات
کیا ہر کسٹمر کے لیے ایک easyCoexistence اکاؤنٹ چاہیے؟
نہیں۔ ایک اکاؤنٹ اور اس کی کی کئی کسٹمرز کے کنکشنز رکھ سکتی ہے، جنہیں external_ref سے الگ پہچانا جاتا ہے۔ الگ اکاؤنٹس کی ضرورت صرف تب ہے جب آپ کو الگ بلز چاہیے ہوں۔
کیا میرے کسٹمرز ایک دوسرے کے اکاؤنٹس دیکھ سکتے ہیں؟
easyCoexistence کے ذریعے نہیں۔ وہ آپ کی کیز کبھی نہیں رکھتے اور صرف اپنے کنیکٹ لنکس کھولتے ہیں۔ آپ کی پروڈکٹ کے اندر ہر کسٹمر کیا دیکھتا ہے، یہ آپ کا کوڈ طے کرتا ہے۔
کیا میں ہر کسٹمر کو مختلف ویب ہک URL دے سکتا ہوں؟
ہاں۔ ہر نمبر اور ہر چینل کی اپنی منزل ہوتی ہے، اس لیے کسٹمر کے مخصوص URL بھی کام کرتا ہے، اور ایک مشترکہ URL جو account_id کی بنیاد پر روٹ ہو وہ بھی۔
ملٹی ٹیننٹ اکاؤنٹ کا بل کیسے بنتا ہے؟
تمام کسٹمرز کے کنکشنز ملا کر فی کنکشن فی مہینہ: US$ 9 سے US$ 0.75 تک، جو آپ کی کل تعداد کے بینڈ سے طے ہوتا ہے، اور پہلے 3 دن فری ٹرائل ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ