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

TikTok API for Business ویب ہکس کی ترتیب

TikTok کا API for Business ہر ڈیویلپر ایپ اور ایونٹ کی قسم کے لیے ایک کال بیک URL پر ویب ہکس بھیجتا ہے، جو POST /business/webhook/update/ کے ذریعے ایپ کے app_id اور سیکرٹ سے سیٹ ہوتا ہے۔ event_type کی قیمت VIDEO پوسٹ اشاعت کے چار ایونٹس کو سبسکرائب کرتی ہے، اور COMMENT ایونٹ comment.update کو۔ ہر ڈیلیوری ایک HTTPS POST ہے جس پر Tiktok-Signature ہیڈر میں HMAC-SHA256 سگنیچر ہوتا ہے، جو ایپ سیکرٹ سے بنتا ہے۔

easyCoexistence TikTok کا کمنٹ ویب ہک اپنی ایپ کے لیے سبسکرائب رکھتا ہے، TikTok کا سگنیچر چیک کرتا ہے اور آپ کے اکاؤنٹ کا ہر کمنٹ ایونٹ آپ کے HTTPS اینڈ پوائنٹ تک پہنچاتا ہے، جو اس کے اپنے سیکرٹ سے سائن ہوتا ہے۔

72 hours

TikTok کتنی دیر تک HTTP 200 کا جواب نہ ملنے پر ڈیلیوری دوبارہ بھیجتا ہے، ایکسپونینشل بیک آف کے ساتھ، اس سے پہلے کہ اسے ختم کر دے۔

100

ایک item_list میں دی جا سکنے والی پوسٹ IDs کی زیادہ سے زیادہ تعداد، جن سے comment.update ایونٹس کو مخصوص پوسٹس تک محدود کیا جا سکتا ہے۔

v1.0

وہ موجودہ قدر جو TikTok ہر ڈیلیوری کے ساتھ webhook-schema-version ہیڈر میں بھیجتا ہے۔

No permission

TikTok کے ریفرنس میں ویب ہک کنفیگریشن اینڈ پوائنٹس کی فہرست، جو app ID اور سیکرٹ سے تصدیق کرتے ہیں۔

HMAC-SHA256

Tiktok-Signature کا الگورتھم: ٹائم اسٹیمپ، ایک ڈاٹ اور باڈی، جنہیں ایپ سیکرٹ کی کلید کے ساتھ hex میں انکوڈ کیا جاتا ہے۔

Business Comment

comment.update کے لیے TikTok Accounts کے تحت درکار ایپ اجازت؛ اشاعت کے ایونٹس کو Business Content درکار ہے۔

کون سے ویب ہک ایونٹس ایک TikTok اکاؤنٹ ایپ وصول کر سکتی ہے؟

دو زمرے، ہر ایک الگ event_type کے طور پر سبسکرائب ہوتا ہے۔ VIDEO ان پوسٹس کو کور کرتا ہے جو /business/video/publish/ یا /business/photo/publish/ کے ذریعے شائع ہوں، اور COMMENT اکاؤنٹ کی فوٹو پوسٹس اور عوامی ویڈیو پوسٹس پر کمنٹس کو کور کرتا ہے، چاہے وہ API سے شائع ہوئے ہوں یا TikTok ایپ میں:

post.publish.failedVIDEO: the post broke a format rule or its URL was blocked before the download finished
post.publish.completeVIDEO: the file met the format rules and downloaded without problems
post.publish.publicly_availableVIDEO: moderation passed and the post is public, with its post_id
post.publish.no_longer_publicly_availableVIDEO: later moderation, or the owner, took the post out of public view
comment.updateCOMMENT: a comment or reply created, deleted, hidden, set to friends only or made public

سبسکرائب کرنے سے پہلے ایپ کو کیا چاہیے؟

API for Business تک رسائی، ایک ڈیویلپر ایپ، اور وہ TikTok اکاؤنٹس جنہوں نے اسے اجازت دی ہو۔ TikTok کی سبسکرپشن گائیڈ ہر زمرے کے لیے ایک اجازت شامل کرتی ہے، اور کمنٹ ایونٹ کو ہر مالک کی جانب سے ایک اسکوپ درکار ہے:

  • اشاعت کے ایونٹس: ایپ پر TikTok Accounts کی Business Content اجازت۔
  • کمنٹ ایونٹس: ایپ پر TikTok Accounts کی Business Comment اجازت۔
  • comment.update: comment.list اسکوپ، مالک کی جانب سے دیا گیا اور درست رکھا گیا۔
  • HTTPS پر ایک کال بیک URL جو فوراً HTTP 200 کا جواب دے۔

