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

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

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

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

API 資格情報の作成 api-credential

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

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

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

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

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

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

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

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

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

  3. ヘッダー」セクションで、「新しいパラメーターを追加」をクリックし、外部サービスに送信されるリクエストメッセージの HTTP ヘッダーを指定します。

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

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

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

  5. API 資格情報の設定が完了したら、「送信」をクリックします。

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

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

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

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

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

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

カスタム 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 リクエスト本文を指定します。

JWT 認証

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

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

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

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

Webhook の作成 webhook

recommendation-more-help

オプトインキーワードやオプトアウトキーワードを指定していない場合は、ユーザーのプライバシーを遵守するために標準の同意メッセージが使用されます。カスタムキーワードを追加すると、デフォルト設定が自動的に上書きされます。

デフォルトのキーワード:

  • オプトイン:SUBSCRIBE、YES、UNSTOP、START、CONTINUE、RESUME、BEGIN
  • オプトアウト:STOP、QUIT、CANCEL、END、UNSUBSCRIBE、NO
  • ヘルプ:HELP

API 資格情報が正常に作成されたら、次の手順では Webhook を作成し、インバウンド設定を指定します。この設定により、システムが受信データまたはメッセージを適切に受信して処理できます。

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

  2. 以下で説明するように、Webhook 設定を指定します。

    • 名前:Webhook の名前を入力します。

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

    • API 資格情報を選択以前に設定した API 資格情報をドロップダウンから選択します。

    • オプトインキーワード:オプトインメッセージを自動的にトリガーするデフォルトまたはカスタムのキーワードを入力します。複数のキーワードの場合は、コンマ区切り値を使用します。

    • オプトインメッセージ:オプトインメッセージとして自動的に送信されるカスタム応答を入力します。

    • オプトアウトキーワード:オプトアウトメッセージを自動的にトリガーするデフォルトまたはカスタムのキーワードを入力します。複数のキーワードの場合は、コンマ区切り値を使用します。

    • オプトアウトメッセージ:オプトアウトメッセージとして自動的に送信されるカスタム応答を入力します。

  3. ペイロードエディターを表示」をクリックして、リクエストペイロードを検証およびカスタマイズします。

    プロファイル属性を使用してペイロードを動的にパーソナライズし、ビルトインのヘルパー関数を使用して、処理と応答の生成のために正確なデータを確実に送信できます。

  4. Webhook の設定が完了したら、「送信」をクリックします。

  5. Webhook メニューで、 ごみ箱アイコン をクリックして、Webhook を削除します。

  6. 既存の設定を変更するには、目的の Webhook を見つけて、「編集」オプションをクリックして必要な変更を行います。

  7. 以前に送信した Webhook から新しい Webhook URL にアクセスしてコピーします。

Webhook のインバウンド設定を作成し指定したら、SMS メッセージ用のチャネル設定を作成する必要があります。

設定が完了すると、メッセージオーサリング、パーソナライゼーション、リンクトラッキング、レポートなど、すべての標準のチャネル機能を活用できます。

チュートリアルビデオ video

b22c9c5d-9208-48f4-b874-1cefb8df4d76