カスタムプロバイダーの設定 sms-configuration-custom

このページでは: API資格情報を作成し、認証方法を選択し、SMSおよびRCS メッセージを送信するためのヘッダー、ペイロード、インバウンド設定を設定することで、Adobe Journey Optimizerでカスタムメッセージプロバイダーを統合する方法について説明します。

この機能により、独自のメッセージプロバイダーを統合および設定できるようになり、デフォルトのオプション(Sinch、Twilio、Infobip)を超える柔軟性が得られます。 これにより、モバイルメッセージのオーサリング、配信、レポート、同意管理をシームレスに行うことができます。

カスタムプロバイダー設定を使用すると、Journey Optimizer 内でサードパーティのメッセージサービスを直接接続し、動的コンテンツのメッセージペイロードをカスタマイズし、オプトイン/オプトアウトの環境設定を管理して、SMS チャネルと RCS チャネルの両方でコンプライアンスを確保できます。

カスタムプロバイダーを設定するには、次の手順に従います。

API 資格情報の作成 api-credential

Adobeでは標準で使用できないカスタムプロバイダー(Sinch、Infobip、Twilioなど)を使用してJourney Optimizerでモバイルメッセージを送信するには、次の手順に従います。

  1. 左側のパネルで、管理 > チャネル​に移動し、SMS 設定​の下にある API 資格情報​メニューを選択して、「新しい API 資格情報を作成」ボタンをクリックします。

  2. 以下で説明するように、SMS API 資格情報を設定します。

    • SMS ベンダー:カスタム。

    • 名前:API 資格情報の名前を入力します。

    • プロバイダーのアプリ ID:SMS プロバイダーから提供されたアプリケーション ID を入力します。

    • プロバイダー名:SMS プロバイダーの名前を入力します。

    • プロバイダーの URL:SMS プロバイダーの URL を入力します。

    • チャネルタイプ:オプション。 この資格情報がどのモバイルチャネルを表しているかを示します(SMS、RCS、MMSなど)。

    • 認証タイプ:認証タイプを選択し、選択した認証方法に基づいて対応するフィールドに入力します。

  3. mTLS サポート」オプションを有効にすると、安全な接続を確立する前にクライアントとサーバーの両方が相互に認証するようになります。

    mTLS のみを使用するには、認証タイプ​ドロップダウンから「認証なし」を選択し、mTLS サポート​を有効にします。

    mTLSは、SMS プロバイダー(メッセージ送信)エンドポイントにのみ適用されます。 OAuth トークンエンドポイントではmTLSを使用できません。 テストする前に、トークンエンドポイントでmTLSが無効になっていることを確認します。

    note important
    IMPORTANT
    MTLS公開証明書APIから公開証明書をダウンロードし、サーバーのトラストストアに追加して、SMS送信エンドポイントをAdobe Experience Platform認証局チェーンを信頼するように設定します(想定されるクライアント CN: ajo-sms.aep-mtls.adobe.com)。そうしないと、Journey Optimizerでクライアント証明書が省略され、SMS配信が失敗します。
  4. ヘッダー」セクションで、「新しいパラメーターを追加」をクリックし、外部サービスに送信されるリクエストメッセージの HTTP ヘッダーを指定します。

    Content-Type および Charset ヘッダーフィールドはデフォルトで設定され、削除できません。

  5. プロバイダーペイロード​を追加して、リクエストペイロードを検証およびカスタマイズします。

    RCS メッセージの場合、このペイロードは後でコンテンツデザイン中に使用されます。

    note
    NOTE
    基本認証またはベアラー認証を使用してカスタム SMS プロバイダーを設定する際は、JSON ペイロードに authOption パラメーターを含める必要があります。 さらに、プロバイダーペイロード​は、テンプレート変数 {{fromNumber}}{{toNumber}}{{message}} を参照する必要があります。
  6. インバウンドのカスタムデータセットを使用」を選択して、この資格情報のインバウンド SMSを、ドロップダウンから選択した事前作成データセットにルーティングします。 ​ インバウンドキーワードのカスタムデータセットの使用について詳しく見る

    note
    NOTE
    データセットスキーマは​ XDM ExperienceEvent ​である必要があり、少なくとも次のフィールドグループを含める必要があります。
    • Adobe CJM ExperienceEvent - メッセージインタラクションの詳細
    • Adobe CJM ExperienceEvent - Message Execution Details
    • Adobe CJM ExperienceEvent - メッセージプロファイル詳細
    プロファイルに対してスキーマとデータセットを有効にする必要があります。
  7. API 資格情報の設定が完了したら、「送信」をクリックします。

  8. API 資格情報​メニューで、 ごみ箱アイコン をクリックして、API 資格情報を削除します。

  9. 既存の資格情報を変更するには、目的の API 資格情報を見つけて、「編集」オプションをクリックして必要な変更を行います。

  10. 既存の API 資格情報から「SMS 接続を検証」をクリックし、指定されたデバイスにサンプルメッセージを送信して、SMS API 資格情報をテストおよび検証します。

  11. 番号」フィールドと「メッセージ」フィールドに入力し、「接続を確認」をクリックします。

    note important
    IMPORTANT
    メッセージは、プロバイダーのペイロード形式に合わせて構造化する必要があります。

API 資格情報を作成して設定した後、SMS メッセージの Webhook のインバウンド設定を指定する必要があります。

TIP
サンドボックスごとに個別のエージェント設定(実稼動、開発など)を常に作成して管理します。 環境横断的なWebhook応答の問題を防ぐことができます。 サンドボックス間で同じAPI資格情報、Webhook、プロバイダーコールバック URL (RCS エージェントを含む)を再利用しないでください。

カスタム SMS プロバイダーの認証オプション auth-options

API キー

API 資格情報を作成したら、API キー認証に必要なフィールドに入力します。

  • 名前:API キー設定の名前を入力します。
  • API トークン:SMS プロバイダーから提供された API トークンを入力します。

MAC 認証

API 資格情報を作成したら、MAC 認証に必要なフィールドに入力します。

  • 名前:MAC 認証設定の名前を入力します。
  • API トークン:SMS プロバイダーから提供された API トークンを入力します。
  • API 秘密鍵:SMS プロバイダーから提供された API 秘密鍵を入力します。 このは、安全な通信のための MAC(メッセージ認証コード)を生成するために使用されます。
  • MAC 認証ハッシュ形式:MAC 認証のハッシュ形式を選択します。

OAuth 認証

API 資格情報を作成したら、OAuth 認証に必要なフィールドに入力します。

  • 名前:OAuth 認証設定の名前を入力します。

  • API トークン:SMS プロバイダーから提供された API トークンを入力します。

  • OAuth URL:OAuth トークンを取得する URL を入力します。

  • OAuth 本文grant_typeclient_idclient_secret などのパラメーターを含む、JSON 形式の OAuth リクエスト本文を指定します。

Journey Optimizerは、カスタム SMS コネクタの有効期限が切れると、OAuth トークンを動的に更新します。

JWT 認証

API 資格情報を作成したら、JWT 認証に必要なフィールドに入力します。

  • 名前:JWT 認証設定の名前を入力します。

  • API トークン:SMS プロバイダーから提供された API トークンを入力します。

  • JWT ペイロード:発行者、件名、オーディエンス、有効期限など、JWT に必要なクレームを含む JSON ペイロードを入力します。

チュートリアルビデオ video

recommendation-more-help
journey-optimizer-help