NTT CPaaSでTikTokメッセージを送受信

TikTokビジネスメッセージングの設定が完了した後、NTT CPaaSを使用してTikTokメッセージを送受信します。

TikTokメッセージングの仕組み

一般的なTikTokメッセージングフローは、次の手順で構成されています。

1. ユーザーがTikTokビジネスアカウントにメッセージを送信します。
2. NTT CPaaSは、受信メッセージをWebhookに配信します。
3. システムはメッセージを処理し、必要な識別子を格納します。
4. NTT CPaaS APIまたはConversationsを使用して返信を送信します。
5. NTT CPaaSは、Webhookを介してメッセージステータスイベントを配信します。

トラッキングオプションの詳細については、「TikTok配信と表示されたレポート」を参照してください。

TikTokメッセージを受信する

インバウンドTikTokメッセージは、Webhookを介してシステムに配信されます↗。

ユーザーがTikTokビジネスアカウントにメッセージを送信すると、次のようになります。

• NTT CPaaSは、設定済みのWebhookエンドポイント(/tiktok/api#configure-イベント-subscriptions)にインバウンドメッセージイベントを送信します。
• イベントには、返信に必要なメッセージコンテンツと識別子が含まれます

HTTP 200応答を返して、各受信メッセージを確認する必要があります。

Learn more

受信したTikTokメッセージを処理するためのロジックを設定する方法の詳細については、「 TikTok受信メッセージの受信 (opens in a new tab)」を参照してください。

サポートされている受信メッセージの種類

次のインバウンドメッセージタイプを受信できます。

• テキストメッセージ
• 画像メッセージ
• 投稿メッセージを共有する

会話がTikTokダイレクトメッセージ広告またはTikTok.me リンクから開始する場合、インバウンドメッセージには会話発信元に関する紹介情報を含めることもできます。

必須の識別子

ユーザーに返信するには、受信メッセージ イベントから次の値を格納します。

• TikTokユーザー識別子: メッセージを送信する人のユーザーID。
• TikTokビジネスアカウント識別子: ウェブインターフェース (opens in a new tab)のTikTokチャンネルセクションの送信者タブに表示されます。
• 会話 ID(conversationId)(指定されている場合): 会話 が ダイレクト メッセージ広告 または TikTok.me リンク から開始されたときに含まれます。

これらの識別子は、送信メッセージを送信するときに必要です。

TikTokメッセージを送信する

TikTokメッセージは、ユーザーが会話を開始した後にのみ送信できます。

送信メッセージは、NTT CPaaS APIまたはConversationsから送信できます。

メッセージを送信する前に、次のことを確認してください。

• ユーザーが会話を開始した
• TikTokビジネスアカウントを送信者として使用している
• 受信メッセージの ユーザー識別子 を宛先として使用します
• サポートされているメッセージタイプのいずれかを使用している
• アウトバウンドTikTokメッセージには有効期間が限られており、有効期間が切れると配信されない可能性があることをご存知ください。

Learn more

サポートされているメッセージタイプを顧客に送信する方法の詳細については、「 TikTokメッセージを送信する」 (opens in a new tab)を参照してください。

TikTokメッセージが失敗したり配信されなかったりした場合は、応答ステータスとエラーコードのドキュメントを確認して、考えられる原因と推奨されるアクションを理解してください。

ConversationsでTikTokを使用する

TikTokのメッセージングは、NTT CPaaSのコンタクトセンターソリューションであるConversationsで管理できます。これにより、エージェントはカスタム API 統合を構築することなく、Web インターフェイスから直接 TikTok 会話を処理できます。

会話のStart

TikTokユーザーがTikTokビジネスアカウントにダイレクトメッセージを送信すると、その会話はConversationsの受信トレイに自動的に表示されます。

会話を見つけるには:

1. NTT CPaaS Web インターフェイス (opens in a new tab)で、Conversations に移動します。
2. TikTokの送信者に接続されている受信トレイを選択します。
3. チャンネルが TikTok と表示されている新しい会話スレッドを探します。

TikTokメッセージに返信する

1. TikTokの会話スレッドを開きます。
2. [自分に割り当てる] を選択して、会話を自分に割り当てます。
3. メッセージフィールドに返信を入力します。
4. [送信] を選択します。

送信後、タイムスタンプの横にあるメッセージステータスインジケーターを確認します。

• 単一の灰色のチェックマーク: メッセージが送信中です
• 二重の灰色のチェックマーク: メッセージはユーザーに配信されました
• 緑色の二重チェックマーク: メッセージはユーザーによって表示されました
• 赤い三角: 配信エラーが発生したか、処理に失敗しました

双方向メッセージング

最初の返信後、エージェントとTikTokユーザーの両方が同じ会話スレッドでメッセージの交換を続けることができます。ユーザーからの新しいメッセージは、アクティブな Conversations スレッド内にリアルタイムで表示されます。

Learn more

エージェントのワークフロー、ルーティング、およびConversationsの自動化の詳細については、Conversationsドキュメントを参照してください。

ダイレクトメッセージ広告の会話

TikTokダイレクトメッセージ広告↗ (opens in a new tab) ユーザーが広告をクリックしてビジネスとの会話を開始できるようにします。

会話がTikTokダイレクトメッセージ広告から開始されると、最初のインバウンドメッセージには、会話の発信元を示す紹介情報が含まれます。

会話中にコンバージョンが発生した場合は、適切なAPIを使用してTikTokに報告できます。

ダイレクトメッセージ広告から始まる会話の場合:

• ソース識別子(sourceId):NTT CPaaSで接続されているTikTokビジネスアカウント(ビジネスアカウントID)を表します。
• 送信先識別子(tiktok_unique_identifier): 会話を開始したTikTokユーザーを表します。

返信を送信したり、コンバージョンをレポートしたりするときに、最初の受信メッセージからキャプチャされた宛先識別子を使用します。

POST https://api.infobip.com/saas/tiktok-ads/1/conversions
Authorization: App {{apiKey}}
Content-Type: application/json
 
{
  "sourceId": "{{sender}}",
  "conversions": [
    {
      "event": "CompletePayment",
      "event_time": 1684574395,
      "user": {
        "tiktok_unique_identifier": "{{destination}}"
      },
      "properties": {
        "quantity": "4",
        "price": "40",
        "currency": "BRL",
        "value": "160"
      }
    }
  ]
}

TikTok.me リンク会話

TikTok.me リンクは、TikTokビジネスアカウントとのダイレクトメッセージ会話を開く共有可能なリンクです。チャネルやキャンペーン全体で使用して、ユーザーを会話に誘導できます。

ユーザーが TikTok.me リンクを介して会話を開始すると、最初の受信メッセージには、タイプがREFERRAL_SHORT_LINKの紹介データが含まれます。このデータには、次のフィールドが含まれます。

• 会話 ID (conversationId): 返信メッセージの送信に必要な会話 ID。
• Ref パラメーター (ref): チャネルまたはキャンペーン間でリンクを区別するために使用される URL エンコードされたトラッキング文字列。英数字と - _ = をサポートし、最大長は 2,083 文字です。
• 事前入力されたメッセージ (prefilledMessage): TikTok.me リンクで構成されたメッセージテキスト。
• 事前入力されたメッセージの監査ステータス (prefilledMessageAuditStatus): 事前入力されたメッセージがTikTokのコンテンツ監査に合格したかどうか。可能な値: PASS、REJECT、または UNKNOWN。

Learn more

完全な紹介ペイロード構造については、「 TikTokインバウンドメッセージの受信 (opens in a new tab)」を参照してください。