ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

События вебхука комментариев TikTok

TikTok API for Business отправляет вебхук comment.update в течение пяти минут после того, как комментарий или ответ к фото-публикации или публичному видео аккаунта создан, удалён, скрыт, переведён в режим «только для друзей» или открыт для всех. Каждое событие называет комментарий, публикацию, действие, идентификатор автора и текст и подписано заголовком Tiktok-Signature.

easyCoexistence передаёт каждое событие комментария TikTok для аккаунта на ваш HTTPS-эндпоинт по мере поступления, подписанным секретом этого аккаунта и без хранения копии.

5 min

Время, за которое comment.update срабатывает после создания, удаления или смены видимости комментария или ответа.

72 hours

Сколько раз TikTok повторяет доставку, на которую обратный вызов не ответил HTTP 200, с экспоненциальной задержкой между попытками.

comment.list

Право, которое аккаунт должен предоставить и поддерживать действующим, чтобы события comment.update отправлялись.

At least once

Обещание доставки TikTok: одно и то же событие может прийти более одного раза, поэтому обработка должна быть идемпотентной.

Что сообщает comment.update?

Изменения комментариев к фото-публикациям и публичным видео аккаунта, опубликованным через API или в приложении TikTok. comment_action показывает, что произошло:

  • insert: комментарий или ответ создан.
  • delete: он удалён.
  • set_to_hidden: он скрыт пользователем или модерацией.
  • set_to_friends_only: он переведён в режим «только для друзей».
  • set_to_public: он перешёл из скрытого или «только для друзей» в видимый всем.

Что несёт событие?

TikTok отправляет JSON с полями client_key, event, create_time, user_openid, который является ID аккаунта, и content, сериализованной JSON-строкой. Внутри content: comment_id и video_id, parent_comment_id для ответов, comment_type (comment или reply), comment_action, отметка времени, уникальный идентификатор автора unique_identifier и текст. ID тоже являются числами JSON, слишком большими для того, чтобы double хранил их точно, поэтому читайте их из исходной строки.

Как события доходят до вашего эндпоинта?

TikTok отправляет вебхуки в приложение разработчика, через один обратный URL для всего приложения. easyCoexistence получает их и передаёт каждое comment.update для подключённого аккаунта на HTTPS-эндпоинт, заданный вами для этого аккаунта, один раз, по мере поступления, подписанным секретом этого аккаунта. Задайте эндпоинт через set_social_webhook_destination из Claude или ChatGPT либо через Partner API, методом PUT /channels/:id/webhook. Секрет показывается один раз, а URL со значением null выключает пересылку.

Как выглядит переданное событие?

POST-запрос с платформой, account_id, который даёт list_social_accounts для подключения, external_id аккаунта, то есть open_id TikTok, и entry: название события, create_time и content. Поле content уже разобрано, а ID переведены в строки, чтобы ни один не округлился.

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>"
    }
  }
}

Как проверить переданное событие?

Каждая переданная доставка несёт заголовок X-EC-Signature вида t=<unix>,v1=<hex>, где v1 это HMAC-SHA256 от отметки времени, точки и исходного тела запроса, с ключом подписи аккаунта. Пересчитайте её по телу в том виде, в каком оно пришло, сравните два значения за постоянное время и отклоняйте отметку времени старше 5 минут.

Повторяется ли доставка?

Не со стороны easyCoexistence. Каждое событие передаётся один раз, в памяти, без копии для повтора; пересылка ждёт ответа 8 секунд и не следует перенаправлениям. Выше по цепочке TikTok повторяет свои доставки до 72 часов и обещает не меньше одной, поэтому одно и то же событие может прийти дважды: дедуплицируйте по comment_id вместе с comment_action.

Распространённые ошибки

  • Разбор ID как чисел. comment_id и video_id больше, чем double хранит точно; easyCoexistence передаёт их строками, поэтому храните их так же.
  • Вычисление подписи по разобранной копии тела. HMAC считается по исходному телу в том виде, в каком оно пришло, и повторная сериализация ломает совпадение.
  • Обработка повторного события дважды. TikTok доставляет как минимум один раз, поэтому проверяйте пару comment_id и comment_action перед действием.
  • Указание адреса, который перенаправляет. Пересылка не следует перенаправлениям, поэтому укажите конечный HTTPS URL.
Настройка с EasyCoexistence

Включите через set_social_webhook_destination из Claude или ChatGPT либо через Partner API. US$ 9 до US$ 0,75 за подключение в месяц; цена снижается по мере добавления подключений. Первые 3 дня бесплатно.

Часто задаваемые вопросы

Какие события вебхука TikTok пересылаются?

comment.update: комментарии и ответы к публикациям подключённого аккаунта, созданные, удалённые, скрытые, переведённые в режим «только для друзей» или открытые для всех.

Пересылаются ли и события публикации TikTok?

Нет. Пересылка несёт события комментариев; статус публикации поста проверяйте через get_tiktok_publish_status.

Как быстро приходит событие комментария TikTok?

TikTok отправляет comment.update в течение пяти минут после изменения, а easyCoexistence передаёт его сразу, как только оно поступает.

Включает ли событие комментария TikTok текст?

TikTok описывает поле text в content события, рядом с ID комментария и публикации, действием и уникальным идентификатором автора unique_identifier.

Читайте дальше

Ответы на комментарии TikTok и модерация через APIКак API TikTok для бизнеса читает и скрывает комментарии, отвечает на них и удаляет свои, а правила по ключевым словам отвечают на новые сами.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.API аналитики TikTok: показатели аккаунта и видеоМетрики TikTok из API for Business: подписчики, просмотры и лайки по дням для аккаунта, просмотры, лайки, комментарии и репосты по видео.Ошибка TikTok 40001: нет разрешения на операциюОшибка TikTok 40001 означает, что у вызывающего приложения нет разрешения на операцию. Как проверить разрешение TikTok Accounts у приложения и scope токена.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на