API経由のTikTok

このページでは、NTT CPaaSでTikTok Business MessagingのAPIアクセスを設定する方法について説明します。始める前に、TikTokの一般的な設定が完了していることを確認してください。

APIを介してTikTokメッセージを送受信するには、APIキーと構成されたWebhookエンドポイントが必要です。

---

前提条件

API アクセスを設定する前に、次のものがあることを確認してください。

• 接続されたTikTokビジネスアカウント
• Webhook 要求を受信できる HTTPS エンドポイント
  • HTTPS 経由でパブリックにアクセスできる必要があります
  • 受信を確認するには、HTTP 200 で応答できる必要があります
  • 構成された通知プロファイル設定を使用して secured にする必要があります

---

API アクセスを設定する

TikTokメッセージをプログラムで送信するには、必要な権限を持つAPIキーが必要です。

1. NTT CPaaS Webインターフェイス (opens in a new tab)で、開発者ツール > APIキーに移動します。
2. APIキーの作成を選択します。
3. 名前を追加し、次の API スコープを選択します。
   • 「tiktok:管理」
   • saas:tiktok-ads:管理
4. 作成を選択して、APIキーを生成します。

API リクエスト (opens in a new tab)を送信するときに権限付与ヘッダーで使用するため、安全にコピーして保存してください。

---

イベント サブスクリプションを構成する

インバウンド メッセージ、配信レポート、表示レポートを受信するには、イベント サブスクリプション を作成する必要があります。

1. NTT CPaaSの Webインターフェース (opens in a new tab)で、開発者ツール>サブスクリプションに移動します。

2. サブスクリプションの作成を選択し、次のイベントを選択します。

   • 配信
   • 受信メッセージ
   • 見て

3. notification profile の作成手順で、パブリック HTTPS エンドポイント URL を入力します。

   • HTTPS エンドポイント要件 に留意してください。
   手記

   使用可能な場合は、Webhook 署名/ハッシュの検証に使用する 秘密鍵 を入力します。

   通知プロファイルの作成時に、セキュリティ設定 で HMAC 認証を構成し、秘密鍵を追加します。

4. TikTokイベントのサブスクリプションを保存します。

---

---