Skip to content

Front

Frontの統合により、各プラットフォームからBrazeデータ変換およびwebhookを活用して双方向の会話型SMSパイプラインを設定できます。

Frontからの受信webhookには、ライブエージェントが送信したメッセージを含むペイロードが含まれています。リクエストは、Brazeのエンドポイントで受け入れられるようにするため、事前に再フォーマットしておく必要があります。Frontデータ変換テンプレートによりペイロードが再フォーマットされ、イベントプロパティとして渡されるメッセージ本文とともにOutbound SMS Sentというタイトルのカスタムイベントがユーザープロファイルに書き込まれます。

Brazeで新しい変換を設定する前に、データ変換ドキュメントの各ティアのサポートマトリックスを確認することをお勧めします。無料およびProティアでは、月ごとのアクティブな変換と受信リクエストの数が異なります。現在のプランがユースケースをサポートできるか確認してください。

前提条件

開始する前に、次のものが必要になります。

前提条件 説明
Frontアカウント このパートナーシップを利用するには、Frontアカウントが必要です。
Brazeデータ変換Webhook URL Brazeデータ変換は、Frontからの受信webhookを再フォーマットして、Brazeの/users/trackエンドポイントで受け入れられるようにするために使用されます。
Front REST APIキー Front REST APIキーを使用して、BrazeからFrontへのアウトバウンドWebhookリクエストを行います。

ユースケース

  • Brazeの自動SMSメッセージングを使用してリード生成プロセスを合理化し、ユーザーの好みを特定し、ライブ販売エージェントがフォローアップして販売を完了できるようにします。
  • 自動SMS応答とライブチャットサポートによりセールスコンバージョンを促進することで、ショッピングカートを放棄した顧客を再エンゲージします。

Frontの統合

ステップ1:データ変換を作成する

まず、Brazeで新しいデータ変換を作成します。次の手順は簡略化されています。完全な手順については、変換の作成を参照してください。

  1. Brazeで、Data Settings > Data Transformationsに移動し、Create Transformationを選択します。
  2. Editing Experienceで、Start from scratchを選択します。
  3. Select Destinationで、POST: Track Usersを選択します。
  4. 次の変換テンプレートをコピーして貼り付け、エンドポイントを保存してアクティブ化します。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    
     // This is a default template that you can use as a starting point. Feel free to delete this entirely to start from
     // scratch, or to delete specific components as you see fit
    
     // First, this code defines a variable, "brazecall", to build up a /users/track request
     // Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in
     // desired values in your /users/track request with JS dot notation, such as payload.x.y.z
    
     let brazecall = {
     "events": [
       {
       "phone": payload.recipients[1].handle,
       "_update_existing_only": true,
       "name": "Outbound SMS Sent",
       "time": new Date().toISOString(),
       "properties": {
         "message_id": payload.id,
         "message_body": payload.body,
         "front_author_username": payload.author.username
       }
       }
     ]
     };
    
     // After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
     return brazecall;
    

    変換は次のようになります。

    データ変換の例。

ステップ2:アウトバウンドSMS Campaignを作成する

次に、FrontからのWebhookをリッスンするSMS Campaignと、顧客に対するカスタムSMS応答を作成します。

ステップ2.1:メッセージを作成する

Messageテキストボックスに、次のLiquidコード、およびオプトアウト言語やその他の静的コンテンツを追加します。

1
{{event_properties.${message_body}}}

メッセージは次のようになります。

Liquidコードを使ったメッセージの例。

