Before You Install the Recipe

You must perform the following configuration tasks on your SurveyMonkey instance and Slack instance in order to successfully connect to these external systems using Oracle Integration and post notification messages in Slack for completed survey responses.

Configure SurveyMonkey

You must perform the following prerequisite tasks in your SurveyMonkey instance.

  1. Create and configure a SurveyMonkey app.
    1. Log in to the SurveyMonkey Developer console at https://developer.surveymonkey.com/.
    2. Click My Apps on the title bar of the SurveyMonkey Developer home page.
    3. On the My Apps page, click Add a New App.
    4. In the resulting APP CREATION dialog, enter the app's name in the App Nickname field, and select Private App as the App Type option.
    5. Click Create App.
      SurveyMonkey creates an app and displays the client ID and secret details on the resuling page.
    6. Under the Settings section, enter the following in the OAuth Redirect URL field.
      https://{OIC_HOST}:{OIC_SSL_PORT}/icsapis/agent/oauth/callback

      Replace OIC_HOST and OIC_SSL_PORT with specific values to your Oracle Integration instance.

    7. Get the SurveyMonkey API credentials.
      1. Click SETTINGS to open the app's settings.
      2. Scroll down to the Credentials section, and note the values in the Client ID and Secret field.
      Click the eye icon in the Secret field to view the value. You'll need the SurveyMonkey API credentials, that is the client ID and secret values while configuring the SurveyMonkey connection from Oracle Integration.
    8. Select the scopes.
      1. In the Scopes section, select the following scopes:
        • Create/Modify Surveys
        • Create/Modify Collectors
        • Create/Modify Responses
        • View Surveys
        • View Collectors
        • View Responses
        • View Response Details
      2. Click Update Scopes.

        You get a confirmation message that the scopes are successfully updated.

  2. Create a survey in SurveyMonkey for which you want to receive responses.
    1. Log in to your SurveyMonkey account at https://www.surveymonkey.com/user/sign-in/.
    2. On the SurveyMonkey Dashboard, click CREATE SURVEY on the title bar.
    3. Create a survey using one of the following options in the Create a new survey pane on the left:
      • Start from scratch
      • Copy a past survey
      • Buy Targeted Response
      • Import Questions
      • Start from template
      • Build it for me
      Find information related to creating and managing surveys under the Design and Manage topic in the SurveyMonkey Help Center (https://help.surveymonkey.com/).

      Note down the name of the survey that you have created.

    4. Click Next to preview your survey.
    5. Click Next to view the COLLECT RESPONSES section.
    6. Click Send surveys your way.
      The COLLECT RESPONSES section displays the different ways in which you can collect the responses.
    7. Click Share a survey link.

      The COLLECT RESPONSES section displays the details of the web link collector. Note down the name of the collector. For example, Web Link 1.

Configure Slack

Complete the following tasks in your Slack instance to successfully connect to it using Oracle Integration and post notification messages.

  1. Create a Slack app and configure it to receive notifications for successful Stripe charges.
    1. Log in to the Slack app platform at https://api.slack.com.
    2. From the workspace navigation menu, click your workspace.
    3. Select Administration and then select Manage apps.
    4. In the Slack app directory page, click Build.
    5. Click Create an App, and in the resulting Create an app dialog, select From scratch.
    6. In the Name app & choose workspace dialog, enter the following details.
      Field Information to Enter
      App Name

      Enter the name of your app. For example, Oracle Integration App.

      Pick a workspace to develop your app in Select your workspace from the drop-down list.
    7. Click Create App.
      The app gets created and its Basic Information page appears.
    8. Get the Slack App API credentials. In the app's Basic Information page, scroll down to the App Credentials section. Note the client ID in the Client ID field, and the client secret in the Client Secret field.
      These API credentials, that is the client ID and secret, were automatically generated when you created the app. You'll use these later while configuring connections to your Slack instance from Oracle Integration.
    9. Set permission and scope for your Slack App. In the left menu, under Features, select OAuth & Permissions.
    10. In the OAuth & Permissions page, go to the Redirect URLs section.
    11. Click Add New Redirect URL and enter the URL of your Oracle Integration instance. For example, https://your_instance_URL:443/icsapis/agent/oauth/callback, where your_instance_URL is the Host URL of your Oracle Integration instance.
    12. Click Add, and then click Save URLs.
    13. Scroll to the Scopes section, and under User Token Scopes click Add an OAuth Scope.
    14. Enter the following scopes:
      • channels:read
      • channels:write
      • chat:write
      • groups:read
      • groups:write
      • usergroups:write
      Note the scopes. You'll use these later while configuring connections to your Slack instance from Oracle Integration.
    15. Press Enter.
  2. You have to set up a workspace in Slack, create a channel in the workspace, and then add people who should receive the survey completed notification messages into the channel.
    1. Create a workspace in Slack.
      1. Open the Slack get started page using the following URL:
        https://slack.com/get-started#/createnew
      2. Enter your email and click Continue.
      3. Enter the confirmation code that you receive in your email, click Create a workspace, and follow the prompts.
    2. Create a channel to post notifications.
      1. On your Slack instance, select your workspace.
      2. Click the workspace name on the left navigation pane, and from the menu that displays, select Create a channel.
      3. In the Create a channel dialog, enter your channel’s name in the Name field. For example, #survey-responses.
      4. Optionally, enter a suitable description in the Description field to let others know what the channel is about.
      5. Click Create.
    3. Add people to your channel.
      1. On your Slack workspace, select the channel from the left navigation pane to open it.
      2. Click Add people on the top right of the channel.
      3. In the resulting Add people dialog, enter names, emails, or user groups of people you want to add in the field provided.
      4. Click Add.