Configuring SurveySparrow Application in Salesforce Marketplace

Welcome to the SurveySparrow Application integration guide for Salesforce Marketplace configuration. This comprehensive guide will walk you through the installation process and post-installation setup, ensuring a seamless integration of SurveySparrow with your Salesforce environment. Follow the step-by-step instructions to set up SurveySparrow within Salesforce, enabling you to streamline survey processes and gather valuable insights. Whether you are a Salesforce administrator or an end-user, this guide provides clear and concise instructions to optimize your experience with SurveySparrow in the Salesforce Marketplace. Let's get started on enhancing your survey capabilities and maximizing the potential of these powerful platforms working together.

 
Installation Process
1. Navigate to SurveySparrow App in the AppExchange listing:
- Click on "Get It Now" to begin the installation process.
2. Log in to the AppExchange:
- If not logged in, you will be prompted to sign in.
3. Select Install Environment:
- Choose between sandbox or production install.
4. Accept Terms and Conditions:
- Check and accept terms and conditions, then click "Confirm and Install."
5. Log in to Target Salesforce Org:
- You will be prompted to log in to your target Salesforce org to initiate the installation.
6. Installation Settings:
-Select an installation option based on who should have access to the app: Admins only, All users, or Specific profiles.
- Click "Install."
7. Installation Confirmation:
- Users may receive a message indicating that the app is taking time to install.
- Click "Done" and wait for an email confirmation from Salesforce support.
8. Post Installation:
- Once complete, the SurveySparrow app will appear in your list of apps in the app launcher.

Post Installation Setup
1. Navigate to Setup:
a. From Setup, search for "Site" and click on "Sites."

b. Register Salesforce Site:
- Accept the site terms of use and register your Salesforce site domain.

c. Create a New Site:
- Create a new site with a label, name, and active checkbox.
- Save the site.

d. Public Access Settings:
- Click on Public Access Settings.

e. Click on ‘Enabled Apex Class Access’


f. Click on ‘Edit’ under the  Enabled Apex Class Access.

g.Select the ‘SVSP.WebHookResponseHandleClass’ Apex class and add to the ‘Enabled Apex Classes’ and click on ‘Save’.


h.Configure Custom Settings:

In Setup, search for 'Custom settings' and under Custom code, click 'Custom settings.'

1. Manage SurveySparrow Integration.

• Click the manage button to paste the public site URL which we created.
  
• Click on the Edit button
  
  
•  Paste the public site URL in the 'Webhook Site URL' text area field and save it.
  
  Note: Please ensure that you include the complete Webhook site URL, starting with "https://"
  
  Platform Cache Configuration:
• Search for Platform Cache in setup and choose AccessToken.
  Allocate capacity to store the token value for temporary use.
  
  
  Configure SurveySparrow App
  
  3.1 Setup Page
  
  1. Navigate to SurveySparrow App:
  2.  Go to the Setup Tab.
• Select the Data Center checkbox to configure with Salesforce and SurveySparrow.
• Click on 'Connect SurveySparrow.'
  
  3. Authorization:
• It will redirect you to the SurveySparrow login portal.
• On successful authorization, the SurveySparrow app gets connected.
  
  3.2 Create SurveyRunner And Configure Flow
  
  1. Create SurveyRunner Record:
  
• Click on the 'Survey Runners' tab and create a new record.
  
  
• Provide necessary information and click 'Save and Launch Flow Builder.'
  
  2. Flow Configuration:
  - Choose 'Record Triggered Flow' and create the flow.
  
  
  
•  Configure the object and conditions to trigger the flow.
   
  3. Action Configuration:
  
• Add an action named 'SurveyIntegrationManagerClass.'
• Choose the Class. And Give the Name and Label for the Action.
  
  
  
• Scroll down the page, provide the Record ID and Survey Runner, then click the "Done" button.
  (The Survey Runner refers to the name assigned during the creation of the flow under Survey Runners.)
  
  Click on Save Button and Give name for the flow and click on ‘Save’.
  
  
• After setting the conditions and action, Activate the flow. 
  
  3.3 Trigger the SurveyRunner And Get the Responses
  
  Once the Flow and SurveyRunner configurations are complete, you need to create or update object records based on the Flow conditions. The respective Flow triggers the ‘SurveyIntegrationManagerClass’, which then sends the survey to the user via email or SMS, as configured in SurveyRunner.
  
  
  2. The user receives the survey link via email or SMS and must
  complete the questionnaire from SurveySparrow.
  
  
  
  3. After completing the questionnaire, the user must click ‘Submit’ to finalize their response.

3.4. Responses and Reports Tab

1. Upon submission, SurveySparrow triggers the Salesforce webhook URL, capturing the responses and automatically creating response records in Salesforce.
   
2. In the Reports tab, click on All Folders, then select the SurveySparrow folder.
3. There are two types of report files available: Responses by Share Type and Responses by Survey. Clicking on either file displays the responses from the last 30 days.
   

Feel free to reach out to us if you have any questions. We’re just a chat away.