前提条件
  • 新規または既存のお客様で、新しいWhatsApp セルフサービス オンボーディングプロセスでは、新しいWhatsAppビジネスアカウント(WABA)を作成します。埋め込みサインアップフロー
    • この WABA の一部として少なくとも 1 つの新しい電話番号を登録し、Genesys Cloud 組織に WhatsApp 統合を作成します。 新しい電話番号はテスト番号または統合番号にすることができ、他の番号をこの WABA に移行したら後で削除できます。 組み込みサインアップを通じて少なくとも 1 つの新しい番号を登録しないと、Genesys クレジット ラインまたは支払い方法を WABA に関連付けることはできません。 有効な支払い方法がないと、WhatsApp は電話番号を WABA に移行できません。 したがって、少なくとも 1 つの新しい番号を登録する必要があります。
  • Meta Business Manager で Meta アプリを作成し、それに WhatsApp 製品を追加します。 電話番号の移行プロセスを開始するには、WhatsApp 権限を使用して Graph API リクエストを実行するためにこのアプリを設定する必要があります。 アクセス トークンまたはユーザー トークンの生成、権限の行使、移行の開始以外の目的でアプリを使用しないでください。 すべての番号を移行したら、後でビジネス マネージャーからアプリを削除できます。 
  • Graph API を使用して移行を開始します。Embedded Signup を通じて作成された WABA は Genesys ではなく企業が所有するため、Genesys がお客様に代わって移行を実行することはできません。

WhatsApp 製品を使用して Meta アプリを作成するには、次の手順を実行します。

  1. の中にメタビジネス設定ページで、次の操作を行います。
    1. アカウントセクションをクリックアプリ
    2. クリック追加選択して新しいアプリIDを作成する
    3. の中にアプリを作成するページ、選択他の
    4. の中にアプリの種類を選択ページ、選択仕事
    5. をクリックします。
    6. の中にアプリ名を追加するフィールドにアプリ名を入力します。
    7. (オプション)ビジネスアカウントフィールドで、Genesys Cloud Services, Inc. を選択します。
    8. クリックアプリを作成。 Meta App ダッシュボードが表示されます。
    9. の中にアプリに商品を追加するページのワッツアップタイル、クリック設定
    10. の中にクイックスタートページの左側のペインのアプリレビュー、 クリック権限と機能
    11. の中に権限と機能ページの検索フィールドに「business_management」と入力します。
    12. 「権限と機能」セクションで、アクセス レベルが標準アクセスである WhatsApp_business_management および business_management オプションを表示します。
  2. メタタブに移動してクリックしますリフレッシュします。
  3. ビジネス設定ページで作成した Genesys Cloud アプリを表示します。

アプリを作成したら、アプリ内で WhatsApp 製品のテスト Webhook コールバック URL を構成します。 Meta アプリの WhatsApp Webhook コールバック URL を構成するには、次の手順を実行します。

  1. ユニークなURLファインダー、一意の URL を作成します。 
  2. 一意の URL を別のブラウザ タブにコピーして貼り付け、Webhook サイトの URL に戻ります。
  3. Webhook サイトの URL で、次の操作を行います。
    1. ページ上部から、編集
    2. の中にURLを編集ダイアログボックスのレスポンス本文フィールドに、変数として $request.query.hub_challenge$ と入力します。
    3. 保存するをクリックします。
  4. Meta アプリで、次の操作を行います。
    1. 左側のパネルで、 WhatsApp > 設定、 クリック編集
    2. の中にWebhookのコールバックURLを編集するダイアログボックスのコールバックURLフィールドに一意の URL を貼り付けます。 
    3. の中にトークンを確認するフィールドにトークンの詳細を入力します (任意のテキスト文字列を含めることができます)。
    4. クリック確認する保存する設定を保存します。
  5. Webhook フィールドの横で、次の操作を行います。
    1. 編集フィールドをクリック管理
    2. の中にWebhook フィールドダイアログボックスの購読する列の下にあるすべてのボックスを選択します購読するカラム。
    3. クリック 完了

 メモ:   WhatsApp Cloud プラットフォーム上にある別の BSP から番号を移行する場合にのみ、Webhook の設定が必要です。 WhatsApp オンプレミス プラットフォームまたは既存の Genesys 所有の WABA から新しい組み込み WABA に番号を移行する場合は、電話の移行を直接開始してください。

