TikTok API for Business webhook'larını ayarlama
TikTok'un API for Business hizmeti, her geliştirici uygulaması ve olay türü için tek bir callback URL'ye webhook gönderir; bu, uygulamanın app_id ve secret değerleriyle POST /business/webhook/update/ çağrısıyla ayarlanır. event_type VIDEO, dört gönderi yayınlama olayına; COMMENT ise comment.update olayına abone olur. Her teslimat, Tiktok-Signature başlığında imzalanmış bir HTTPS POST isteğidir; imza, uygulama secret'iyle anahtarlanmış bir HMAC-SHA256 değeridir.
easyCoexistence, TikTok'un yorum webhook'unu kendi uygulaması için abone tutar, TikTok'un imzasını doğrular ve hesabınız için her yorum olayını, kendi secret'ıyla imzalanmış olarak HTTPS uç noktanıza iletir.
TikTok'un HTTP 200 ile yanıtlanmayan bir teslimatı, üstel geri çekilmeyle ne kadar süre yeniden deneyip sonra sildiği.
item_list alanının, comment.update olaylarını belirli gönderilerle sınırlamak için adlandırabileceği en fazla gönderi kimliği sayısı.
TikTok'un her teslimatla gönderdiği webhook-schema-version başlığının güncel değeri.
TikTok referansının, uygulama kimliği ve secret ile kimlik doğrulayan webhook yapılandırma uç noktaları için listelediği bilgiler.
Tiktok-Signature başlığının arkasındaki algoritma: zaman damgası, bir nokta ve gövde; uygulama secret'iyle anahtarlanmış ve onaltılık (hex) kodlanmış.
TikTok Accounts altında comment.update için gereken uygulama izni; yayınlama olayları Business Content gerektirir.
Bir TikTok hesabı uygulaması hangi webhook olaylarını alabilir?
İki kategori var ve her biri kendi event_type değeriyle abone edilir. VIDEO, /business/video/publish/ veya /business/photo/publish/ üzerinden yayınlanan gönderileri kapsar; COMMENT ise hesabın fotoğraf gönderilerindeki ve herkese açık video gönderilerindeki yorumları kapsar. Bu yorumlar API ile ya da TikTok uygulamasından yayınlanmış olabilir:
Abone olmadan önce uygulamanın neye ihtiyacı var?
API for Business erişimi, bir geliştirici uygulaması ve bunu yetkilendirmiş TikTok hesapları. TikTok'un abonelik kılavuzu her kategori için bir izin ekliyor; yorum olayı ise her hesap sahibinden bir kapsam gerektiriyor:
- Yayınlama olayları: uygulamada TikTok Accounts, Business Content izni.
- Yorum olayları: uygulamada TikTok Accounts, Business Comment izni.
- comment.update: hesap sahibi tarafından verilen ve geçerli tutulan comment.list kapsamı.
- HTTPS üzerinden erişilebilen ve HTTP 200 ile hemen yanıt veren bir callback URL'si.
Nasıl abone olursunuz?
Her event_type için bir kez /business/webhook/update/ adresine POST isteği göndererek. İstek gövdesi app_id ve secret, event_type (VIDEO ya da COMMENT) ve callback_url alır; COMMENT için item_list de alabilir. Yanıt app_id, event_type, callback_url ve yapılandırılmışsa item_list değerlerini yansıtır. Aynı event_type için yeniden çağırmak callback URL'sini değiştirir.
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 yorum olaylarını nasıl daraltır?
Bu alan comment.update olaylarını adlandırdığı gönderilerle sınırlar; /business/video/list/ adresinden en fazla 100 kimlik alabilir. İlk liste, uygulama için o andan itibaren modu belirler:
item_listile ilk COMMENT çağrısı: olaylar yalnızca listelenen gönderiler için gelir.item_listile sonraki çağrılar: yeni gönderiler, zaten listelenenlere eklenir.item_listolmadan COMMENT çağrısı, önceden hiçbiri ayarlanmamışsa: olaylar, uygulamayı yetkilendirmiş hesapların gönderileri için gelir.item_listolmadan COMMENT çağrısı, bir liste zaten varsa: yapılandırılmış gönderiler olduğu gibi kalır.
Bir aboneliği nasıl kontrol eder ya da kaldırırsınız?
app_id, secret ve event_type ile GET /business/webhook/list/ isteği yapılandırmayı döndürür: callback_url yalnızca o olay türü için bir tane varsa, item_list ise yalnızca ayarlanmışsa görünür. app_id, secret ve event_type ile POST /business/webhook/delete/ isteği aboneliği kaldırır. COMMENT için silme çağrısında bir item_list varsa yalnızca o gönderiler kaldırılır; yoksa yorum olayları tüm gönderiler için durur.
Callback URL ne yapmalı?
Hemen yanıt vermeli. TikTok, JSON'u HTTPS üzerinden POST eder ve HTTP 200 dışındaki her yanıtı başarısız teslimat sayar; olayı atmadan önce üstel geri çekilmeyle 72 saate kadar yeniden dener. Teslimat en az bir kez yapılır, bu nedenle aynı olay iki kez gelebilir ve işleme aynı sonucu verecek biçimde yapılmalıdır. Her istek günlüğe kaydetmeye değer üç başlık taşır: tiktok-signature, webhook-schema-version ve x-tt-logid. Gövde ise client_key, event, saniye cinsinden create_time, hesabın business_id değeri olan user_openid ve serileştirilmiş bir JSON dizgisi olan content alanlarını içerir.
Tiktok-Signature nasıl doğrulanır?
Başlığı, t=<unix>,s=<hex> biçiminde, önce virgüllerden sonra eşittir işaretinden bölün. t değerinden, bir noktadan ve istek gövdesinden imzalanmış mesajı oluşturun; bunun HMAC-SHA256 değerini uygulama secret'iyle hesaplayın, onaltılık kodlayın ve s ile karşılaştırın. Ardından t değerinin ne kadar eski olduğunu kontrol edin: TikTok, tekrar oynatma saldırılarını engellemek için teslimat zamanını imzalar ve örnek kod 5 saniyelik gecikmeyi kabul eder. Gelen ham gövdeyle çalışmak, JSON'u farklı biçimde yeniden serileştirmenin önüne geçer.
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 üzerinden TikTok olaylarını nasıl alırsınız?
Hesaba bir hedef vererek. easyCoexistence kendi uygulamasını COMMENT için abone tutar, TikTok'un imzasını doğrular, TikTok'a hemen yanıt verir ve bağlı her hesap için comment.update olayını, o hesap için ayarlanmış HTTPS uç noktasına POST eder. Claude ya da ChatGPT'den set_social_webhook_destination, account_id ve url alır (durdurmak için null) ve yalnızca bir kez gösterilen bir imzalama secret'i döndürür; yeniden çağırmak yeni bir secret üretir. Yayınlama olayları iletilmez; bunun yerine get_tiktok_publish_status bir gönderiyi takip eder.
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 ile nasıl ayarlarsınız?
https://easycoexistence.com/api/v1 üzerinde PUT /channels/{id}/webhook ile; ec_live_ anahtarınızı bearer token olarak kullanarak ve gövdesi {"url": "https://..."} olan bir istekle. Yanıt webhook_url, signing_secret ve note alanlarını içerir; {"url": null} iletmeyi durdurur. URL, herkese açık bir sunucuda HTTPS kullanmalıdır. Bilinmeyen bir kanal 404 not_found, kaldırılmış bir kanal 409 removed ve askıya alınmış bir kanal 402 suspended döndürür.
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": "..." }İki teslimat nasıl farklılaşır?
easyCoexistence'tan yapılan bir iletim, TikTok'un kendi teslimatından farklı imzalanır ve biçimlendirilir; bu yüzden birinin için yazılmış bir alıcının diğeri için değişiklik gerekir. İletilen gövde, içeriği ayrıştırılmış ve kimlikleri dize olarak yazılmış TikTok yorum alanlarını korur. Değişen, her teslimatın nasıl imzalandığı, kapsamı ve yeniden denenmesidir:
| 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 |
Nasıl kurulur
- 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.
Yaygın hatalar
- Olayı yanıtlamadan işlemek. TikTok hemen bir 200 ister ve onaylanmadığını gördüğü teslimatları yeniden dener; bu yüzden işi kuyruğa alın ve önce yanıt verin.
- İlk COMMENT aboneliğinde yanlışlıkla item_list göndermek. Bundan sonra TikTok yorum olaylarını yalnızca listelenen gönderiler için bildirir.
- Erişim token'ı ile doğrulamak. TikTok webhook'ları uygulama secret'iyle imzalar; bu secret, /business/webhook/update/ çağrısında gönderdiğiniz secret'in aynısıdır.
- Aynı uygulamaya iki ortamı yönlendirmek. Her olay türü uygulama başına tek bir callback_url tutar ve yeni bir /business/webhook/update/ çağrısı onu değiştirir.
Claude ya da ChatGPT'den set_social_webhook_destination ile ya da PUT /channels/{id}/webhook ile ayarlayın. Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Bir TikTok webhook teslimatı hangi başlıkları taşır?
tiktok-signature, şu an v1.0 olan webhook-schema-version ve teslimatın kimliği olan x-tt-logid. JSON gövdesi client_key, event, create_time, user_openid ve content alanlarını içerir.
TikTok bir video yayınlandığında webhook gönderir mi?
Evet, event_type VIDEO ile: TikTok dosyayı indirip kontrol ettikten sonra post.publish.complete, gönderi herkese açık olduğunda ise post_id içeren post.publish.publicly_available gönderilir.
TikTok başarısız bir webhook'u ne kadar süre yeniden dener?
Üstel geri çekilmeyle 72 saate kadar; ardından olay atılır. Teslimat en az bir kez yapıldığı için yinelenen teslimatlara hazırlıklı olun.
easyCoexistence'ın TikTok uygulamasına kendi callback'inizi kaydedebilir misiniz?
Hayır. Uygulamanın webhook ayarları easyCoexistence'ta kalır. set_social_webhook_destination ise hesabın yorum olaylarını bunun yerine size gönderir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi