TikTokの会話イベント

TikTokの会話イベントは、メッセージコンテンツを超えたリアルタイムのシグナルを表示することで、エージェントとユーザー間のメッセージ交換を充実させます。サポートされているイベントには、入力インジケーター、開封確認、メッセージへの返信コンテキスト、リアクションなどがあります。

Events フローは 2 つの方向に流れます。

• アウトバウンド(MT): システムまたはエージェントがTikTokユーザーにイベントを送信します。
• インバウンド(MO): TikTokユーザーは、NTT CPaaSがWebhookに配信するイベントを送信します。

アウトバウンドイベント(MT) [#outbound-events-mt]

アウトバウンドイベントは、アクティブな会話中にシステムまたはエージェントがTikTokユーザーに送信するアクションです。すべてのアウトバウンド イベントでは、ユーザーがすでに会話を開始している必要があります。

入力インジケーター [#outbound-typing-indicator]

入力インジケーターを送信して、エージェントが返信を作成していることをTikTokユーザーに知らせます。

入力インジケーターイベントは、WhatsApp Send Events APIと同じパターンに従います。

もっと詳しく知る

リクエスト構造とフィールドの詳細については、「 TikTokイベントの送信」を参照してください。

既読としてマークする [#outbound-mark-as-read]

既読としてマークイベントを送信して、エージェントが特定のインバウンドメッセージを読み取ったことを確認します。

既読マーク イベントは、メッセージ識別子を使用して特定のメッセージを対象とします。識別子は、受信メッセージの Webhook ペイロードで使用できます。

Mark-as-Readイベントは、WhatsApp Send Events APIと同じパターンに従います。

もっと詳しく知る

リクエスト構造とフィールドの詳細については、「 TikTokイベントの送信」を参照してください。

メッセージに返信する [#outbound-reply-to-message]

特定の受信メッセージを参照する返信を送信します。これにより、アドレス指定しているメッセージに関するコンテキストをユーザーに表示できます。

TikTokメッセージの送信 APIリクエスト内に返信コンテキストを追加します。インバウンド Webhook ペイロードからのメッセージ識別子を使用して、参照されるメッセージを識別します。

もっと詳しく知る

リクエスト構造とフィールドの詳細については、「 TikTokイベントの送信」を参照してください。

受信イベント (MO) [#inbound-events-mo]

インバウンドイベントは、会話中にTikTokユーザーが送信するシグナルです。NTT CPaaSは、これらのイベントを設定済みのWebhookエンドポイントに配信します。

HTTP 200応答を返して、各受信イベントを確認する必要があります。

もっと詳しく知る

Webhookペイロードの構造とフィールドの詳細については、「 TikTokインバウンドイベントの受信」を参照してください。

入力インジケーター [#inbound-typing-indicator]

NTT CPaaSは、TikTokユーザーがメッセージの作成を開始すると、入力インジケーターイベントをWebhookに配信します。このイベントを使用して、エージェント向けインターフェイスでリアルタイムの入力ステータスを表示します。

インバウンド タイピング インジケータ イベントは、RCS インバウンド タイピング インジケータと同じパターンに従います。

開封確認 [#inbound-read-receipt]

NTT CPaaSは、TikTokユーザーがアウトバウンドメッセージを閲覧すると、開封確認イベントをWebhookに配信します。イベントには、読み取られたメッセージの識別子が含まれます。

メッセージに返信する [#inbound-reply-to-message]

TikTokユーザーが会話内の特定のメッセージに返信すると、インバウンドWebhookイベントには、ユーザーが参照した元のメッセージを識別するコンテキストが含まれます。

応答コンテキストは、受信メッセージの標準 Webhook ペイロード内に追加フィールドとして表示されます。

インバウンド返信メッセージイベントは、WhatsApp受信インバウンドメッセージAPIと同じパターンに従います。

反応 [#inbound-reaction]

NTT CPaaSは、TikTokユーザーが会話内のメッセージに反応すると、Webhookにリアクションイベントを配信します。イベントには、リアクションを受信したメッセージの識別子とリアクションタイプが含まれます。

インバウンドリアクションイベントは、WhatsApp受信インバウンドメッセージAPIと同じパターンに従います。

イベント概要 [#event-summary]

次の表は、サポートされているすべての会話イベントとその方向と配信メカニズムの一覧です。