События вебхука комментариев TikTok
TikTok API for Business отправляет вебхук comment.update в течение пяти минут после того, как комментарий или ответ к фото-публикации или публичному видео аккаунта создан, удалён, скрыт, переведён в режим «только для друзей» или открыт для всех. Каждое событие называет комментарий, публикацию, действие, идентификатор автора и текст и подписано заголовком Tiktok-Signature.
easyCoexistence передаёт каждое событие комментария TikTok для аккаунта на ваш HTTPS-эндпоинт по мере поступления, подписанным секретом этого аккаунта и без хранения копии.
Время, за которое comment.update срабатывает после создания, удаления или смены видимости комментария или ответа.
Сколько раз TikTok повторяет доставку, на которую обратный вызов не ответил HTTP 200, с экспоненциальной задержкой между попытками.
Право, которое аккаунт должен предоставить и поддерживать действующим, чтобы события comment.update отправлялись.
Обещание доставки 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 переведены в строки, чтобы ни один не округлился.
{
"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.
Включите через 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.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на