Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Connected App Name

Feedier 

API Name

Feedier

Contact Email 

help@feedier.com (or your email)

API (Enable OAuth Settings)
Enable OAuth Settings

TICKED

— Callback URL

https://dashboard.feedier.com/integration/callback/salesforceObject
https://dashboard.feedier.com/integration/callback/salesforce

https://connect.feedier.com/rest/oauth2-credential/callback

— Selected OAuth Scopes

(api)
(refresh_token,offline_access)

(full)
(lightning)

...

Collect App Client ID and App Client Secret for connection on Feedier

...

After adding your details, save and go back to the app, then click ‘Manage Consumer Details’ to collect the App client ID and App Client Secret. You will use this whenever connecting to an action on Feedier.

...

Note

Note: When testing, if you’re having problems connecting, please check the following:

  • Untick Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows

    Screenshot 2024-01-24 at 12.28.20.pngImage Added
  • Change permitted users to ‘All users may self-authorize’ and IP Relaxation to ‘Relax IP restrictions’

    Screenshot 2024-01-24 at 12.29.32.pngImage Added
Info

Manage Connected Apps → Feedier → Manage → Edit policies

Workflow 1: Enrich Feedback data with attributes from one or several Salesforce objects

This workflow is designed to update feedback on Feedier with key attributes from the respondant’s Salesforce record.

Note

Before triggering the integration

...

Tip

After triggering the integration

...

Steps to establish the integration

Add a Segment

Info

Feedier → Actions Feedback → Segments → New Segment

First we need to setup a segment on Feedier. Segments are saved searches that allow you to create automisations based on your selected feedback.

  • Create a segment that will identify all feedback that needs to be enriched by Salesforce data. If you need all of feedback, just set a filter with time period is greater than beginning of the year.

Connect the Segment to an Automation

Info

Feedier → Actions Profile Name → Automations → Add Segment

  • Select the segment you just created.

  • Select Salesforce Fields Sync from the dropdown.

    Image Added

App Client ID

Refer to step 1, you get this from the Connected App in Salesforce.

App Client Secret

Refer to step 1, you get this from the Connected App in Salesforce.

Salesforce SOQLFeedier supports custom SOQL to be as performant as possible. So, as long as there is an ID and a relationship, you can get any kind of Salesforce field using SOQL. Please refer to Salesforce doc

Refer to next section

Attribute Name

The attribute name we receive in the feedback (for example, "sf_id") is used to match Salesforce records. This could be an Account ID, Custom ID, or Contact ID. For instance, if the feedback link looks like this: feedback.feedier.com/survey-url?sf_id=123, we will use "sf_id" as the attribute name and its value, 123, in the Salesforce query to find the correct record.

In short, this attribute ("sf_id") will be used in the "WHERE" part of the Salesforce query (SOQL)

Info

How to Create Your SOQL

To effectively query data in Salesforce using SOQL (Salesforce Object Query Language), you can follow the steps below. SOQL allows you to retrieve data from Salesforce objects like Contact and Account. In this section, we will walk you through how to access the Salesforce Developer Console and create your own SOQL queries. You can also refer to Salesforce documentation for the structure: https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm

Important notes

  1. Feedier will attach as attributes all the selected fields to the Feedback. 

  2. Feedier will only read the first record from the query. So you can order if several records might be matched.

  3. The query must contain "{attribute_value}" as this attribute value will always change and be replaced automatically. It can be an ID or a value for a LIKE query/matching.

Here are 2 examples:

Query 1: SELECT Contact_P__r.Id, Ticket_Type_Number__c, St__c, Produit__c, SourceSystem__c, Type__c, EffectiveDate__c, Category__c FROM TransactionDetail__c WHERE Contact_P__r.Id = '{attribute_value}'  ORDER BY EffectiveDate__c DESC
Explanation: Find a Contact record in Salesforce by its ID, join several custom objects, and order by date descending. All the selected fields will be attached to Salesforce.

Query 2: SELECT Name FROM Account WHERE http://Account.Id = '{attribute_value}'
Explanation: Find an Account record in Salesforce by its ID and attach the Name field value to Feedier as attributes.

...

Attribute Name

...

This is the Feedier attribute name (not label) that contains the Salesforce object ID used for the matching. It can be an Account ID, a Custom ID, a Contact ID, etc.

For example, feedback.feedier.com/survey-url?sf_id=123 will create an attribute sf_id with the value 123. In this option set sf_id.

Please don't hesitate to contact your Feedier Account manager for help.

...

Info

All the retrieved attributes will be added as metadata to the received feedback, with every column returned from the SOQL query attached as an attribute.

To start writing SOQL queries, you need to access the Salesforce Developer Console. Once open, navigate to the Query Editor to begin writing SOQL queries.

Example 1: Retrieving Contact Data

Once in the Query Editor, you can run the following query to retrieve data related to a specific contact:

Code Block
SELECT Id, FirstName, LastName, Email, Phone, AccountId FROM Contact WHERE Id = 'contact_id'

This query retrieves the contact’s ID, first name, last name, email, phone number, and associated account ID. Below is an example of the query and its results in the Developer Console:

Screenshot 2024-09-12 at 14.27.46.pngImage Added

Example 2: Retrieving Account Data

To retrieve details related to a specific account, use the following query:

Code Block
SELECT Id, Name, Industry, BillingCity, BillingState, BillingCountry FROM Account WHERE Id = 'Account_id'

