このトピックでは、Resource Access Management (RAM) でのサービスアクセスの認可、チャネルの選択、アカウントの設定など、カスタマーサービスエージェント機能を認可し、有効化する方法について説明します。
前提条件
Chat App Message Service を有効化済みであること。
チャネルを作成し、対応するアカウントの登録、バインド、または認可を完了していること。チャネルは [Channel Management] で管理できます。
背景情報
カスタマーサービスエージェントプラットフォームは、Alibaba Cloud の RAM ロールを介して Chat App リソースにアクセスします。有効化プロセスは、次の 3 つの手順で構成されます。
サービスアクセスの認可:RAM コンソールで認可ロールを作成し、信頼ポリシーとアクセスポリシーを設定します。
チャネルの選択:カスタマーサービスに使用するチャネルを選択します。現在、WhatsApp チャネルのみがサポートされています。
アカウントの設定:特定の WABA アカウントとビジネス電話番号を選択します。
操作手順
パート 1:サービスアクセスの認可
Chat App Message Service コンソールの各手順の横にある [View Example] ボタンをクリックすると、対応する操作のスクリーンショットを表示できます。
ステップ 1:RAM コンソールでのロール作成
Chat App Message Service コンソールにログインします。
左側のナビゲーションペインで、[Customer Service Agent] をクリックします。
サービスアクセスの認可ページで、[Go to RAM Console] をクリックします。
新しいウィンドウで、Alibaba Cloud のRAM コンソールのロール管理ページが開きます。
ステップ 2:信頼されたエンティティタイプの選択
RAM コンソールのロール一覧ページで、[Create Role] をクリックします。
[Create Role] ダイアログボックスで、[Trusted Entity Type] を [Alibaba Cloud Account] に設定します。
ステップ 3:信頼されたエンティティアカウントの入力
[Trusted Entity] を [Other Alibaba Cloud Account] に設定します。
入力フィールドに、次の固定 UID を入力します:
1084693755814212
UID は上記の値と完全に一致している必要があります。一致しない場合、検証は失敗します。
ステップ 4:ロールの作成と命名
[OK] をクリックします。
[Create Role] ダイアログボックスで、[Role Name] を
CPaaSServiceに設定します。
ロール名は上記の値と完全に一致している必要があります (大文字と小文字を区別します)。
ステップ 5:権限管理ページへの移動
ロールが正常に作成されたら、[OK] をクリックします。
ロールの詳細ページで、[Permission Management] タブをクリックします。
[Add Permission] をクリックします。
ステップ 6:アクセスポリシーの検索と選択
[Add Permission] パネルで、検索ボックスに cams と入力します。
アクセスポリシー AliyunCamsFullAccess を見つけて選択します。
[Grant Permission] をクリックして、アクセスポリシーのバインドを完了します。
ステップ 7:信頼ポリシーの編集
信頼ポリシーエディターを開く
[Trust Policy] タブをクリックします。
[Edit Trust Policy] をクリックして、スクリプト編集モードに入ります。
信頼ポリシーの内容を編集する
[Script Editor] で、既存のすべてのコンテンツを削除します。
次のコンテンツをコピーして、エディターに貼り付けます:
{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "Service": [ "cams.aliyuncs.com" ] } } ], "Version": "1" }[OK] をクリックして、信頼ポリシーを保存します。
ステップ 8:認可の検証
Chat App Message Service コンソールのサービスアクセスの認可ページに戻ります。
[Role Created] をクリックします。
システムは、認可が成功したかどうかを自動的に検証します。
検証成功:ページは自動的に次のステップに進みます。
検証失敗:次の設定を確認してください:
信頼されたエンティティの UID:
1084693755814212ロール名:
CPaaSService(大文字と小文字を区別)アクセスポリシー:
AliyunCamsFullAccess信頼ポリシーの JSON が完全にコピーされていること
すべての設定が正しいことを確認した後、[Role Created] をクリックして再検証します。
パート 2:チャネルの選択
認可が検証されると、ページは自動的にチャネルタイプの選択ページにリダイレクトされます。
チャネルタイプを選択します。カスタマーサービスに使用するチャネルアカウントを選択します。現在、WhatsApp のみがサポートされています。[Channel Management] で WhatsApp Business Account (WABA) をバインドしていない場合、次のステップで利用可能なアカウントを選択することはできません。
[Next] をクリックします。
パート 3:アカウントの設定
WABA アカウントとビジネス電話番号の選択
アカウント設定ページで、検索ボックスに WABA ID またはアカウント名を入力してアカウントを検索します。Chat App Message Service に正常にバインドされた WABA アカウントのみが表示されます。利用可能な WABA アカウントがない場合は、[Channel Management] で WhatsApp チャネルのバインドを完了していることを確認してください。
目的の WABA アカウントをクリックして、ビジネス電話番号リストを展開します。
1 つ以上のビジネス電話番号を選択します。WABA アカウントにバインドされているすべての電話番号を選択できます。選択された番号は、カスタマーサービスエージェントプラットフォームでのセッションアクセスとメッセージングに使用されます。
[Confirm Activation] をクリックします。
パート 4:カスタマーサービスメッセージワークベンチを開く
有効化が完了したら、右上隅の [Go to Customer Service Agent Platform] をクリックしてカスタマーサービスメッセージワークベンチに移動し、カスタマーサービスエージェント機能の管理を開始します。
初めてカスタマーサービスエージェントプラットフォームに移動すると、サードパーティアプリケーションの管理者認可ダイアログボックスが表示されます。[Obtain the Alibaba Cloud ID of the visitor] が選択されていることを確認し、[Authorize] をクリックしてください。
初回に [Obtain the Alibaba Cloud ID of the visitor] を選択しなかった場合は、サードパーティアプリケーションを削除してから、再度 [Go to Customer Service Agent Platform] をクリックしてください:
RAM アクセス制御 > OAuth アプリケーション > [Third-party Applications] を開きます。
[アプリケーション] タブで、削除するアプリケーションを見つけます。 アプリケーション名は
CpassLoginで始まり、CpassLogin@app.******.onaliyun.comのようになっています。[Actions] 列で、[Delete Application] をクリックします。
Chat App Message Service コンソールのカスタマーサービスエージェントページに戻り、[Go to Customer Service Agent Platform] をクリックします。
サードパーティアプリケーションの管理者認可ダイアログボックスで、[Obtain the Alibaba Cloud ID of the visitor] を選択し、[Authorize] をクリックしてください。
Chat App Message Service コンソールからカスタマーサービスエージェントプラットフォームを開くと、デフォルトで管理者ロールが割り当てられます。ブラウザから直接カスタマーサービスメッセージワークベンチにアクセスする場合、開かれるページは現在のアカウントの権限に依存します。後でアクセスするために、カスタマーサービスメッセージワークベンチの URL を保存しておくことを推奨します: https://intl.dycpaas.com/。
カスタマーサービスエージェントサービスの認可削除
カスタマーサービスエージェントを使用しなくなった場合は、カスタマーサービスエージェントサービスの認可を削除できます:
RAM アクセス制御 > ロールを開きます。
CPaaSServiceという名前のロールを探します。[Actions] 列で、[Delete Role] をクリックします。
削除を完了します。
カスタマーサービスエージェントサービスの認可を削除すると、カスタマーサービスエージェントプラットフォーム内のデータも削除されます。操作は慎重に行ってください。