سبسکرائب کیسے کریں؟

/business/webhook/update/ پر POST کے ذریعے، ہر event_type کے لیے ایک بار۔ باڈی میں app_id، سیکرٹ، event_type (VIDEO یا COMMENT) اور callback_url آتے ہیں؛ COMMENT کے لیے item_list بھی دیا جا سکتا ہے۔ جواب میں app_id، event_type، callback_url اور، اگر سیٹ ہو، item_list واپس آتا ہے۔ اسی event_type کے لیے دوبارہ کال کرنے سے callback URL بدل جاتا ہے۔

Subscribe the app to comment events
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/webhook/update/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "event_type": "COMMENT",
    "callback_url": "https://hooks.example.com/tiktok/"
  }'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": { "app_id": "<APP_ID>", "callback_url": "https://hooks.example.com/tiktok/", "event_type": "COMMENT" }
}

item_list کمنٹ ایونٹس کو کیسے محدود کرتی ہے؟

item_list comment.update کو ان پوسٹس تک محدود کرتی ہے جن کے IDs /business/video/list/ سے لیے گئے ہوں، زیادہ سے زیادہ 100 تک۔ پہلی فہرست ہی ایپ کا موڈ آگے کے لیے طے کرتی ہے:

  • پہلی COMMENT کال item_list کے ساتھ: ایونٹس صرف فہرست میں شامل پوسٹس کے لیے آتے ہیں۔
  • بعد کی item_list کالز: نئی پوسٹس پہلے سے موجود پوسٹس کے ساتھ شامل ہو جاتی ہیں۔
  • item_list کے بغیر COMMENT کال، جب پہلے سے کچھ سیٹ نہ ہو: ایونٹس ان اکاؤنٹس کی پوسٹس کے لیے آتے ہیں جنہوں نے ایپ کو اجازت دی ہو۔
  • item_list کے بغیر COMMENT کال، جب فہرست پہلے سے موجود ہو: سیٹ شدہ پوسٹس جوں کی توں رہتی ہیں۔

سبسکرپشن کیسے چیک یا ہٹائیں؟

app_id، سیکرٹ اور event_type کے ساتھ GET /business/webhook/list/ کنفیگریشن واپس کرتا ہے: callback_url صرف تب ظاہر ہوتا ہے جب اس ایونٹ کی قسم کے لیے کوئی موجود ہو، اور item_list صرف تب جب سیٹ کی گئی ہو۔ app_id، سیکرٹ اور event_type کے ساتھ POST /business/webhook/delete/ اسے ہٹاتا ہے؛ COMMENT کے لیے، ڈیلیٹ کال میں item_list صرف انہی پوسٹس کو ہٹاتی ہے، اس کے بغیر کمنٹ ایونٹس تمام پوسٹس کے لیے رک جاتے ہیں۔

callback URL کو کیا کرنا ہوتا ہے؟

فوراً جواب دیں۔ TikTok HTTPS پر JSON POST کرتا ہے اور HTTP 200 کے سوا ہر چیز کو ناکام ڈیلیوری سمجھتا ہے، 72 گھنٹوں تک ایکسپونینشل بیک آف کے ساتھ ری ٹرائی کرتا ہے، اس کے بعد ایونٹ ختم کر دیتا ہے۔ ڈیلیوری کم از کم ایک بار ہوتی ہے، اس لیے وہی ایونٹ دو بار آ سکتا ہے اور پروسیسنگ آئیڈیم پوٹنٹ ہونی چاہیے۔ ہر درخواست میں تین ہیڈرز ہوتے ہیں جنہیں لاگ کرنا مفید ہے: tiktok-signature، webhook-schema-version اور x-tt-logid۔ باڈی میں client_key، event، create_time (سیکنڈز میں)، user_openid (جو اکاؤنٹ کا business_id ہے) اور content ہوتے ہیں، جو ایک سیریلائزڈ JSON اسٹرنگ ہے۔

Tiktok-Signature کی تصدیق کیسے کریں؟

ہیڈر t=<unix>,s=<hex> کو پہلے کاما اور پھر برابر کے نشان پر تقسیم کریں۔ t کی قدر، ایک ڈاٹ اور ریکویسٹ باڈی سے سائن شدہ پیغام بنائیں، اس کا ایپ سیکرٹ کی کلید سے HMAC-SHA256 نکالیں، اسے hex میں انکوڈ کریں اور s سے موازنہ کریں۔ پھر دیکھیں کہ t کتنا پرانا ہے: TikTok ری پلے روکنے کے لیے ڈیلیوری کا وقت سائن کرتا ہے، اور اس کا نمونہ 5 سیکنڈ تک کی تاخیر قبول کرتا ہے۔ خام باڈی کو جیسی موصول ہوئی ویسے ہی استعمال کرنا JSON کو مختلف طریقے سے دوبارہ سیریلائز کرنے سے بچاتا ہے۔

