API経由のTikTok

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

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

前提条件 [#prerequisites]

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

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

API アクセスを設定する [#set-up-api-access]

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

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

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

イベント サブスクリプションを構成する [#configure-event-subscriptions]

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

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

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

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

3. 通知プロファイルの作成手順で、パブリックHTTPSエンドポイントURLを入力します。

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

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

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

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

もっと詳しく知る

API essentials ページと サブスクリプション ページにアクセスして、主要な概念とセットアップ手順を確認してください。