لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

ملٹی ٹیننٹ سوشل میڈیا API: ایک API کی، کسٹمرز کے کئی اکاؤنٹس

easyCoexistence کا Partner API ڈیزائن ہی سے ملٹی ٹیننٹ ہے: آپ کے اکاؤنٹ پر موجود ایک ec_live_ کی کئی کسٹمرز کے واٹس ایپ نمبرز اور سوشل اکاؤنٹس کو کنیکٹ اور منیج کرتی ہے۔ ہر کنکشن میں آپ کے کسٹمر کا آئی ڈی بطور external_ref ہوتا ہے، اس کا اپنا ٹوکن ہوتا ہے، اس کی اپنی ویب ہک منزل ہوتی ہے اور وہ سائن شدہ اسٹیٹس ایونٹس میں ظاہر ہوتا ہے، اس لیے GET /channels?external_ref= کسی ایک کسٹمر کے اکاؤنٹس کی فہرست دیتا ہے۔

200 characters

کنیکٹ سیشن کے external_ref کی زیادہ سے زیادہ لمبائی: کسٹمر کا آپ کا اپنا آئی ڈی، جو اس سے بننے والے کنکشن پر محفوظ ہوتا ہے۔

1 key

ایک easyCoexistence اکاؤنٹ ایک وقت میں جتنی API کیز رکھ سکتا ہے؛ الگ کیز کا مطلب ہے الگ اکاؤنٹس اور الگ بلز۔

50 open

ایک اکاؤنٹ ایک وقت میں جتنے کنیکٹ سیشنز کھلے رکھ سکتا ہے، اور ساتھ ہی ایک گھنٹے میں 100 نئے سیشنز کی حد بھی ہے۔

5 minutes

وہ عمر جس کے بعد سائن شدہ ایونٹ کا ٹائم اسٹیمپ مسترد کیا جانا چاہیے، اور HMAC مستقل وقت میں موازنہ کیا جاتا ہے۔

ایک اکاؤنٹ کئی کسٹمرز کو کیسے سروس دیتا ہے؟

آپ کا easyCoexistence اکاؤنٹ آپ کی پروڈکٹ کی نمائندگی کرتا ہے، اور ہر کسٹمر ان کنکشنز پر ایک ٹیگ ہے جو وہ لاتے ہیں۔ کسٹمرز کا اپنا کوئی اکاؤنٹ نہیں بنتا، وہ آپ کی کیز نہیں دیکھتے اور ان کا بل آپ بھیجتے ہیں، easyCoexistence نہیں:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

ہر کنکشن کو اپنے کسٹمر سے کیسے ٹیگ کریں؟

کنیکٹ سیشن پر external_ref بھیجیں۔ یہ قدر اس نمبر یا چینل پر محفوظ ہوتی ہے جو سیشن بناتا ہے، ری ڈائریکٹ میں شامل ہوتی ہے اور اس کے اسٹیٹس ایونٹس میں آتی ہے۔ فیس بک یا لنکڈ ان سائن ان جو کئی پیجز لائے، وہ ہر ایک کو ٹیگ کرتا ہے۔ کسی ایک کسٹمر کے اکاؤنٹس دیکھنے کے لیے کوئی بھی فہرست فلٹر کریں:

One customer's social accounts and numbers
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 کے ساتھ یہ کام کرنا

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 دن فری ٹرائل ہے۔

مزید پڑھیں

وائٹ لیبل سوشل میڈیا API: اپنے SaaS میں پوسٹنگ، کمنٹس اور DMs اپنے برانڈ کے تحت شامل کریںاپنے SaaS میں پوسٹنگ، کمنٹ کے جواب اور DMs شامل کریں: صارف کیا دیکھتے ہیں، کہاں easyCoexistence کا نام اب بھی نظر آتا ہے، اور پیچھے کی API کالز۔اپنے گاہکوں کو انسٹاگرام اپنی ایپ سے کیسے جوڑنے دیںآپ کے گاہکوں کے انسٹاگرام اکاؤنٹس کے لیے ہوسٹڈ لنک: سیشن کال، ٹوکن، اور پوسٹ اور جواب دینے کا طریقہ۔WhatsApp کو Embedded Signup اور Coexistence کے ذریعے اپنے SaaS میں کیسے شامل کریںSaaS میں WhatsApp شامل کریں: گاہکوں کے نمبر Embedded Signup اور Coexistence سے جوڑیں، میسج وصول کریں، 24 گھنٹے کی ونڈو میں جواب دیں اور ٹیمپلیٹ بھیجیں۔پارٹنر API توثیق: Bearer ec_live_ کلیدیں، روٹیشن اور 401 خرابیاںPartner API درخواستوں کی توثیق کا طریقہ: ہر اکاؤنٹ کی ایک ec_live_ کلید، جو ایک بار دکھائی جاتی ہے، اور 401 خرابی۔کسٹمر کا WhatsApp یا سوشل کنکشن کب منقطع ہوتا ہے، یہ کیسے جانیںconnection.* اور channel.* اسٹیٹس ایونٹس: پے لوڈ، وجوہات، X-EC-Signature، تقریباً 33 گھنٹے تک دوبارہ کوشش اور id سے ڈپلیکیٹ روکنا۔اپنی ایپ میں صارفین کو واٹس ایپ، انسٹاگرام اور ٹک ٹاک اکاؤنٹس کنیکٹ کرنے دیںہوسٹڈ کنیکٹ لنکس آپ کے صارفین کے واٹس ایپ نمبرز اور سوشل اکاؤنٹس کے لیے: سیشن کی درخواست، ری ڈائریکٹ، اسٹیٹس، میعاد اور دوبارہ کوشش۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