2.2 配信をスケジュールする {#22-schedule-the-delivery}

配信タイプにはAction-Based deliveryを選択し、カスタムイベントトリガーにはOutbound SMS Sentを選択します。

「Schedule Delivery」ページ。

最後に、Delivery Controlsで再適格性を有効にします。

「Delivery Controls」で再適格性が有効になっている。

ステップ3:カスタムチャネルを作成する

Frontのダッシュボードで、Settings > Channels > Add Channelsに移動し、Custom Channelを選択して、新しいBrazeチャネルの名前を入力します。

FrontダッシュボードのBraze用カスタムチャネル。

ステップ4:設定を構成する

アウトバウンドAPIエンドポイントフィールドに、以前に作成したデータ変換Webhook URLを入力します。新しいBrazeチャネルでのライブエージェントからのすべてのアウトバウンドメッセージはここに送信されます。このチャネルは、BrazeがSMSメッセージを転送するためのエンドポイントURLもIncoming URLフィールドに提供します。

このURLをメモしておいてください。後で必要になります。

Frontに新しく作成されたBrazeチャネルのチャネル設定。

ステップ5:インバウンドSMS転送の設定

次に、Brazeで2つの新しいWebhook Campaignを作成します。これにより、顧客からのインバウンドSMSをFrontの受信トレイに転送できます。

番号 目的
Webhook Campaign 1 ライブチャットの会話が要求されていることをFrontに通知します。
Webhook Campaign 2 顧客からインバウンドで送信されたすべての会話型SMS応答をFrontの受信トレイに転送します。

ステップ5.1:SMSキーワードカテゴリを作成する

Brazeのダッシュボードで、Audienceに移動し、SMSサブスクリプショングループを選択して、Add Custom Keywordを選択します。Frontの専用SMSキーワードカテゴリを作成するには、次のフィールドに記入してください。

フィールド 説明
キーワードカテゴリ キーワードカテゴリの名前(例:FrontSMS1)。
キーワード カスタムキーワード(例:TIMETOMOW)。一般的な言葉を避けて、誤ってトリガーされないようにしてください。キーワードは大文字と小文字を区別しないため、lawnLAWNと一致します。
返信メッセージ キーワードが検出されたときに送信されるメッセージ(例:「造園業者からまもなく連絡があります」)。

BrazeのSMSキーワードカテゴリの例。

ステップ5.2:最初のWebhook Campaignを作成する

Brazeのダッシュボードで、以前に作成したURLを使用して最初のWebhook Campaignを作成します。

Brazeで最初に作成すべきWebhook Campaignの例。

次の内容をリクエストボディに追加してください:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
 "sender": {
  "handle": "{{${phone_number}}}",
  "name": "{{${user_id}}}"
 },
 "body_format": "markdown",
 "metadata": {
  "headers": {
   "first_name": "{{${first_name}}}",
   "last_name": "{{${last_name}}}"
  }
 },
 "body": "{{sms.${inbound_message_body} | default : "no body available" }}"
}

設定タブで、Authorizationcontent-type、およびacceptのリクエストヘッダーを構成します。

3つの必須ヘッダーを持つリクエストの例。

ステップ5.3:最初の配信をスケジュールする

Schedule Deliveryで、Action-Based Deliveryを選択し、トリガータイプとしてSend an SMS Inbound Messageを選択します。また、以前に設定したSMSサブスクリプショングループとキーワードカテゴリを追加します。

最初のWebhook Campaignの「Schedule Delivery」ページ。

Delivery Controlsで再適格性を有効にします。

最初のWebhook Campaignの「Delivery Controls」で再適格性が選択されている。

ステップ5.4:2番目のWebhook Campaignを作成する

2つ目のWebhook Campaignは1つ目と一致するので、1つ目を複製して名前を変更することができます。

ステップ5.5:2回目の配信をスケジュールする

Schedule Deliveryで、アクションベースのトリガーSMSサブスクリプショングループ最初の配信と同じに設定します。ただし、キーワードカテゴリにはOtherを選択してください。

2つ目のWebhook Campaignの「Schedule Delivery」ページ。キーワードカテゴリとして「Other」が選択されている。

ステップ5.6:オーディエンスフィルターを追加する

これで、Webhook Campaignが顧客からのインバウンドSMS応答を転送できるようになりました。ライブチャット用のメッセージのみが転送されるようにSMS応答をフィルタリングするには、Last Received Message From Specific CampaignセグメンテーションフィルターをTarget Audiencesステップに追加します。

「Last Received Message From Specific Campaign」を選択したオーディエンスフィルター。

次に、フィルターを設定します:

  1. Campaignには、以前に作成したSMS Campaignを選択します。
  2. Operatorには、Less Thanを選択します。
  3. Time Windowには、顧客からの応答がない状態でチャットを開いたままにしておく期間を選択します。

選択したオーディエンスフィルターの設定。

考慮事項

課金セグメント

  • BrazeでのSMSメッセージはメッセージセグメントごとに課金されます。何がセグメントを定義し、どのようにメッセージが分割されるかを理解することは、メッセージの請求方法を理解するうえで重要です。詳細については、当社のドキュメントをご覧ください。
  • エージェントの応答が長いと、課金対象セグメントの消費が増加します。

データポイントの記録

現在、この統合では、ライブエージェントがFrontからSMSを送信するたびに、ユーザープロファイルにカスタムイベントを書き込む必要があります。これは、2、3メッセージで終わるような素早いやりとりには適しているかもしれませんが、会話が長くなればなるほど、データポイントへの影響も大きくなります。Brazeのデータポイントのニュアンスについてご質問があれば、Brazeアカウントマネージャーがお答えします。

Frontライブチャットからリンクを送信すると、追加のHTMLタグとともにレンダリングされます。

Frontから画像ファイルを添付する

Brazeから送信されたSMSメッセージでは、Frontの画像ファイルは表示されません。

オプトアウト

会話型メッセージでは、あいまいなオプトアウトとして認識される可能性のある言葉(「stop」など)が含まれるリスクが高くなります。

New Stuff!