比較 September 7, 2026

TikTok Business Messaging API と QR 認証インボックス：DM 連携はどちらを選ぶべきか

TikTok の DM を自社バックエンドで受けたい場合、最初に決めるべきなのは「どのアカウントの身元を中心に設計するか」です。TikTok の公式 Business Messaging API は、TikTok Business Account を運用し、プラットフォームのビジネスメッセージ機能を使うチームに向いています。一方、UnifyPort の QR 認証インボックスは、すでに使っている TikTok アカウントの受信箱を、LINE、WhatsApp、Zalo、Telegram、X と同じ署名付き webhook に流したいチームに向いています。日本では LINE 連携も同じキューに入れられるかが重要です。

要点

TikTok の公式 API for Business ドキュメントには、Business Messaging API の direct message、conversation、message、media、webhook configuration、automatic message などの機能が記載されています。
公式ルートは TikTok Business Account の統合として評価すべきで、汎用的なマルチチャネル受信基盤とは役割が異なります。
UnifyPort の TikTok 連携は標準の qrcode 認証フローを使います。最初の QR start レスポンスに QR URL が含まれないことがあるため、QR check のポーリングを前提にします。
LINE、TikTok、WhatsApp を同じサポートキューに入れるなら、まず message.received を保存し、その後で CRM、AI 分類、担当者ルーティングを行います。

TikTok Business Messaging API が向くケース

TikTok の公式 API for Business ドキュメントは、Business Messaging API を direct messaging capabilities の統合、リアルタイムの送受信、自動返信、message thread 管理のための API と説明しています。同じ公式ドキュメントのナビゲーションには、send a message to a conversation、get conversations、get messages、upload image、download image or video from a message、Business Account capability の確認、Business Messaging webhook configuration の作成などが並んでいます。

これは TikTok 公式の道筋です。プロダクトが TikTok Business Account、広告起点の会話、プラットフォーム標準の自動メッセージ、公式 business messaging 機能に依存するなら、まずこのルートを評価してください。実装前には TikTok の公式ドキュメントで access、authorization、data security review、regional review、limits、return codes を確認し、審査や運用の前提を計画に入れる必要があります。

QR 認証インボックスが向くケース

QR 認証インボックスは、別の問いに答えます。「運用担当者がすでに使っている TikTok の受信箱を、自社の webhook に接続できるか？」という問いです。UnifyPort では、TikTok は他の QR 型チャネルと同じアカウント・認証モデルを使います。

provider: "tiktok"、auth_mode: "qrcode" で account を作成する。
POST /v1/accounts/{account_id}/auth/qr/start で QR 認証を開始する。
POST /v1/accounts/{account_id}/auth/qr/check または GET /v1/accounts/{account_id}/auth をポーリングし、QR 情報、成功、失敗のいずれかを待つ。
message.received などの署名付き webhook delivery を保存してから、下流のワークフローに流す。

TikTok で特に重要なのは、最初の QR start レスポンスに QR URL がない場合がある点です。管理画面はそれをエラー扱いせず、通常のポーリング状態として扱うべきです。具体的な流れは TikTok アカウントを署名付き webhook に接続するガイドも参照してください。

比較表：公式 Business Messaging API vs QR 認証インボックス

判断軸	TikTok Business Messaging API	UnifyPort の QR 認証インボックス
主なアカウント身元	TikTok Business Account	接続済みの既存 TikTok アカウント
向いている用途	TikTok 単体のビジネスメッセージ、広告連動の会話、公式 business 機能	TikTok、LINE、WhatsApp などをまとめる inbound サポートキュー
実装の焦点	app access、authorization、review、limits、return codes	account 作成、QR 認証、webhook 保存、署名検証
イベントモデル	TikTok 固有の API / webhook モデル	標準化された `message.received` イベントストリーム
他チャネル展開	LINE などは別 adapter が必要	同じ handler で LINE、WhatsApp、Telegram、Zalo、X も受信可能
選ぶべき場面	TikTok 公式の business 機能が必要で、アカウント・プログラム要件を満たせる	既存の受信箱から始まるサポート業務を、安定して受信・振り分けたい

TikTok Shop のカスタマーサポートを実装している場合は、TikTok Shop Customer Service API の本番チェックリストも確認してください。Business Messaging API、Shop Customer Service API、QR 認証インボックスは関連しますが、同じ統合面ではありません。

UnifyPort の位置づけ

TikTok のプラットフォーム標準 business 機能が必要な場合、UnifyPort は公式 Business Messaging API の代替ではありません。UnifyPort は unofficial interface として、入站メッセージと運用メッセージを複数チャネルで同じイベント契約にそろえるためのレイヤーです。

受信側は、まずイベントを保存します。

{
  "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 でルーティングします。受信側はビジネスロジックを実行する前に、endpoint の signing_secret で X-Device-Signature を検証してください。署名対象は X-Device-Timestamp + "." + raw request body の HMAC-SHA256 です。ヘッダーと Node.js/Python の例は webhook delivery and signature verification にあります。

制限とトレードオフ

TikTok Business Account 機能、広告アトリビューション、公式プログラムの保証、プラットフォーム管理の自動メッセージが必要なら、公式 TikTok ルートを選んでください。いま必要なのが、実際の受信箱メッセージを安定して受け、LINE や WhatsApp と同じサポートキューへ流すことなら、QR 認証インボックスのほうが目的に合います。

QR ルートでも安全な運用は必要です。すべての inbound event を保存し、QR や session material を機密情報として扱い、再認証の導線を用意し、TikTok 固有の処理は標準化された受信層の後ろに置きます。

FAQ

TikTok Business Messaging API は TikTok DM API と同じですか？

Business Account 向けの公式 business messaging API surface です。一般的な受信箱連携ではなく、business-account integration として access、limits、review 要件を TikTok 公式ドキュメントで確認してください。

UnifyPort はいつ使うべきですか？

既存の TikTok 受信箱がサポート業務の一部であり、LINE、WhatsApp、Zalo、Telegram、X と同じ署名付き message.received イベントとして受けたい場合に適しています。

UnifyPort の TikTok QR start は必ず QR URL を返しますか？

いいえ。UnifyPort の provider guide では、TikTok の初回 QR start response に QR URL がない場合があると説明されています。QR check をポーリングし、QR 情報、成功、失敗を待ちます。

次に読むべきドキュメントは？

まず 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 ドキュメント。

UnifyPort API

メッセージ連携を安定したプロダクトパイプラインへ。

まずは 1 つの API で送信を始め、標準イベントですべての inbound メッセージを業務システムへ戻しましょう。

API Key を取得 API リファレンスを見る