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 اینڈ پوائنٹ تک پہنچاتا ہے، جو اس کے اپنے سیکرٹ سے سائن ہوتا ہے۔
TikTok کتنی دیر تک HTTP 200 کا جواب نہ ملنے پر ڈیلیوری دوبارہ بھیجتا ہے، ایکسپونینشل بیک آف کے ساتھ، اس سے پہلے کہ اسے ختم کر دے۔
ایک item_list میں دی جا سکنے والی پوسٹ IDs کی زیادہ سے زیادہ تعداد، جن سے comment.update ایونٹس کو مخصوص پوسٹس تک محدود کیا جا سکتا ہے۔
وہ موجودہ قدر جو TikTok ہر ڈیلیوری کے ساتھ webhook-schema-version ہیڈر میں بھیجتا ہے۔
TikTok کے ریفرنس میں ویب ہک کنفیگریشن اینڈ پوائنٹس کی فہرست، جو app ID اور سیکرٹ سے تصدیق کرتے ہیں۔
Tiktok-Signature کا الگورتھم: ٹائم اسٹیمپ، ایک ڈاٹ اور باڈی، جنہیں ایپ سیکرٹ کی کلید کے ساتھ hex میں انکوڈ کیا جاتا ہے۔
comment.update کے لیے TikTok Accounts کے تحت درکار ایپ اجازت؛ اشاعت کے ایونٹس کو Business Content درکار ہے۔
کون سے ویب ہک ایونٹس ایک TikTok اکاؤنٹ ایپ وصول کر سکتی ہے؟
دو زمرے، ہر ایک الگ event_type کے طور پر سبسکرائب ہوتا ہے۔ VIDEO ان پوسٹس کو کور کرتا ہے جو /business/video/publish/ یا /business/photo/publish/ کے ذریعے شائع ہوں، اور COMMENT اکاؤنٹ کی فوٹو پوسٹس اور عوامی ویڈیو پوسٹس پر کمنٹس کو کور کرتا ہے، چاہے وہ API سے شائع ہوئے ہوں یا TikTok ایپ میں:
سبسکرائب کرنے سے پہلے ایپ کو کیا چاہیے؟
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 بدل جاتا ہے۔
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 کو مختلف طریقے سے دوبارہ سیریلائز کرنے سے بچاتا ہے۔
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_ageeasyCoexistence کے ذریعے TikTok ایونٹس کیسے وصول کریں؟
اکاؤنٹ کے لیے ایک منزل دے کر۔ easyCoexistence اپنی ایپ کو COMMENT پر سبسکرائب رکھتا ہے، TikTok کا سگنیچر چیک کرتا ہے، فوراً TikTok کو جواب دیتا ہے، اور جڑے ہوئے اکاؤنٹ کا ہر comment.update اس کے لیے مقرر کردہ HTTPS اینڈ پوائنٹ پر POST کرتا ہے۔ Claude یا ChatGPT سے set_social_webhook_destination، account_id اور url لیتا ہے، یا رکنے کے لیے null، اور ایک سائننگ سیکرٹ واپس کرتا ہے جو صرف ایک بار دکھایا جاتا ہے؛ دوبارہ کال کرنے سے نیا جاری ہوتا ہے۔ اشاعت کے ایونٹس آگے نہیں بھیجے جاتے: اس کے بجائے get_tiktok_publish_status کسی پوسٹ کو فالو کرتا ہے۔
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۔
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 app | easyCoexistence to your endpoint | |
|---|---|---|
| Header | Tiktok-Signature: t=<unix>,s=<hex> | X-EC-Signature: t=<unix>,v1=<hex> |
| Key | The developer app's secret | The account's signing secret, shown once |
| Events | VIDEO and COMMENT, per app | comment.update, per connected account |
| Body | client_key, event, create_time, user_openid, content as a string | platform, account_id, external_id, entry with content parsed |
| Retries | Up to 72 hours | None: one attempt, 8 seconds, no redirects |
اسے کیسے سیٹ اپ کریں
- Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
- Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
- Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
- Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
- 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/ کال اسے بدل دیتی ہے۔
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 اکاؤنٹ کے کمنٹ ایونٹس اس کے بجائے آپ کو بھیجتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