レシピをインストールする前に

Oracle Integrationを使用してこれらの外部システムに正常に接続し、Slackで完了したサーベイ・レスポンスの通知メッセージをポストするには、SurveyMonkeyインスタンスとSlackインスタンスで次の構成タスクを実行する必要があります。

SurveyMonkeyの構成

SurveyMonkeyインスタンスで次の前提条件タスクを実行する必要があります。

SurveyMonkeyアプリケーションの作成と構成

SurveyMonkeyアプリケーションを作成し、Oracle IntegrationからSurveyMonkey APIにアクセスするように構成する必要があります。

SurveyMonkeyアプリケーションを作成します。
1. https://developer.surveymonkey.com/にあるSurveyMonkey開発者コンソールにログインします。
2. SurveyMonkey開発者ホーム・ページのタイトル・バーで「自分のアプリケーション」をクリックします。
3. 「自分のアプリケーション」ページで、「新しいアプリケーションを追加」をクリックします。
1. 結果の「APP CREATION」ダイアログで、App Nicknameフィールドにアプリケーション名を入力し、「アプリケーション・タイプ」オプションとして「プライベート・アプリケーション」を選択します。
2. 「アプリケーションの作成」をクリックします。
SETTINGSをクリックして、アプリケーション設定を開きます。
設定セクションで、「OAuthリダイレクトURL」フィールドに次のように入力します。
```
https://{OIC_HOST}:{OIC_SSL_PORT}/icsapis/agent/oauth/callback
```
OIC_HOSTおよびOIC_SSL_PORTを、Oracle Integrationインスタンスの特定の値に置き換えます。
SurveyMonkey API資格証明を取得します。
1. 資格証明セクションまでスクロールし、「クライアントID」および「機密」フィールドの値を確認します。
  
  「機密」フィールドの目のアイコンをクリックして、値を表示します。 Oracle IntegrationからSurveyMonkey接続を構成する際に、クライアントIDおよびシークレット値であるSurveyMonkey API資格証明が必要になります。
スコープを選択します。
1. スコープ・セクションで、次のスコープを選択します:
  - サーベイの作成/変更
  - コレクタの作成/変更
  - レスポンスの作成/変更
  - 調査の表示
  - コレクタの表示
  - 応答の表示
  - 応答詳細の表示
2. 「スコープの更新」をクリックします。
  スコープが正常に更新されたという確認メッセージが表示されます。

サーベイの作成

SurveyMonkeyに、レスポンスを受信するサーベイを作成する必要があります。

https://www.surveymonkey.com/user/sign-in/でSurveyMonkeyアカウントにログインします。
SurveyMonkeyダッシュボードで、タイトル・バーのCREATE SURVEYをクリックします。
左側の新規サーベイの作成ペインにある次のオプションのいずれかを使用して、サーベイを作成します:
- 一から開始します。
- 過去のサーベイのコピー
- ターゲット・レスポンスの購入
- 質問のインポート
- テンプレートから開始
- ビルド
SurveyMonkey Help Center (https://help.surveymonkey.com/))のデザインと管理トピックで、調査の作成と管理に関連する情報を検索します。
アンケートをプレビューします。

Slackの構成

Slackインスタンスで次の前提条件タスクを実行する必要があります。

Slackアプリケーションの作成と構成

Slackアプリケーションを作成し、Oracle Integrationによって送信される通知メッセージを受信するように構成する必要があります。

Slackアプリケーションを作成します。

https://api.slack.comにあるSlackアプリケーション・プラットフォームにログインします。
Slack APIタイトル・バーで、「アプリケーション」をクリックします。
「アプリケーションの作成」をクリックし、結果のアプリケーションの作成ダイアログで「最初から」を選択します。

名前アプリケーション&のワークスペースの選択ダイアログで、次の詳細を入力します。

フィールド	入力する情報
アプリケーション名	アプリケーションの名前を入力します。たとえば、`Oracle Integration App`です。
ワークスペースを選択してアプリケーションを開発	ドロップダウン・リストからワークスペースを選択します。

「アプリケーションの作成」をクリックします。
アプリケーションが作成され、その「基本情報」ページが表示されます。

SlackアプリケーションAPI資格証明を取得します。
1. アプリケーションの「基本情報」ページで、「アプリケーション資格証明」セクションまでスクロール・ダウンします。
2. 「クライアントID」フィールドのクライアントIDと、「クライアント・シークレット」フィールドのクライアント・シークレットに注意してください。
  クライアントIDおよびシークレットであるこれらのAPI資格証明は、アプリケーションの作成時に自動的に生成されました。これらは、後でOracle IntegrationからSlackインスタンスへの接続を構成するときに使用します。
Slackアプリケーションの権限を設定します。
1. 左側のメニューの「機能」で、「OAuth &権限」を選択します。
2. 「OAuth &権限」ページで、「リダイレクトURL」セクションに移動します。
3. 「新規リダイレクトURLの追加」をクリックし、Oracle IntegrationインスタンスのURLを入力します。たとえば、https://your_instance_URL:443/icsapis/agent/oauth/callbackです。your_instance_URLは、Oracle IntegrationインスタンスのホストURLです。
4. 「追加」をクリックし、「URLの保存」を次にクリックします。
5. スコープ・セクションまでスクロール・ダウンし、ユーザー・トークン・スコープで「OAuthスコープの追加」をクリックします。
6. 次のスコープを入力します:
  - channels:read
  - channels:write
  - chat:write
  - groups:read
  - groups:write
  - usergroups:write
  スコープを書き留めてください。これらは、後でOracle IntegrationからSlackインスタンスへの接続を構成するときに使用します。
7. [Enter]を押します。

Slack WorkSpaceおよびチャネルの設定

Slackでワークスペースを設定し、ワークスペースでチャネルを作成し、サーベイ完了の通知メッセージを受信するユーザーをチャネルに追加する必要があります。

Slackにワークスペースを作成します。
1. 次のURLを使用して、Slackの開始ページを開きます:
```
https://slack.com/get-started#/createnew
```
2. 電子メールを入力し、「持続」をクリックします。
3. 電子メールで受信する確認コードを入力し、「ワークスペースの作成」をクリックしてプロンプトに従います。
通知を投稿するチャネルを作成します。
1. Slackインスタンスで、ワークスペースを選択します。
2. 左側のナビゲーション・ペインでワークスペース名をクリックし、表示されるメニューから「チャネルを作成」を選択します。
3. チャネルの作成ダイアログで、「名前」フィールドにチャネル名を入力します。たとえば、#survey-responsesです。
4. オプションで、適切な説明を「説明」フィールドに入力して、チャネルが何であるかを他のユーザーに知らせます。たとえば: このチャネルは、インシデントがServiceNowで作成されるたびに通知します。
5. 「作成」をクリックします。
チャネルにユーザーを追加します。
1. Slackワークスペースで、左側のナビゲーション・ペインからチャネルを選択して開きます。
2. チャネルの右上にある「ユーザーの追加」をクリックします。
3. 結果の「個人の追加」ダイアログで、指定されたフィールドに名前、Eメールまたはユーザー・グループを入力します。
4. 「追加」をクリックします。