このページでは、テレフォニー統合用に Google Cloud プロジェクトを構成するために必要な手順について説明します。
Google Cloud プロジェクトを選択または作成する
SIP トランクは通信上の理由でのみプロジェクトに接続されますが、その影響は特定のプロジェクトに限定されません。
たとえば、3 つの異なるプロジェクト（開発、テスト、本番環境）があるとします。すべての SBC から GTP への通信に同じ SIP トランクが使用されている場合、SIP トランクを作成する最初のリクエストのみが成功し、同じリージョン/ホスト名で SIP トランクを作成する残りのリクエストは失敗します。
SIP トランクの管理専用の別のプロジェクトを使用することをおすすめします。これにより、別のチームがトランクを担当できるようになり、トランク UI 内で、開発、テスト、本番環境用に異なる SBC グループを確立できます。
Google Cloudが提供するサービスを使用するには、プロジェクトを作成する必要があります。プロジェクトはすべての Google Cloud リソースを整理します。プロジェクトは、共同編集者、有効化された API などのリソース、モニタリング ツール、お支払い情報、認証とアクセス制御で構成されます。1 つのプロジェクトを作成することも、複数のプロジェクトを作成してリソース階層内で Google Cloud リソースを構成することもできます。プロジェクトを作成する際は、プロジェクト ID をメモしてください。API 呼び出しを行うには、この ID が必要です。プロジェクトの詳細については、Resource Manager ドキュメントをご覧ください。
Google Cloud コンソールのプロジェクト セレクタページで、 Google Cloud プロジェクトを選択または作成します。
プロジェクトの選択または作成に必要なロール
- プロジェクトを選択する: プロジェクトの選択に特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトであれば、どのプロジェクトでも選択できます。
-
プロジェクトを作成する: プロジェクトを作成するには、
resourcemanager.projects.create権限を含むプロジェクト作成者ロール（roles/resourcemanager.projectCreator）が必要です。ロールを付与する方法を確認する。
権限
- Google Cloud コンソールで、[IAM と管理] -> [IAM] に移動します。
- 既存のサービス アカウントを選択するか、新しいサービス アカウントを作成し、
Dialogflow API Adminロールが割り当てられていることを確認します。このロールは、テレフォニー統合に必要です。
Phone number API へのアクセス
電話番号 API メソッドを使用するには、特別なアクセス権が必要です。詳細については、Google 担当者にお問い合わせください。
Dialogflow、会話プロファイル、電話番号を構成する
このセクションでは、関連付けられた Google Telephony Platform（GTP）電話番号を使用して Conversational AI 会話プロファイルを作成するプロセスについて説明します。
- Colab Enterprise に移動します。プロンプトが表示されたら、Compute Engine、Dataform、Vertex の各 API を有効にします。
- [ノートブックをインポート] をクリックし、データソースとして [URL] を選択します。この GitHub リポジトリの URL を入力し、[IMPORT] をクリックします。
PROJECT_IDフィールドに、インテグレーションに関連付けるプロジェクトの Google Cloud プロジェクト ID を入力します。既存のプロジェクトは、Cloud Console のページ上部にあるプルダウン メニューで確認できます。- 選択したリージョンを
REGIONフィールドに入力します。すべての Dialogflow リージョンがサポートされています。 JWTフィールドをそのままにするか、ここにJWT値を入力します。空白のままにすると、デフォルトで SSO が使用されます。- 上部の [プロジェクト] セクションの再生ボタンをクリックして、そのコード セクションを実行します。プロンプトが表示されたら、ノートブックに Google 認証情報へのアクセスを許可します。
- [Configuring Conversational AI for SIP/SIPREC] セクションを開きます。[Create a dummy Dialogflow ES agent...] で、[Show code] をクリックし、コードを変更せずに実行します。これにより、ダミーの Dialogflow ES エージェントが作成され、その階層が Enterprise に設定されます。Dialogflow API エンドポイントにアクセスするには、ダミーの Dialogflow ES エージェントが必要です。各 Google Cloud プロジェクトには、1 つの Dialogflow ES エージェントを設定できます。
ConversationProfileを作成するスクリプト... セクションのコードを表示するには、展開します。CONVERSATION_PROFILE_NAME: 任意の文字列を指定できます。デフォルト値を使用することも、独自の値を入力することもできます。SECURITY_SETTINGS: 任意の文字列を指定できます。デフォルト値を使用することも、独自の値を入力することもできます。PHONE_NUMBER_COUNTRY_CODE: GTP 電話番号に関連付ける国コードを入力します。CX_AGENT_NAME: 生成された会話プロファイルを関連付ける Dialogflow CX エージェントの名前を入力します。
- コードを実行します。出力には、生成された
ConversationProfileの名前、セキュリティ設定、GTP 電話番号が含まれます。 - Dialogflow ES コンソールに移動して、
Dummy_ES_agentという名前のエージェントが作成されていることを確認します。[設定] をクリックして、エージェントが正しいGoogle Cloud プロジェクトに関連付けられており、Essentials エディションにアップグレードされていることを確認します。 - Agent Assist コンソールに移動します。左側のメニューで [会話プロファイル] をクリックし、入力した
CONVERSATION_PROFILE_NAMEを含む会話プロファイルが作成されていることを確認します。 - Conversational AI Insights コンソールに移動します。Dialogflow CX エージェントに関連付けられているすべての会話文字起こしがインポートされていることを確認します。
（省略可）Dialogflow CX Phone Gateway の通話時間の割り当ての引き上げをリクエストする
Dialogflow ES Essentials と Dialogflow CX のサブスクリプションには、標準の利用可能な割り当てが付属しています。Dialogflow をまったく使用していない場合（Agent Assist、Transcription、Call Recording のみを使用している場合など）、デフォルトの割り当ては Dialogflow ES Essentials の割り当てと同じです。
推定トラフィックに基づいて、必要に応じて割り当ての増加をリクエストできます。ほとんどのユースケースでは、標準割り当てで設定とテストに十分ですが、ランタイム アプリケーションでは割り当ての増加が必要です。割り当ての詳細と引き上げをリクエストする手順については、Dialogflow の割り当てページをご覧ください。
（省略可）Dialogflow API の監査ロギングを有効にする
必要に応じて、管理読み取り、データ読み取り、データ書き込みの Dialogflow API（dialogflow.googleapis.com）の監査ログ記録を有効にできます。これにより、行われた個々の Conversational AI API 呼び出しと、認可と使用に使用された認証情報をすべて確認できます。これは、トラブルシューティングやデバッグに役立ちます。
次のステップ
SBC の設定と構成方法をご確認ください。