使用事例: エンドポイントを使用して画面に外部データソースを入力する

エンドポイントは、外部データソースを Apex フォームメッセージングコンポーネントに接続して動的な WhatsApp フローを実現します。フォームで外部ソースの情報を画面に表示します。たとえば、ある医院が顧客にどの体の部位が痛いかを尋ねるフォームを作成し、その疾患を専門とする医師のリストを提示できます。

必要なエディション

サポートされているエディションを表示する。
この記事の適用対象:	拡張 WhatsApp チャネル
この記事の適用対象外:	拡張アプリケーション内チャット、拡張 Web チャット v1、拡張 Web チャット v2、拡張 Facebook Messenger、標準および拡張 SMS、拡張 Apple Messages for Business、拡張 LINE、Bring Your Own チャネル

必要なユーザー権限
メッセージングコンポーネントを作成する	「アプリケーションのカスタマイズ」および「設定・定義を参照する」またはシステム管理者
メッセージングでメッセージを送受信する	メッセージングエージェント

必要なユーザー権限

メッセージングコンポーネントを作成する

「アプリケーションのカスタマイズ」および「設定・定義を参照する」

または

システム管理者

メッセージングでメッセージを送受信する

メッセージングエージェント

この例に似たものを作成する前に、Meta の「フローのエンドポイントの実装」ドキュメントについてよく理解しておいてください。

Apex ベースのフォームメッセージングコンポーネントのフロー形式を開きます。
[最初のメッセージ] の [エンドポイントを有効化] セクションに入力します。
1. ［Enable Endpoint］フィールドで、［True］ を選択します。
2. ［Endpoint URL］フィールドにエンドポイントを入力します。
どの体のどの部分が痛いかを顧客に尋ねる画面を作成するには、[画面]セクションに移動して、[+ 画面を追加]をクリックします。
[フロー画面タイトル] の [テキスト] 項目に、フローのこの画面の上部に顧客に表示されるタイトルを入力します。この例では、「Patient Intake」と入力します。
[+コンテンツを追加] をクリックし、[選択] リストをクリックして展開し、[単一選択質問] を選択します。[完了] をクリックします。
この [単一選択式質問] 画面要素では、顧客が選択できる体の部分のリストを作成できます。そのリストからの選択内容に基づいて、次の画面に適合医師のリストが表示されます。[単一選択式質問] 要素をクリックして展開し、その項目を入力します。
1. [項目 ID: テキスト] で、「medical_need」という名前を付けます。
2. [タイトル: テキスト] で、顧客に表示する質問を追加します。「Where are you experience pain? (痛みを経験している場所は?)」
3. [Options: Options Mode (オプション: オプションモード)] で、[Static Options (静的オプション)] を選択します。
4. [Manage Options (オプションの管理)] をクリックします。
5. [+ 追加] をクリックします。
6. [オプション 0] の [ID] 項目に、この項目の内部 ID を入力します。
7. [表示ラベル] 項目で [リテラル] を選択し、その下の項目に「アーム」など、医師が治療できる身体の部分を入力します。
8. [+ 追加] をクリックして、医師が必要な追加の身体部分のメニュー選択を作成します。
変更内容を保存します。
このフェーズでは、フォームプレビューに、単一選択の質問とその本文オプションが含まれる [患者受入] 画面が表示されます。
同じ画面の [画面要素] に戻り、作成した [単一選択式の質問] 要素をクリックして最小化します。
この次のステップでは、顧客が「Where are you experience pain? (痛みを感じている場所は?)」という質問への回答を確認するためにクリックするボタンを作成します。
[+ コンテンツを追加] をクリックし、[その他のコンテンツタイプ] をクリックして展開し、[フッター] を選択して、[完了] をクリックします。
[フッターボタン] の下の [テキスト] フィールドに「続行」と入力します。
[フッターアクション] セクションの [フッターアクション] フィールドで、[データ交換] を選択します。
[ペイロードの設定(Configure Payload)] をクリックします。
1. [名前] に、単一選択の質問の項目 ID を入力します。この例では、medical_need という名前を付けました。
2. [種別] で、[参照] を選択します。
3. [値] で、[入力] Patient Intake - medical_need を選択します。
変更内容を保存します。
画面プレビューで、単一選択の質問の下に [続行] ボタンが表示されます。
前の画面で顧客が選択した内容に基づいてエンドポイントのデータベースから医師のリストを表示する新しい画面を作成するには、[+ 画面を追加] をクリックします。
[フロー画面タイトル] セクションの [テキスト] 項目に、この画面のヘッダーを入力します。「 Doctor Preference (ドクタープリファレンス)」と呼びます。
[画面要素] で、[+コンテンツを追加] をクリックし、[選択] をクリックして展開し、[ドロップダウン選択] を選択して、[完了] をクリックします。
[ドロップダウン選択] をクリックして展開します。
1. [項目 ID] の [テキスト] 項目に「doctor_list」という名前を付けます。
2. [タイトル] の [テキスト] 項目に、フォームで顧客に表示されるコマンドを入力します。たとえば、「Select a Doctor」 (医師の選択) のようになります。
3. [オプション] の [オプションモード] フィールドで、[動的参照] を選択します。
4. ［Select Array Field］ドロップダウンで、［Data］ Doctor List - array を選択します。
変更内容を保存します。
画面プレビューに、外部データソースから入力された医師のドロップダウンが表示されている [医師希望設定] 画面が表示されます。
残りのフローの作成を続行します。