受信メッセージを構成する

CPaaS X環境のサブスクリプション機能は、次のような複数の通信チャネルにわたる受信メッセージ(MO)構成もサポートしています。

Apple Messages for Business
Facebook Messenger
線
MMS
RCS
SMS
Viberビジネスメッセージ
WhatsApp
Zalo

この一元化された構成により、ユーザーは、他の受信イベントタイプと同じツールと構造を使って、インバウンドメッセージイベント(INBOUND_MESSAGE)の管理を効率化できます。ユーザーは、チャネル固有の要件に対する柔軟性を維持しながら、サブスクリプションでインバウンドメッセージ設定を統一することで、セットアップを簡素化できます。

インバウンドメッセージが届くと、システムは既存の構成をチェックして処理方法を決定します。

Number-specific pull/forward configuration (番号固有のプル／転送構成)：番号固有のプルまたは転送構成がインバウンドメッセージに存在する場合、システムはそれを実行します。
Follow subscription settings (サブスクリプションのフォロー設定)：番号にサブスクリプションのフォロー設定がある場合、システムはインバウンドメッセージ用に定義された、一致するサブスクリプション設定に従います。
Non-forwarding actions (非転送アクション)：これらのアクションは転送やサブスクリプションのフォロー設定に関係なく実行されます。

これにより、定義された構成が尊重され、指定どおりに実行されます。

インバウンドメッセージのフロー

インバウンドメッセージを構成するには、次の手順に従います：

1. サブスクリプションを定義する

インバウンドメッセージを管理するチャネルごとにサブスクリプションを作成または編集します。 Webインターフェイス (opens in a new tab)を使っている場合は、目的のイベントの中から インバウンドメッセージ を必ず選択するようにします。サブスクリプションAPI (opens in a new tab)を使っている場合は、INBOUND_MESSAGEイベントを含めます。

2. 通知プロファイルをセットアップする

受信メッセージイベントを受信するための Webhook URL と authentication settings を割り当てます。

3. 構成を検証する

セットアップをテストして、インバウンドメッセージが期待どおりに処理されることを確認します。

インバウンドメッセージのフロー例

インバウンドメッセージがメッセージングプロバイダーから受信されます。
システムが番号固有の設定をチェックします。
- 構成済みの転送アクションがある場合は、番号固有の設定に従ってメッセージが処理されます。
- サブスクリプションが設定されている場合、システムはサブスクリプション設定に従います。
- 他のすべての非転送アクションは、サブスクリプション設定や転送アクションに関係なく実行されます。
メッセージは、設定された形式に従って処理されます。
メッセージは、通知プロファイルで指定されている適切なウェブフックまたはエンドポイントに配信されます。

フォーマットの割り当て

各サブスクリプションでは、受信メッセージを処理するための既定の形式が自動的に割り当てられます。これらの形式は、受信メッセージの一貫した処理を保証するためにチャネル固有です。

サポートされているチャネルでは、次の定義済みの JSON ベースの形式を使用して、受信メッセージを構造化および処理します。

チャンネル	表示形式
Apple Messages for Business	`MO_OTT_CONTACT`
Facebook Messenger	`MO_OTT_MSISDN`
線	`MO_OTT_MSISDN`
MMS	`MO_MMS_2`
RCS	`MO_OTT_MSISDN`
SMS	`MO_JSON_2`
Viberビジネスメッセージ	`MO_OTT_MSISDN`
WhatsApp	`MO_OTT_CONTACT`
Zalo	`MO_OTT_MSISDN`

デフォルトの形式が要件を満たさない場合は、そのチャネルで使用可能な他の形式から選択できます。これを行うには、サポート (opens in a new tab) にお問い合わせください。

サブスクリプションを管理する証明書のアップロードと管理