گاہک کے API ٹوکن کیسے حاصل کریں: WhatsApp، Instagram اور TikTok کے لیے
easyCoexistence کا Partner API ایک GET اور ?credentials=1 کے ساتھ جڑے ہوئے گاہک کا API ٹوکن اور IDs واپس کرتا ہے۔ WhatsApp نمبر کے لیے، /connections/{id} دیتا ہے waba_id، phone_number_id، Graph API کا بیس، send اینڈ پوائنٹ اور گاہک کا اپنا کاروباری ٹوکن۔ سوشل اکاؤنٹ کے لیے، /channels/{id} دیتا ہے نیٹ ورک کا API بیس، وہاں اکاؤنٹ کی ID اور ایک access ٹوکن جو آپ کے لیے تجدید ہو چکا ہوتا ہے، اس لیے اسے ہر جاب کے آغاز پر حاصل کریں۔
WhatsApp نمبر کے لیے GET /connections/{id} اور سوشل اکاؤنٹ کے لیے GET /channels/{id} میں credentials شامل کرتا ہے۔
Google صارف کے access ٹوکن کی مدت، وہی ٹوکن جو YouTube چینل کی API کالز کے ساتھ جاتا ہے۔
API for Business سے ملنے والے TikTok اکاؤنٹ access ٹوکن کی مدت؛ اس کا ریفریش ٹوکن ایک سال تک درست رہتا ہے۔
تازہ کیے گئے طویل مدتی Instagram ٹوکن کی مدت، اسی دن سے شمار کی جاتی ہے جب اسے تازہ کیا گیا۔
Meta کے طویل مدتی Page access ٹوکنز کی کوئی میعاد ختم نہیں ہوتی، البتہ کچھ شرائط انہیں غیر فعال کر سکتی ہیں۔
کون سی کال کسی کنکشن کے کریڈینشلز واپس کرتی ہے؟
وسیلے کی اپنی GET کال ?credentials=1 کے ساتھ، جو آپ کی ec_live_ کلید سے bearer ٹوکن کے طور پر تصدیق شدہ ہوتی ہے۔ WhatsApp نمبر /connections/{id} پر رہتا ہے اور سوشل اکاؤنٹ /channels/{id} پر، ہر ایک کا اپنا ID دائرہ ہے: connect ری ڈائریکٹ نمبر کے لیے connection_id اور سوشل اکاؤنٹ کے لیے channel_id دیتا ہے۔ GET /connections اور GET /channels انہیں فہرست میں دیتے ہیں، اور ?external_ref= کسی بھی فہرست کو ایک گاہک تک محدود کر دیتا ہے۔ پیرامیٹر کے بغیر، یہی کالز ٹوکن کے بغیر کنکشن واپس کرتی ہیں۔
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"WhatsApp نمبر کی کریڈینشلز کال کیا واپس کرتی ہے؟
خود کنکشن کے ساتھ ایک credentials آبجیکٹ۔ waba_id اور phone_number_id، Meta کے Graph API پر WhatsApp Business Account اور نمبر کی شناخت کرتے ہیں، جبکہ token_ready بتاتا ہے کہ گاہک کا ٹوکن موجود ہے یا نہیں۔ credentials کے اندر، graph_api_base اور send_endpoint پہلے ہی Graph API ورژن رکھتے ہیں، اور access_token وہ کاروباری ٹوکن ہے جو Meta نے گاہک کے کنیکٹ کرنے پر جاری کیا، جو اس گاہک تک محدود ہے۔ آپ کا بیک اینڈ پھر میسجز بھیجنے، ٹیمپلیٹس کا انتظام کرنے، میڈیا اپ لوڈ کرنے اور کاروباری پروفائل میں ترمیم کے لیے براہ راست Meta کو کال کرتا ہے۔
- status: connected، degraded، disconnected، banned، suspended، removed یا unknown۔
quality_ratingاورmessaging_tier: Meta کی ریٹنگ، جیسے GREEN، اور نمبر کا ٹائر، جیسےTIER_1K۔webhook_url: وہ جگہ جہاں Meta نمبر کے میسجز بھیجتا ہے، یا null۔disconnected_reason،last_checked_at،last_event_atاورcreated_at: Meta کی منقطع ہونے کی وجہ، جب ریکارڈ میں ہو، اور ISO 8601 ٹائم اسٹیمپس۔
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}ہر سوشل نیٹ ورک کی کریڈینشلز کال کیا واپس کرتی ہے؟
چینل کا وہی منظر جو GET /channels/{id} دیتا ہے، یعنی id، channel، external_ref، name، username، external_id، status اور token_ready، ساتھ ایک credentials آبجیکٹ۔ ہر نیٹ ورک کے credentials میں platform، ایک API بیس، اس نیٹ ورک پر اکاؤنٹ کی ID، access_token، token_expires_at، token_note اور مثالی کالز ہوتی ہیں۔ ID فیلڈ، اور کوئی بھی دوسری چیز جس کی نیٹ ورک کو ضرورت ہو، مختلف ہوتی ہے:
ٹوکن ہر جاب کے لیے کیوں حاصل کریں، اسٹور کرنے کے بجائے؟
کیونکہ کچھ ٹوکن ایک دن کے اندر تبدیل ہو جاتے ہیں، اور کریڈینشلز کال ہمیشہ اس لمحے کے لیے درست ٹوکن واپس کرتی ہے۔ YouTube کا Google ٹوکن ایک گھنٹہ چلتا ہے اور TikTok کا ایک دن، اور easyCoexistence دونوں کو ختم ہونے سے پہلے تجدید کرتا ہے۔ Instagram کا ٹوکن 60 دن چلتا ہے اور اس سے کافی پہلے تازہ ہو جاتا ہے، جس سے نیا ٹوکن جاری ہوتا ہے۔ Facebook Page کا ٹوکن جب تک Page کنیکٹ رہے ختم نہیں ہوتا۔ ہر جاب کے آغاز پر ایک درخواست آپ کے کوڈ کو کبھی بھی ایسے ٹوکن کے ساتھ کسی نیٹ ورک کو کال کرنے نہیں دیتی جو ختم ہو چکا ہو۔
کیا آپ کو WhatsApp نمبر کا ٹوکن اسٹور کرنا چاہیے؟
جی ہاں۔ یہ Meta کے Embedded Signup سے آنے والا کاروباری ٹوکن ہے، جسے Meta اس آن بورڈ ہونے والے گاہک تک محدود رکھتا ہے، اور ریفرنس آپ سے اسے اپنی طرف اسٹور کرنے کو کہتا ہے، کیونکہ ڈیش بورڈ اسے نہیں دکھاتا۔ ہر connection.connected ایونٹ کے بعد اسے دوبارہ پڑھیں، کیونکہ دوبارہ کنیکٹ کرنے سے نیا ٹوکن جاری ہو سکتا ہے۔ معطل یا ہٹائے گئے نمبر کا ٹوکن اب پیش نہیں کیا جاتا، اور گاہک کا وہ ٹوکن جسے Meta قبول کرنا بند کر دے جبکہ نمبر پھر بھی جواب دے، ریٹائر ہو جاتا ہے، جس سے token_ready غلط ہو جاتا ہے۔
token_ready اور token_missing کا کیا مطلب ہے؟
token_ready اس وقت true ہوتا ہے جب گاہک کا ٹوکن موجود ہو اور کنکشن فعال ہو۔ نمبر پر یہ کنیکٹ کرنے کے فوراً بعد false ہو سکتا ہے، کیونکہ Meta کبھی کبھی Embedded Signup گاہک کا ٹوکن جاری کیے بغیر مکمل کر دیتا ہے۔ ہوسٹڈ صفحہ پھر گاہک سے ایک بار اور عمل کرنے کو کہتا ہے، اور آپ کا ایونٹس اینڈ پوائنٹ connection.token_missing وصول کرتا ہے۔ اگر وہ اسے چھوڑ دیں، تو نمبر پیغامات وصول کرتا ہے، کیونکہ اس کی IDs درست ہیں، مگر بھیج نہیں سکتا۔ اس گاہک کے لیے نیا connect سیشن ٹوکن جاری کرتا ہے اور کبھی اس ٹوکن کی جگہ نہیں لیتا جو پہلے سے کام کر رہا ہو۔ سوشل چینلز پر token_missing نہیں ہوتا: ان کا سائن اِن ہمیشہ گاہک کا اپنا ٹوکن دیتا ہے، لہٰذا token_ready اسٹیٹس کی پیروی کرتا ہے۔
جب کنکشن کے پاس دینے کو ٹوکن نہ ہو تو کیا واپس آتا ہے؟
200 جس کے credentials میں access_token null ہو اور ایک نوٹ ہو کہ کیا کرنا ہے، نہ کہ خرابی۔ یہ اس نمبر پر لاگو ہوتا ہے جس کا token_ready false ہو، معطل یا ہٹایا گیا نمبر، اور وہ چینل جس کا اسٹیٹس connected نہیں، جہاں نوٹ نیا connect سیشن مانگتا ہے۔ 404 not_found کا مطلب ہے کہ ID آپ کے اکاؤنٹ میں نہیں، اور 502 credentials_unavailable کا مطلب ہے کہ اس لمحے تازہ سوشل ٹوکن حاصل نہیں ہو سکا؛ دوبارہ کوشش کریں، اور اگر یہ دہرائے تو چینل کا اسٹیٹس دیکھیں۔
عام غلطیاں
- YouTube یا TikTok کا ٹوکن کنفیگ فائل میں کیش کرنا۔ یہ ایک گھنٹے اور ایک دن کے اندر ختم ہو جاتے ہیں، اس لیے ہر جاب کے آغاز پر credentials اینڈ پوائنٹ کو کال کریں اور تجدید easyCoexistence پر چھوڑ دیں۔
- ایسے نمبر سے بھیجنا جس کا token_ready false ہو۔ Meta کو کال کرنے کے لیے گاہک کا کوئی ٹوکن نہیں ہوتا؛ اس گاہک کے لیے نیا connect سیشن کھولیں، جو ایک جاری کرے گا۔
- TikTok کو Authorization ہیڈر کے ساتھ کال کرنا۔ اس کا Business API ٹوکن Access-Token ہیڈر میں لیتا ہے، اور ہر درخواست میں اکاؤنٹ کا business_id شامل ہوتا ہے۔
- LinkedIn کو صرف bearer ٹوکن کے ساتھ کال کرنا۔ LinkedIn کو LinkedIn-Version اور X-Restli-Protocol-Version ہیڈرز بھی چاہئیں جو required_headers میں درج ہیں، اور paths میں URNs URL-encoded ہوں۔
easyCoexistence آپ کے گاہکوں کے WhatsApp نمبرز اور ان کے Instagram، Facebook، TikTok، YouTube اور LinkedIn اکاؤنٹس کو کنیکٹ کرتا ہے، اور مزید چینلز بھی، پھر ہر کنکشن کے کریڈینشلز درخواست پر آپ کے بیک اینڈ کو دیتا ہے، سوشل ٹوکن کی تجدید کے ساتھ اور ہر کنکشن 24/7 مانیٹر ہوتا ہے۔ US$ 9 سے US$ 0.75 فی کنکشن فی مہینہ، جیسے جیسے آپ کنکشن بڑھاتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن فری ٹرائل میں۔
اکثر پوچھے جانے والے سوالات
کیا WhatsApp ٹوکن گاہک کا اپنا ہے؟
جی ہاں۔ یہ وہ کاروباری ٹوکن ہے جو Meta گاہک کے Embedded Signup کے ذریعے کنیکٹ کرنے پر جاری کرتا ہے، جو اسی گاہک تک محدود ہے۔ easyCoexistence کا سسٹم ٹوکن کبھی ظاہر نہیں کیا جاتا، اور کال صرف اس وقت ٹوکن لوٹاتی ہے جب token_ready true ہو۔
سوشل access ٹوکن کتنی دیر چلتے ہیں؟
YouTube کا ایک گھنٹہ، TikTok کا ایک دن اور Instagram کا 60 دن تک، جبکہ Facebook Page کا ٹوکن ختم نہیں ہوتا۔ easyCoexistence وہ ٹوکن تجدید کرتا ہے جو تبدیل ہوتے ہیں، اس لیے ہر credentials کال ایسا ٹوکن لوٹاتی ہے جو ابھی کام کرتا ہے۔
کیا ہر نیٹ ورک پر میری اپنی ڈیولپر ایپ چاہیے؟
نہیں۔ گاہک easyCoexistence کی اپنی ایپ کے ذریعے Meta، TikTok، Google اور LinkedIn پر سائن اِن کرتے ہیں، اور credentials کال آپ کے بیک اینڈ کو اس نیٹ ورک کی API براہ راست کال کرنے کے لیے ٹوکن دیتی ہے۔
کیا Claude یا ChatGPT جیسا اسسٹنٹ وہی کریڈینشلز پڑھ سکتا ہے؟
جی ہاں۔ MCP سرور کے ذریعے آپ کے اکاؤنٹ میں سائن اِن ہو کر، یہ نمبر کے لیے get_api_credentials اور سوشل اکاؤنٹ کے لیے get_social_credentials کال کر سکتا ہے، جو Partner API کی طرح وہی کریڈینشلز لوٹاتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