Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok yorum webhook olayları

TikTok'un API for Business'ı, bir hesabın fotoğraf gönderilerinde ve herkese açık videolarında bir yorum veya yanıt oluşturulduğunda, silindiğinde, gizlendiğinde, yalnızca arkadaşlara ayarlandığında ya da herkese açık yapıldığında beş dakika içinde comment.update webhook'u gönderir. Her olay yorumu, gönderiyi, eylemi, yorum yazanın tanımlayıcısını ve metni belirtir ve Tiktok-Signature başlığıyla imzalanır.

easyCoexistence, hesap için gelen her TikTok yorum olayını, hesaba özel bir gizli anahtarla imzalanmış ve hiçbir kopya tutulmadan, geldiği anda HTTPS uç noktanıza iletir.

5 min

comment.update'in, bir yorum veya yanıt oluşturulduktan, silindikten ya da görünürlüğü değiştikten sonra tetiklendiği süre.

72 hours

TikTok'un, geri çağırma adresi HTTP 200 ile yanıt vermediğinde bir teslimatı üssel geri çekilmeyle ne kadar süre yeniden denediği.

comment.list

Hesabın, comment.update olaylarının gönderilebilmesi için vermiş olması ve geçerli tutması gereken kapsam.

At least once

TikTok'un teslimat sözü: aynı olay birden fazla gelebilir, bu yüzden işleme idempotent olmalıdır.

comment.update neyi bildirir?

Hesabın fotoğraf gönderilerindeki ve herkese açık video gönderilerindeki yorumlarda yapılan değişiklikleri bildirir; bunlar API üzerinden ya da TikTok uygulamasında yayımlanmış olabilir. comment_action neyin olduğunu söyler:

  • insert: bir yorum veya yanıt oluşturuldu.
  • delete: silindi.
  • set_to_hidden: bir kullanıcı tarafından ya da moderasyon yoluyla gizlendi.
  • set_to_friends_only: yalnızca arkadaşlara görünür olacak şekilde ayarlandı.
  • set_to_public: gizli ya da yalnızca arkadaşlara açık durumdan herkese görünür hale geçti.

Bir olay neleri taşır?

TikTok JSON olarak client_key, event, create_time, hesabın kimliği olan user_openid ve serileştirilmiş bir JSON dizgisi olan content gönderir. content alanının içinde comment_id ve video_id, yanıtlar için parent_comment_id, comment_type (comment veya reply), comment_action, bir zaman damgası, yorum yazanın unique_identifier alanı ve metin bulunur. Kimlikler de double'ın tam olarak tutamayacağı kadar büyük JSON sayılarıdır, bu yüzden onları ham dizgeden okuyun.

Olaylar uç noktanıza nasıl ulaşır?

TikTok webhook'ları, tüm uygulama için tek bir geri çağırma URL'si üzerinden geliştirici uygulamasına gönderir. easyCoexistence bunları alır ve bağlı bir hesap için gelen her comment.update olayını, o hesabın kendi gizli anahtarıyla imzalanmış olarak, belirlediğiniz HTTPS uç noktasına bir kez, geldiği anda iletir. Uç noktayı Claude ya da ChatGPT'den set_social_webhook_destination ile ya da Partner API üzerinden PUT /channels/:id/webhook ile ayarlayın; gizli anahtar yalnızca bir kez gösterilir ve boş bir URL iletmeyi kapatır.

İletilen bir olay nasıl görünür?

Platformu, bağlantının account_id alanını (list_social_accounts bu değeri verir), hesabın external_id alanını (TikTok'un open_id değeri) ve entry alanını içeren bir POST isteğidir. entry alanı; olayın adını, create_time alanını ve content alanını içerir. content alanı zaten ayrıştırılmış durumdadır ve kimlikler, hiçbiri yuvarlanmasın diye dizgelere dönüştürülmüştür.

A forwarded comment.update event
{
  "platform": "tiktok",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<TIKTOK_OPEN_ID>",
  "entry": {
    "event": "comment.update",
    "create_time": 1793318400,
    "content": {
      "comment_id": "<COMMENT_ID>",
      "video_id": "<VIDEO_ID>",
      "parent_comment_id": null,
      "comment_type": "comment",
      "comment_action": "insert",
      "timestamp": 1793318399000,
      "unique_identifier": "<UNIQUE_IDENTIFIER>",
      "text": "<COMMENT_TEXT>"
    }
  }
}

İletilen bir olayı nasıl doğrularsınız?

İletilen her teslimat, t=<unix>,v1=<hex> biçiminde bir X-EC-Signature başlığı taşır; burada v1, zaman damgasının, bir noktanın ve ham gövdenin HMAC-SHA256'sıdır ve hesabın imzalama gizli anahtarıyla oluşturulur. Gövdeyi geldiği gibi, olduğu haliyle yeniden hesaplayın, ikisini sabit zamanlı bir karşılaştırmayla kıyaslayın ve 5 dakikadan eski bir zaman damgasını reddedin.

Bir teslimat yeniden denenir mi?

easyCoexistence yeniden denemez. Her olay bellekte, yeniden denemek için bir kopya tutulmadan bir kez iletilir; iletme 8 saniye yanıt bekler ve yönlendirmeleri izlemez. Yukarı akışta TikTok, kendi teslimatlarını 72 saate kadar yeniden dener ve en az bir teslimat vaat eder; bu yüzden aynı olay size iki kez ulaşabilir. comment_id ile comment_action alanını birlikte kullanarak tekilleştirin.

Yaygın hatalar

  • Kimlikleri sayı olarak ayrıştırmak. comment_id ve video_id, double'ın tam olarak tutabileceğinden daha büyüktür; easyCoexistence bunları dizge olarak iletir, bu yüzden dizge olarak bırakın.
  • İmzayı gövdenin ayrıştırılmış bir kopyası üzerinden hesaplamak. HMAC, teslim edildiği haliyle ham gövdeyi kapsar; yeniden serileştirmek eşleşmeyi bozar.
  • Tekrarlanan bir olayı iki kez işlemek. TikTok en az bir kez teslim eder; harekete geçmeden önce comment_id ve comment_action alanlarına göre anahtarlayın.
  • Hedefi bir yönlendirme yapan bir adrese yöneltmek. İletme yönlendirmeleri izlemez, bu yüzden son HTTPS URL'sini verin.
Bunu EasyCoexistence'la yapmak

Claude ya da ChatGPT'den set_social_webhook_destination ile ya da Partner API ile açın. Bağlantı başına aylık US$ 9 ile US$ 0.75 arası; bağlantı eklendikçe düşer, ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Hangi TikTok webhook olayları iletilir?

comment.update: bağlı hesabın gönderilerindeki yorum ve yanıtlar için; oluşturulan, silinen, gizlenen, yalnızca arkadaşlara ayarlanan ya da herkese açık yapılan.

TikTok yayımlama olayları da iletilir mi?

Hayır. İletme yorum olaylarını taşır; bir gönderinin yayımlanmasını bunun yerine get_tiktok_publish_status ile takip edin.

Bir TikTok yorum olayı ne kadar hızlı ulaşır?

TikTok, değişiklikten sonra beş dakika içinde comment.update gönderir ve easyCoexistence, geldiği anda iletir.

Bir TikTok yorum olayı metni de içerir mi?

TikTok, olayın content alanında yorum ve gönderi kimlikleri, eylem ve yorum yazanın unique_identifier alanının yanında bir text alanını belgeler.

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