ログインしたままMetaビジネスアカウントに移動してメタのグラフ API エクスプローラー。 API エクスプローラー ページの右側で、API を使用して POST リクエストを行う前に、認証パラメータが適切に設定されていることを確認します。
電話の移行を開始するには、次の手順を実行します。
  1. の中にアクセストークンダイアログボックスのメタアプリフィールドで、先ほど作成したメタ アプリ名を選択します。
  2. の中にユーザーまたはページフィールドで、ユーザー トークンを選択します。
  3. の中に権限を追加するフィールド、含めるwhatsapp_ビジネス_管理そしてビジネス管理権限権限のリストに表示されます。 そうでない場合はドロップダウンリストをクリックしてください選択します。 あなたは見つけることができます  whatsapp_ビジネス_管理オプションの他の権限カテゴリとビジネス管理の中にイベント グループ ページ権限カテゴリ。
  4. クリックアクセストークンを生成するボタン。 システムプロンプトが表示されたら、すべての WABA を選択します。 通常、移行の場合は、番号を移行する WABA を選択するだけで済みます。 アクセス トークンは、一定期間アイドル状態が続くと期限切れになります。 有効期限が切れた場合は、ページを更新するか、トークンを再度生成してください。
  5. クリック 提出する

移行を開始したかどうかを確認するには、WhatsAppマネージャーに移動し、アカウントツール > 電話番号、WABA に追加された番号が保留中またはオフラインのステータスで表示されます。

 メモ:   移行を開始すると、新しい WABA に番号が追加されるだけです。 ただし、移行が完了するまで、トラフィックは古い WABA に関連付けられた既存の WhatsApp 統合を経由して流れます。

Genesys Cloud の WhatsApp 組み込みサインアップフローを使用して、WhatsApp 電話の検証と登録を完了します。 番号に対して 2 要素認証が無効になっていない場合、電話は検証されますが、埋め込みの WhatsApp 統合を作成することはできません。 2FA を無効にすることは必須です。 ご連絡くださいGenesysCloudWhatsAppRequests@genesys.com Genesys が管理する古い WABA で、自分の番号からの 2 段階認証を無効にします。 別の BSP から番号を移行していて、その BSP が WABA を管理している場合は、その BSP に WABA を無効にしてもらう必要があります。

API リクエストが成功し、番号の移行を開始できた場合は、電話番号をアクティブ化できます。 APIリクエストがエラーを返した場合、Metaアプリの少なくとも1つが宛先WABAのWebhookにサブスクライブされている必要があることを示します。宛先WABAの新しいWebhookサブスクリプションを作成するには、POST呼び出しを実行します。 /WHATSAPP_BUSINESS_ACCOUNT_ID/登録済みアプリ終点。 

/WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps エンドポイントに GET 呼び出しを発行することで、サブスクリプションが成功したことを確認できます。

注記WhatsApp チャネルのダウンタイムのリスクを回避するには、実稼働番号の場合は、コンタクト センターが営業時間外の計画メンテナンス期間中に電話番号をアクティブ化します。 WhatsApp トラフィックは影響を受けず、古い統合が削除され、新しい統合が GC で作成されてアクティブ化されるまで切り替わりません。

埋め込みサインアップフローを使用して電話番号をアクティブ化するには、次の手順を実行します。

  1. 古い WABA の電話番号に関連付けられている Genesys Cloud の現在の WhatsApp 統合を削除します。 統合自体を削除する前に、まず統合に関連付けられたメッセージ ルートを削除する必要がある場合があります。
  2. 新しい WABA の一部として開始した番号に対して新しい WhatsApp 統合を構成します。 新しいWhatsApp統合の設定の詳細については、以下を参照してください。埋め込みサインアップフローを操作する。 
  3. プロセスが完了したら、次の操作を実行します。 
    1. Meta Business アカウントを選択します。
    2. 移行を開始した後に番号が追加された WhatsApp ビジネス アカウントを選択します。
    3. 移行した電話番号/ビジネス プロフィールを選択します。
    4. 番号を確認/登録し、統合を保存します。

承認されたすべての WhatsApp メッセージ テンプレートが古い WABA から新しい WABA に自動的に移行されるまでに数分かかる場合があります。 完了すると、新しいメッセージテンプレート名前空間WhatsAppによって割り当てられます。定型応答を再設定するには、次の手順を実行します。

  1. ログインメタビジネスマネージャー
  2. ビジネスを選択してください。
  3. 案内するWhatsApp マネージャー>アカウントツール>メッセージテンプレート
  4. WhatsApp によって割り当てられた新しい名前空間に応じて、Genesys Cloud Org 内のメッセージ テンプレート/定型応答を再構成します。WhatsAppテンプレートメッセージの追加方法とWhatsAppテンプレートメッセージの使用方法の詳細については、以下を参照してください。 WhatsAppテンプレートメッセージを追加するそしてWhatsAppのテンプレートメッセージを使用する。 

    宛先 WABA の新しい Webhook サブスクリプションを作成し、リクエストを削除する場合は、次の手順を実行します。

    1. の中にグラフ API エクスプローラー、アクセストークンセクションで、削除します作る消去に電話する/WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps エンドポイント。
    2. WhatsApp Business アカウント ID を入力します。
    3. 提出するをクリックします。