This query fetches the account's ID, name, industry, and billing address details (city, state, and country). Below is an example of this query and its output:

...

Example 3: Retrieving Contact and Account Data Based on Contact ID

Finally, you can query both Contact and its associated Account data using the following SOQL:

SELECT Id, FirstName, LastName, Email, Phone, Account.Name, Account.Website FROM Contact WHERE Id = 'contact_id'

This query retrieves the contact’s details along with the associated account’s name and website. Below is an example of how this query looks and its result:

Screenshot 2024-09-12 at 14.32.15.pngImage Added

Final Step: Dynamic Configuration of SOQL Queries

In the final step of integrating your SOQL queries into the dynamic environment, you will replace the hardcoded ID values used for testing in the Query Editor with a dynamic configuration. This allows the SOQL query to take a parameter from the attribute name you set in the integration field, ensuring it matches the correct Salesforce object ID.

For example, the static query tested in the editor:

Code Block
languagesql
SELECT Id, FirstName, LastName, Email, Phone, AccountId 
FROM Contact 
WHERE Id = '001J7000007VpctIAC'

should be replaced in the SOQL field by :

Code Block
languagesql
SELECT Id, FirstName, LastName, Email, Phone, AccountId 
FROM Contact 
WHERE Id = '{attribute_value}'

In this dynamic query, the placeholder {attribute_value} will automatically be replaced by the value of the attribute name you define in the integration.

If you set sf_id in the Attribute Name field, the query executed will become:

Code Block
languagesql
SELECT Id, FirstName, LastName, Email, Phone, AccountId 
FROM Contact 
WHERE Id = 'sf_id'

This should be your final configuration :

...

Info

Now you just need to click save and authenticate with your Salesforce account

How to test the integration ?

In order to test the integration, you need to go to the surveys, choose a survey that matches the segment you created, and simulate the reception of feedback with a Salesforce ID.

...

Take the link and then manually add the attribute (the name of the attribute you pass in the URL should match the one you put in the attribute name field in your integration). So, if the URL is: https://feedback.feedier.pre-prod.alkalab.com/DXoT9Z, you need to enter in your browser: https://feedback.feedier.pre-prod.alkalab.com/DXoT9Z?sf_id=001J7000007VpctIAC.

Complete the survey, and you should receive feedback with one attribute, which is sf_id.

Wait 5 minutes, and the integration should be triggered, and you should see all the attributes you included in your SOQL.

Note

Important Notes

  1. Feedier will only read the first record from the query. So you can order if several records might be matched.

  2. The query must contain "{attribute_value}" as this attribute value will always change and be replaced automatically. It can be an ID or a value for a LIKE query/matching.


Workflow 2: Connect to Salesforce to update a ‘Salesforce Object’ post-feedback

...

Salesforce Label

Data Type

Explanation

CreatedById

Lookup(User)

Mandatory field on Salesforce, will display the user that setup the connector

Name

Text (80)

Mandatory field on Salesforce

FeedierItemFullName

Text (255)

The question name

FeedierItemFeedbackfObjectId FeedierItemFeedbackObjectId

Lookup(FeedierFeedback)

⚠️ The related FeedierFeedback that was created in the integration.

FeedierItemFeedbackId

Text(80)

Feedback ID in Feedier

FeedierItemSurveyName

Text (255)

Survey name in Feedier

FeedierItemType

Text (255)

The type of response, for most use cases this will show as ‘question’

FeedierItemValue

Long Text Area(131072)

The answer value

FeedierItemCreatedAt

Date/Time

The answer creation time

LastModifiedById

Lookup(User)

Mandatory field on Salesforce

OwnerId

Lookup(User,Group)

Mandatory field on Salesforce

...

This workflow is designed to send a feedback email from Feedier immediately after a certain trigger has been met on a Salesforce record.

Setup an email campaign on Feedier as a template for sending emails

Info

Feedier → Survey → Share → Email Campaign

...

Setup the form as follows: 

...

...

Note

If you are using a custom object, you need to create a custom email field to be able to attach the email to the outbound message.

Add the Feedier Campaign ID from the template you just created.

...

  • User to send as: Choose what you like, this has no impact with the connector

  • Case fields to send: Choose all data you want to attach to the feedback in Feedier. ContactEmail is required.

  • Click Save

...

Create the

...

Workflow Rule

Info

Salesforce Setup App Process Automation → Workflow Rules

  • Now, you You now need to trigger the Outbound outgoing message.

  • Create a trigger with your own rules (file status = closed, for example).

  • Attach the outgoing message you have created

...

  • Create a trigger with your own rules (Case status = Closed Escalated for example)

Note

You can create the rule also in the Flow builder

Screenshot 2024-09-25 at 17.32.04.pngImage Added

Attach the outbound message to the workflow rule

Info

Salesforce Setup App → Workflow Rules

  • Now, you need to attach the Outbound message to the workflow rule so when the rule is validated an outbound message will be sent to the Endpoint URL that we set up earlier.

  • Attach the outbound message you created in and you're all set. 

Workflow 4: If you want to pick up push status within salesforce, take a look at this guide

...

  • Screenshot 2024-09-25 at 16.43.30.pngImage AddedScreenshot 2024-09-25 at 16.45.56.pngImage Added

Test the outbound message

Trigger the workflow rule created and you should see a push created on the Pushes page on Feedier.