View a markdown version of this page

WhatsApp フローの作成と編集 - AWSエンドユーザーメッセージングソーシャル
フローの作成 (コンソール)フローの作成 (API)フローの更新フローの一覧表示と表示フローの削除

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

WhatsApp フローの作成と編集

WhatsApp フローは、AWSエンドユーザーメッセージングソーシャルコンソールまたはAWSエンドユーザーメッセージングソーシャル API を使用して作成できます。フローを作成すると、そのフローはドラフトステータスになります。必要に応じて、作成時に Flow JSON 定義を指定するか、アセットの更新オペレーションを使用して後で追加できます。

フローの作成 (コンソール)

  1. https://console.aws.amazon.com/social-messaging/ でAWSエンドユーザーメッセージングソーシャルコンソールを開きます。

  2. ビジネスアカウントを選択し、WABA を選択します。

  3. フロータブを選択します。

  4. [フローの作成] を選択します。

  5. フロー名に、フローの一意の名前を入力します。フロー名は WABA 内で一意である必要があります (最大 200 文字）。

  6. カテゴリ で、フローのビジネス目的を説明するカテゴリを 1 つ以上選択します。少なくとも 1 つのカテゴリが必要です。使用可能なカテゴリは次のとおりです。

    • サインアップ

    • サインイン

    • 予約予約

    • リード生成

    • お問い合わせ

    • カスタマーサポート

    • アンケート

    • ショッピング

    • その他

  7. テンプレート で、開始する構築済みテンプレートを選択するか、デフォルト を選択して空白のフローで開始します。エンドポイントなしで次のテンプレートを使用できます。

    • デフォルト — 空白の開始テンプレート

    • 購入の関心を集める — 潜在的な購入者から情報を収集する

    • フィードバックの取得 — お客様からのフィードバックを収集する

    • アンケートを送信する — マルチクエスチョンアンケートを作成する

    • カスタマーサポート — サポートリクエストの詳細を収集する

  8. [作成] を選択します。

フローを作成したら、フロー JSON を編集して画面とコンポーネントをカスタマイズできます。ページの右側にあるフロープレビューには、WhatsApp のユーザーにフローがどのように表示されるかのライブプレビューが表示されます。

フローの作成 (API)

CreateWhatsAppFlow API を使用して新しいフローを作成します。次の例では、 を使用してAWS CLI、名前とカテゴリを持つフローを作成します。

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_lead_generation_form" \
    --categories '["LEAD_GENERATION"]'

レスポンスには、Meta によって割り当てられたフロー ID が含まれます。

{
    "flowId": "{FLOW_ID}",
    "validationErrors": []
}

作成時に Flow JSON 定義を指定し、すぐに公開することもできます。

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "appointment_booking" \
    --categories '["APPOINTMENT_BOOKING"]' \
    --flow-json fileb://flow.json \
    --publish
注記

を含める場合--publish、フロー JSON が有効で、Meta の検証に合格する必要があります。検証エラーがある場合、フローは DRAFT ステータスで作成され、エラーは validationErrorsフィールドに返されます。

同じ WABA 内で既存のフローのクローンを作成するには:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "lead_form_v2" \
    --categories '["LEAD_GENERATION"]' \
    --clone-flow-id {FLOW_ID}

フローの更新

フローに対して実行できる更新には 2 種類あります。

  • メタデータの更新 — を使用してフロー名またはカテゴリを変更しますUpdateWhatsAppFlow。

  • アセットの更新 — を使用してフロー JSON 定義を変更しますUpdateWhatsAppFlowAssets。

重要

公開されたフローのアセットを更新すると、そのステータスが DRAFT に戻ります。メッセージで使用できるように、フローを再発行する必要があります。

次の の例では、フローの名前を更新します。

aws socialmessaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-name "updated_lead_form"

次の の例では、フローの JSON 定義を更新します。

aws socialmessaging update-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-json fileb://updated_flow.json

Flow JSON に検証エラーが含まれている場合は、レスポンスで返されます。フローを発行する前に、これらのエラーを修正する必要があります。

フローの一覧表示と表示

を使用して ListWhatsAppFlows WABA のすべてのフローを表示し、特定のフローに関する詳細GetWhatsAppFlowを取得します。

すべてのフローを一覧表示します。

aws socialmessaging list-whatsapp-flows \
    --id {WABA_ID}

特定のフローの詳細を取得します。

aws socialmessaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

GetWhatsAppFlow レスポンスには、フローステータス、カテゴリ、検証エラー、JSON バージョン、プレビュー情報、ヘルスステータスが含まれます。

Flow JSON 定義 (アセット) を取得するには、 を使用しますListWhatsAppFlowAssets。

aws socialmessaging list-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

レスポンスには、Flow JSON ファイルの署名済みダウンロード URL が含まれます。URL は短期間で期限切れになります。URL からファイルをダウンロードするために追加の認証は必要ありません。

フローの削除

削除できるのは、ドラフトステータスのフローのみです。公開または廃止されたフローは削除できません。

コンソールを使用してフローを削除するには、フロータブのフローを選択し、削除を選択します。

API を使用してフローを削除するには:

aws socialmessaging delete-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}
警告

フローの削除は永続的であり、元に戻すことはできません。