初期設定ガイド

BEFORE YOU START

はじめに — OAuth認証について

GC ProBox は、Genesys Cloud の OAuthクライアント認証(Client Credentials) を使ってAPIに接続します。ユーザーのパスワードを預かる方式ではなく、専用に発行したクライアントID/シークレットと、それに紐付けた役割(権限セット)の範囲内でのみ動作します。つまり「GC ProBox に何をさせるか」は、お客様が作成する役割で完全にコントロールできます。

事前に確認してください

Genesys Cloud に 管理者権限(または OAuth クライアントと役割を作成できる権限)を持つアカウントでログインできること
ご利用組織のリージョンを確認していること — 日本のお客様は東京または大阪リージョンです:
東京: ログイン login.mypurecloud.jp / API api.mypurecloud.jp
大阪: ログイン login.apne3.pure.cloud / API api.apne3.pure.cloud
ご利用予定のエディション(Lite / Standard / Professional)が決まっていること — 必要な権限が異なります(エディション比較)

1

役割の作成(GC ProBox 用の権限セット)

GC ProBox 専用の役割を1つ作成し、必要な権限だけを付与します。既存の管理者役割を流用せず、専用役割を作るのが最小権限の観点で推奨です。

手順

Genesys Cloud の 管理 > ユーザー > 役割/権限 を開く
「役割を追加」をクリックし、名前を入力(例: GC ProBox 接続用)
「権限」タブで、下記の一覧に沿って権限を付与
保存

権限	用途
analytics > conversationDetail > view	インタラクション履歴の検索・表示
analytics > conversationAggregate > view	着信・応答・放棄などの集計(ログイン人数集計ほか)
analytics > userAggregate > view	ユーザー別パフォーマンス集計
analytics > queueObservation > view	キューのリアルタイム監視(マルチキュービュー / OM)
analytics > userObservation > view	ユーザーのリアルタイム状態監視
directory > user > view	ユーザー一覧・プロフィール参照
directory > group > view	グループ一覧
routing > queue > view	キュー一覧・設定参照
routing > skill > view	スキル一覧
routing > wrapupCode > view	ラップアップコード参照
authorization > role > view	役割一覧
architect > flow > view	IVR・フロー一覧
telephony > plugin > all	電話・DID 情報の参照
directory > user > edit ※1	ユーザー設定の変更(Power Tools)
routing > queue > edit ※1	キュー設定の変更(Power Tools)
routing > wrapupCode > add / edit / delete ※1	ラップアップコード管理(Power Tools)

権限(Standard の全権限に追加)	用途
directory > user > add / delete	ユーザーの作成・削除(一括操作)
authorization > grant	役割の一括割り当て
routing > queue > add / delete	キューのCSVインポート(追加・変更)
routing > skill > add / delete	スキルの一括作成
architect > userPrompt > view	プロンプトの音声プレビュー
recording > recording > view	録音の参照・再生
recording > recording > download ※2	録音の一括ダウンロード
recording > recording > delete ※2	録音の一括削除
speechAndTextAnalytics > data > view	トランスクリプトの一括取得

※1 Lite Edition では不要です(Power Tools 機能を含まないため)。
※2 録音のダウンロード・削除権限は影響が大きいため、運用ポリシーに沿って付与可否をご判断ください。

ℹ Genesys Cloud の権限体系はアップデートで随時変更されます。最新の必要権限一覧は製品マニュアルをご確認いただくか、お問い合わせください。

2

OAuthクライアントの作成

手順

Genesys Cloud の 管理 > 統合 > OAuth を開く
「クライアントを追加」をクリック
以下のとおり設定して保存

アプリ名	任意(例: GC ProBox)
説明	任意
トークンの有効期間	86400(デフォルトのまま)
付与タイプ	クライアント認証情報(Client Credentials)— 必ずこれを選択
役割	ステップ1で作成した「GC ProBox 接続用」役割を、対象のアクセス区分に割り当て

⚠ 保存するとクライアントIDとクライアントシークレットが表示されます。シークレットは第三者に共有せず、パスワード管理と同等の扱いで安全に保管してください。

3

GC ProBox に認証情報を入力

手順

GC ProBox を起動し、API Setting を開く
APIホストにリージョンのホスト名を入力(東京: api.mypurecloud.jp / 大阪: api.apne3.pure.cloud)
ステップ2で発行したクライアントIDとクライアントシークレットを入力して保存
接続テストを実行 — ヘッダーの表示が「認証済み」になれば完了です
キャッシュ更新を実行すると、組織のデータ取得が始まります

認証情報はお使いの端末内にのみ保存されます。外部のサーバーに送信・保管されることはありません。

TROUBLESHOOTING

うまくいかないときは

症状	よくある原因と対処
認証エラー(401)	クライアントID/シークレットの転記ミス。前後の空白が入っていないか確認し、再入力してください
権限エラー(403)	役割の権限不足、またはOAuthクライアントへの役割割り当て漏れ。ステップ1・2を再確認してください
データが表示されない	APIホスト(リージョン)の誤り。東京は api.mypurecloud.jp、大阪は api.apne3.pure.cloud です
一部のタブだけデータが出ない	そのタブに必要な権限が役割に含まれていません。権限一覧と突き合わせてください
更新が遅い / 429エラー	Genesys Cloud のレート制限です。GC ProBox は自動で待機・再試行しますので、そのままお待ちください

解決しない場合は、エラーメッセージの内容を添えてお問い合わせください。

初期設定は、3ステップ。