カスタムオブジェクトにデータを保存する柔軟性が加わり、お客様には最近の注文情報などが自動で表示され、このオブジェクトデータから選択したり、注文のキャンセルなどの操作も可能になります。
1. カスタムオブジェクトを作成する
まず、設定のカスタムオブジェクトデータに移動し、price、ratingなど必要なフィールドを持つ新しいカスタムオブジェクトを作成します。
2. ユーザーと会話への参照を作成する
次に、設定の会話データに移動し、会話からオブジェクトへの新しい参照を作成します。この例ではオブジェクトをOrderと名付けました。ここで、1つの会話が複数の注文を参照できるため、「複数のOrdersを参照許可」トグルをオンにします。カスタムオブジェクトの参照設定について詳しくはこちら
次に、People dataに移動し、Ordersオブジェクトへの新しい参照を作成します。ここでも、1人のユーザーが複数の注文をした可能性があるため、「複数のOrdersを参照許可」トグルをオンにします。
3. データコネクタを設定する
次のステップは、データを取得してOrderオブジェクトに保存するデータコネクタを設定することです。
データコネクタの設定時に、ステップ2で作成した参照を、レスポンス設定のPeopleまたはConversationsからOrderへの参照更新セクションで選択します。
4. Workflowを設定する
Fin AI Agent > Workflowsに移動し、+ 新しいworkflowをクリックします。
ゼロからWorkflowを作成し、トリガーとして「カスタマーがMessengerで新しい会話を開く」を選択します。
トリガールールの設定を完了し、保存して閉じるをクリックしてWorkflowの構築を開始します。これでウェルカムパスや返信ボタンをカスタマイズできます。
例えば、返信ボタンから注文を表示するパスを追加できます。このパスで+ボタンをクリックし、APIを使ったデータコネクタを選択します。
ドロップダウンからデータコネクタを選び、失敗時のコンテキストをユーザーに伝えるために失敗パスを追加します。
次に再度+ボタンをクリックし、今度はカスタムオブジェクトからのボタンを選択します。
カスタムオブジェクトからボタンを追加すると、以下のフィールドを入力する画面が表示されます。
データを選択...
上記のいずれでもない
選択を保存先に...
データを選択をクリックし、ドロップダウンで以下を選択します:
From - ボタンを表示したいオブジェクト、ここではOrders。
Where - 会話またはユーザーへの参照属性。ここでは「Conversation from contextの会話内Orders」です。これにより現在の会話に関連付けられたオブジェクトの各インスタンスが表示されます。
ボタンの数 - 取得するアイテム数の上限（最大25）。
ボタンに表示する内容 - この例では注文された商品の名前を表示します。
次に選択を保存先にをクリックし、+ 会話をOrderにリンクを選択します。
これにより会話データに戻り、+ 属性を作成をクリックして、Workflowから選択された内容を保存するOrderオブジェクトへの新しい参照を作成できます。
「複数のOrdersを参照許可」トグルはオフにしてください。この参照はWorkflowから選択された単一のオブジェクトのみを保存します。
Workflowタブに戻り、変更を保存してページを更新し、新しく作成した参照属性を選択します。
注意: これらの返信はカスタムオブジェクトインスタンスを表し、返信はそのインスタンスのexternal_updated_at値で並べられます。
最新のexternal_updated_at値がリストの上部に、最も古い値がリストの下部（「上記のいずれでもない」に近い）に表示されます。
各インスタンスのexternal_updated_at値は、並べたい順に設定してください。
5. カスタムオブジェクトからユーザーにデータを表示する
ユーザーが注文を選択すると、その選択が選択された注文参照に保存され、そのオブジェクトのデータをWorkflowメッセージ内で直接表示できます。
そのために、データを選択ボタン（この例ではOrders > Item_name）からパスを追加し、属性セレクターの{..}ボタンをクリックして表示したい属性を選択します。
ヒント: 複数のカスタムオブジェクト参照がある場合は、属性セレクターの見出しを見て正しいものを選択してください。例えば上記ではConversation > Selected order (order)参照を選んでいます。
注意: カスタムオブジェクトから作成されたボタンを配信するWorkflowをテストする場合は、必ず「ライブ」Messengerインスタンスで行ってください。Workflowプレビュー機能はカスタムオブジェクトにアクセスできず、ボタンを正しく表示できません。
Workflowをライブに設定すれば準備完了です！🎉
Inboxでカスタムオブジェクトインスタンスのデータを表示する
ユーザーがWorkflowとやり取りを始めると、データコネクタがリクエストに対してどの注文を返し、どの注文を選択したかを確認したくなります。
会話詳細サイドバーを見れば確認できます。この例では、会話に取得されたすべての注文が「Orders for Conversation」参照属性の下に表示され、選択された注文は「Selected Order」に保存されます。
Inboxでのカスタムオブジェクトデータについてはこちらをご覧ください。