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

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

SurveyMonkeyの構成

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

SurveyMonkeyアプリケーションを作成して構成します。
1. SurveyMonkey Developerコンソール(https://developer.surveymonkey.com/)にログインします。
2. SurveyMonkey開発者ホーム・ページのタイトル・バーで「自分のアプリケーション」をクリックします。
3. 「自分のアプリケーション」ページで、「新しいアプリケーションを追加」をクリックします。
4. 表示される「APP CREATION」ダイアログで、アプリケーションの名前を「アプリケーションのニックネーム」フィールドに入力し、「アプリのタイプ」オプションとして「プライベート・アプリ」を選択します。
5. 「アプリケーションの作成」をクリックします。
  SurveyMonkeyは、アプリケーションを作成し、再ルーティング・ページにクライアントIDおよびシークレットの詳細を表示します。
6. 設定セクションで、「OAuthリダイレクトURL」フィールドに次のように入力します。
```
https://{OIC_HOST}:{OIC_SSL_PORT}/icsapis/agent/oauth/callback
```
  OIC_HOSTおよびOIC_SSL_PORTを、Oracle Integrationインスタンスに対する特定の値に置き換えます。
7. SurveyMonkey API資格証明を取得します。
  1. SETTINGSをクリックして、アプリケーションの設定を開きます。
  2. 「資格証明」セクションまでスクロールし、「クライアントID」および「機密」フィールドの値を確認します。
  「シークレット」フィールドの目のアイコンをクリックして、値を表示します。 Oracle IntegrationからSurveyMonkey接続を構成する際に、SurveyMonkey API資格証明(クライアントIDおよびシークレット値)が必要になります。
8. スコープを選択します。
  1. 「スコープ」セクションで、次のスコープを選択します:
    - サーベイの作成/変更
    - コレクタの作成/変更
    - レスポンスの作成/変更
    - 調査の表示
    - コレクタの表示
    - 回答の表示
    - 応答詳細の表示
  2. 「スコープの更新」をクリックします。
    スコープが正常に更新されたという確認メッセージが表示されます。
レスポンスを受信するサーベイをSurveyMonkeyに作成します。
1. SurveyMonkeyアカウント(https://www.surveymonkey.com/user/sign-in/)にログインします。
2. SurveyMonkeyダッシュボードで、タイトル・バーのCREATE SURVEYをクリックします。
3. 左側の新規サーベイの作成ペインにある次のオプションのいずれかを使用して、サーベイを作成します:
  - 一から開始します。
  - 過去のサーベイのコピー
  - ターゲット・レスポンスの購入
  - 質問のインポート
  - テンプレートから開始
  - ビルド
  SurveyMonkey Help Center (https://help.surveymonkey.com/))のデザインと管理トピックで、調査の作成と管理に関連する情報を検索します。
  作成したサーベイの名前を書き留めます。
4. 「次」をクリックして、サーベイをプレビューします。
5. 「次」をクリックして、「COLLECT RESPONSES」セクションを表示します。
6. 「アンケートの送信方法」をクリックします。
  「COLLECT RESPONSES」セクションには、レスポンスを収集できる様々な方法が表示されます。
7. 「サーベイ・リンクの共有」をクリックします。
  
  「COLLECT RESPONSES」セクションには、webリンク・コレクタの詳細が表示されます。コレクタの名前を書き留めます。たとえば、Web Link 1です。

Slackの構成

Oracle Integrationを使用して正常に接続し、通知メッセージをポストするには、Slackインスタンスで次のタスクを実行します。

Slackアプリケーションを作成し、正常なStripe料金の通知を受信するように構成します。

Slackアプリケーション・プラットフォーム(https://api.slack.com)にログインします。
ワークスペースのナビゲーション・メニューから、ワークスペースをクリックします。
「管理」を選択し、「アプリを管理」を選択します。
Slackアプリケーション・ディレクトリ・ページで、「ビルド」をクリックします。
「アプリケーションの作成」をクリックし、結果のアプリケーションの作成ダイアログで「最初から」を選択します。

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

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

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

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