Verify a TikTok webhook in Python
import hashlib, hmac, time

def verify_tiktok(raw_body: bytes, header: str, app_secret: str, max_age: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, s = parts.get("t", ""), parts.get("s", "")
    if not t.isdigit():
        return False
    expected = hmac.new(app_secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_age

easyCoexistence کے ذریعے TikTok ایونٹس کیسے وصول کریں؟

اکاؤنٹ کے لیے ایک منزل دے کر۔ easyCoexistence اپنی ایپ کو COMMENT پر سبسکرائب رکھتا ہے، TikTok کا سگنیچر چیک کرتا ہے، فوراً TikTok کو جواب دیتا ہے، اور جڑے ہوئے اکاؤنٹ کا ہر comment.update اس کے لیے مقرر کردہ HTTPS اینڈ پوائنٹ پر POST کرتا ہے۔ Claude یا ChatGPT سے set_social_webhook_destination، account_id اور url لیتا ہے، یا رکنے کے لیے null، اور ایک سائننگ سیکرٹ واپس کرتا ہے جو صرف ایک بار دکھایا جاتا ہے؛ دوبارہ کال کرنے سے نیا جاری ہوتا ہے۔ اشاعت کے ایونٹس آگے نہیں بھیجے جاتے: اس کے بجائے get_tiktok_publish_status کسی پوسٹ کو فالو کرتا ہے۔

Set a destination through MCP
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }
=> {
  "url": "https://hooks.example.com/tiktok/",
  "signing_secret": "whsec_<SECRET>",
  "note": "Shown once: store it as a secret. ..."
}

Partner API کے ساتھ اسے کیسے سیٹ کریں؟

https://easycoexistence.com/api/v1 پر PUT /channels/{id}/webhook کے ذریعے، ec_live_ کلید کو بطور bearer ٹوکن، اور باڈی {"url": "https://..."} کے ساتھ۔ جواب میں webhook_url، signing_secret اور note ہوتے ہیں، اور {"url": null} فارورڈنگ روک دیتا ہے۔ URL کو عوامی ہوسٹ پر HTTPS استعمال کرنا ہوگا؛ نامعلوم چینل 404 not_found واپس کرتا ہے، ہٹایا گیا چینل 409 removed، اور معطل چینل 402 suspended۔

Set a destination with the Partner API
curl -X PUT "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/webhook" \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://hooks.example.com/tiktok/"}'

{ "webhook_url": "https://hooks.example.com/tiktok/", "signing_secret": "whsec_<SECRET>", "note": "..." }

دونوں ڈیلیوریز میں کیا فرق ہے؟

easyCoexistence کا فارورڈ کیا ہوا ایونٹ TikTok کی اپنی ڈیلیوری سے مختلف طریقے سے سائن اور ترتیب پاتا ہے، اس لیے جس ریسیور کو ایک کے لیے لکھا گیا ہو اسے دوسرے کے لیے تبدیلیاں درکار ہوں گی۔ فارورڈ شدہ پے لوڈ TikTok کے کمنٹ فیلڈز برقرار رکھتا ہے، content پارس ہو کر، اور اس کے IDs اسٹرنگ کے طور پر؛ جو بدلتا ہے وہ یہ ہے کہ ہر ڈیلیوری کیسے سائن، اسکوپ اور ری ٹرائی ہوتی ہے:

TikTok to your appeasyCoexistence to your endpoint
HeaderTiktok-Signature: t=<unix>,s=<hex>X-EC-Signature: t=<unix>,v1=<hex>
KeyThe developer app's secretThe account's signing secret, shown once
EventsVIDEO and COMMENT, per appcomment.update, per connected account
Bodyclient_key, event, create_time, user_openid, content as a stringplatform, account_id, external_id, entry with content parsed
RetriesUp to 72 hoursNone: one attempt, 8 seconds, no redirects

اسے کیسے سیٹ اپ کریں

  1. Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
  2. Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
  3. Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
  4. Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
  5. Handle repeatsKey each event on its content, such as comment_id with comment_action, or publish_id with the event name, before acting on it.

عام غلطیاں

  • ایونٹ کا جواب دینے سے پہلے پروسیس کرنا۔ TikTok فوری 200 کا تقاضا کرتا ہے اور جن ڈیلیوریز کا جواب نظر نہیں آتا انہیں دوبارہ بھیجتا ہے، اس لیے کام قطار میں ڈالیں اور پہلے جواب دیں۔
  • غلطی سے پہلی COMMENT سبسکرپشن پر item_list بھیجنا۔ اس کے بعد TikTok صرف فہرست شدہ پوسٹس کے کمنٹ ایونٹس رپورٹ کرتا ہے۔
  • رسائی ٹوکن سے تصدیق کرنا۔ TikTok ویب ہکس کو ایپ سیکرٹ سے سائن کرتا ہے، وہی جو /business/webhook/update/ لیتا ہے۔
  • دو ماحولوں کو ایک ہی ایپ کی طرف اشارہ کرنا۔ ہر ایونٹ کی قسم کے لیے ایپ پر ایک callback_url رہتا ہے، اور نئی /business/webhook/update/ کال اسے بدل دیتی ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

Claude یا ChatGPT سے set_social_webhook_destination، یا PUT /channels/{id}/webhook سے سیٹ کریں۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، اور پہلے 3 دن فری ٹرائل کے ساتھ۔

اکثر پوچھے جانے والے سوالات

کون سے ہیڈرز TikTok ویب ہک ڈیلیوری ساتھ لاتی ہے؟

tiktok-signature، webhook-schema-version، فی الحال v1.0، اور x-tt-logid، جو ڈیلیوری کی ID ہے۔ JSON باڈی میں client_key، event، create_time، user_openid اور content ہوتے ہیں۔

کیا TikTok ویڈیو شائع ہونے پر ویب ہک بھیجتا ہے؟

ہاں، event_type VIDEO کے ساتھ: TikTok فائل ڈاؤن لوڈ اور چیک کر لینے کے بعد post.publish.complete، اور پوسٹ عوامی ہونے پر post_id کے ساتھ post.publish.publicly_available بھیجتا ہے۔

TikTok ناکام ویب ہک کو کتنی بار ری ٹرائی کرتا ہے؟

72 گھنٹوں تک ایکسپونینشل بیک آف کے ساتھ، اس کے بعد ایونٹ ختم ہو جاتا ہے۔ ڈیلیوری کم از کم ایک بار ہوتی ہے، اس لیے ڈپلیکیٹس کی توقع رکھیں۔

کیا میں easyCoexistence کی TikTok ایپ پر اپنا کال بیک رجسٹر کر سکتا ہوں؟

نہیں۔ ایپ کی ویب ہک سیٹنگز easyCoexistence کے پاس رہتی ہیں۔ set_social_webhook_destination اکاؤنٹ کے کمنٹ ایونٹس اس کے بجائے آپ کو بھیجتا ہے۔

مزید پڑھیں

TikTok کمنٹ ویب ہک ایونٹسTikTok کا comment.update ویب ہک کمنٹس اور ریپلائیز کیسے بتاتا ہے، ہر ایونٹ میں کیا ہوتا ہے، اور وہ دستخط شدہ آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔TikTok API برائے کاروبار کے ایکسیس ٹوکن: 24 گھنٹے، ریفریش اور منسوخیTikTok API برائے کاروبار کے ٹوکن: auth_code کا تبادلہ، 24 گھنٹے کا ایکسیس ٹوکن، ایک سال کا ریفریش ٹوکن، تجدید اور منسوخی۔TikTok API for Business کے اسکوپس: ہر اجازت کیا کھولتی ہےTikTok Accounts API کے ساتھ کام کرنے والی اجازتیں، TikTok کے اپنے ناموں سے: ہر ایک کیا کھولتی ہے، فی فیلڈ ٹوکن اسکوپس، اور ٹوکن کیسے جانچیں۔API کے ذریعے TikTok پر ویڈیو کیسے پوسٹ کریںTikTok کی کاروباری API سے ویڈیو پوسٹ کریں: پبلش اینڈ پوائنٹ، اس کی JSON باڈی، واپس آنے والا share_id اور status کال، curl اور Python میں۔TikTok کمنٹس کے جوابات اور API کے ذریعے موڈریشنTikTok کی API for Business کمنٹس پڑھنے، ان کا جواب دینے، چھپانے اور ڈیلیٹ کرنے دیتی ہے، اور رول اور آٹومیشن نئے کمنٹس کا خود جواب دیتے ہیں۔TikTok API کے ذریعے پوسٹ کی پبلش اسٹیٹس کیسے چیک کریںAPI سے شائع ہونے والی TikTok پوسٹ کی اسٹیٹس دیکھیں: share_id، PROCESSING_DOWNLOAD، PUBLISH_COMPLETE، FAILED اور ناکامی کی وجہ۔

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

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

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

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