TikTok Business Messaging API или QR-авторизованный inbox: как выбрать путь для DM

Если команде нужно получать TikTok DM в своем backend, сначала решите, вокруг какой учетной записи строится интеграция. Официальный TikTok Business Messaging API подходит, когда вы работаете с TikTok Business Account и вам нужны платформенные business messaging возможности. QR-авторизованный inbox через UnifyPort подходит в другой ситуации: существующий TikTok аккаунт уже получает сообщения клиентов, а команда хочет отправлять входящие события в тот же подписанный webhook, что и WhatsApp, LINE, Zalo, Telegram или X.

Главное

• Официальная документация TikTok API for Business перечисляет возможности Business Messaging API: conversations, messages, media, webhook configuration и automatic-message management.
• Этот путь нужно оценивать как интеграцию TikTok Business Account, а не как универсальный слой для мультиплатформенного inbox.
• В UnifyPort TikTok использует стандартный flow qrcode; первый ответ QR start может не содержать QR URL, поэтому polling QR check является частью нормального сценария.
• Для общей очереди поддержки сначала нормализуйте прием на message.received, а уже затем подключайте CRM, AI triage, labels или ручную маршрутизацию.

Для чего подходит TikTok Business Messaging API

Официальная документация TikTok API for Business описывает Business Messaging API как способ интегрировать direct messaging capabilities, отправлять и получать сообщения в реальном времени, настраивать automated replies и управлять message threads. В навигации той же документации перечислены операции direct messages: send a message to a conversation, get conversations, get messages, upload image, download image or video from a message, check Business Account capability и create Business Messaging webhook configuration.

Это официальный путь TikTok. Если продукт строится вокруг TikTok Business Account, рекламных диалогов, platform-native automatic messages или официальных business messaging функций, начните с него. Перед планированием запуска проверьте в документации TikTok разделы access, authorization, data security review, regional review, limits и return codes.

Для чего подходит QR-авторизованный inbox

QR-авторизованный inbox отвечает на другой вопрос: «Можно ли подключить TikTok inbox, которым уже пользуются операторы, к нашему webhook?» В UnifyPort TikTok использует ту же модель account и authentication, что и другие QR-каналы:

1. Создайте account с provider: "tiktok" и auth_mode: "qrcode".
2. Запустите QR authentication через POST /v1/accounts/{account_id}/auth/qr/start.
3. Выполняйте polling POST /v1/accounts/{account_id}/auth/qr/check или GET /v1/accounts/{account_id}/auth, пока не появится QR material, success или failure.
4. Сначала сохраняйте подписанные webhook deliveries, например message.received, и только потом маршрутизируйте их дальше.

Важная деталь для TikTok: первоначальный QR start response может не содержать QR URL. UI должен воспринимать polling как нормальное состояние, а не как ошибку. Практический сценарий описан в статье Connect a TikTok Account to a Signed Webhook With QR Authorization.

Таблица выбора: официальный Business Messaging API vs QR-авторизованный inbox

Вопрос	TikTok Business Messaging API	QR-авторизованный inbox через UnifyPort
Основная идентичность	TikTok Business Account	Уже подключенный TikTok аккаунт
Лучший сценарий	TikTok-only business messaging, рекламные диалоги, официальные business функции	Inbound support queue для TikTok и других messaging channels
Фокус интеграции	app access, authorization, review, limits, return codes	account creation, QR authorization, webhook storage, signature verification
Модель событий	Собственная TikTok API/webhook модель	Нормализованный поток message.received
Расширение на другие каналы	Для WhatsApp, LINE, Zalo и других нужны отдельные adapters	Тот же handler может принимать WhatsApp, Telegram, LINE, Zalo и X
Когда выбирать	Нужны официальные TikTok business возможности и выполнены требования аккаунта/программы	Поддержка начинается с существующего inbox, а задача — надежно принимать и распределять сообщения

Если вы строите поддержку для TikTok Shop, отдельно посмотрите TikTok Shop Customer Service API production checklist. Business Messaging API, Shop Customer Service API и QR-авторизованный inbox связаны, но это разные integration surfaces.

Где здесь UnifyPort

Когда нужны platform-native business функции TikTok, UnifyPort не заменяет официальный Business Messaging API. Его роль — unofficial interface для входящих и операционных сообщений, когда команде нужен единый event contract для нескольких каналов.

Типичный receiver сначала сохраняет событие:

{
  "id": "evt_2f9c1a4b7e",
  "type": "message.received",
  "provider": "tiktok",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:34:56Z",
  "data": {
    "conversation": { "id": "user_778899", "type": "user" },
    "sender": { "id": "user_778899", "type": "user", "name": "Jordan Lee" },
    "message": {
      "id": "msg_3003",
      "text": "Hi, is this item still available?",
      "direction": "inbound",
      "sent_at": "2026-06-08T12:34:55Z"
    },
    "event": { "kind": "message_received" }
  }
}

Затем маршрутизирует по provider, account_id и data.conversation.id. Receiver должен проверить X-Device-Signature с помощью signing_secret endpoint до выполнения бизнес-логики. Подпись — это HMAC-SHA256 от X-Device-Timestamp + "." + raw request body. Точные headers и примеры для Node.js/Python описаны в webhook delivery and signature verification.

Ограничения и компромиссы

Выбирайте официальный путь TikTok, если продукт зависит от TikTok Business Account features, campaign attribution, официальных program guarantees или platform-managed automatic messaging. Выбирайте QR-авторизованный inbox, если ближайшая задача — принимать, сохранять и маршрутизировать реальные сообщения из inbox в support queue или AI workflow.

QR-путь также требует аккуратной эксплуатации: сохраняйте каждое inbound event, считайте QR и session material чувствительными данными, проектируйте re-authentication flow и держите TikTok-specific правила за нормализованным intake layer.

FAQ

TikTok Business Messaging API — это TikTok DM API?

Это официальный API surface для business messaging в TikTok Business Account. Оценивайте его как business-account integration и проверяйте access, limits и review requirements в документации TikTok.

Когда использовать UnifyPort?

Когда существующий TikTok inbox уже является частью поддержки, а вам нужно получать сообщения как подписанные message.received events вместе с WhatsApp, LINE, Zalo, Telegram или X.

Всегда ли UnifyPort TikTok QR start возвращает QR URL?

Нет. В UnifyPort provider guide указано, что initial TikTok QR start response может не содержать QR URL. Продолжайте polling QR check, пока не появится QR material, success или failure.

Какие документы открыть дальше?

Начните с TikTok authorization provider guide, затем откройте Check QR authentication и Webhook delivery.

Источники проверены 2026-09-07

• TikTok API for Business documentation: https://business-api.tiktok.com/portal/docs?id=1735712062490625
• TikTok Business Messaging API education hub: https://business-api.tiktok.com/portal/bm-api/education-hub
• Документация UnifyPort provider и webhook, ссылки на которую приведены выше.