Let's get started
Many organizations maintain their client information in a CRM such as Salesforce. One of the big benefits of using Quik! is the ability to automatically prefill your CRM data on a form. This means you don't have to manually type information that you already know, and you can use that saved time to focus on what really matters. Connect your Salesforce CRM account to Quik! for a seamless flow of data from your CRM database directly onto the forms you launch.
Note: To use our Salesforce integration with Quik!, you must store your client data as Person Accounts in Salesforce, rather than Contacts. Person Accounts are intended for B2C organizations and are more often used in financial services than Contacts.
By default, Person Accounts are available in the Financial Services Cloud version of Salesforce. If you do not have the Financial Services Cloud, you may visit this link Person accounts information to learn more about enabling Person Accounts.
We hope to offer the option to use Salesforce Contacts in the future.
How To
Before you start:
- Make sure you have access to your Salesforce Admin account credentials, as well as the email inbox associated with your Salesforce Admin account.
- Log into your Salesforce account with Admin credentials
- In Salesforce, go to Setup
- Navigate to Platform Tools > Apps > App Manager (Try using the Quick Find search bar!)
- Within the App Manager, click the New Connected App button
- Enter a Connected App Name (whatever you want) and Contact Email (your email)
- Check the Enable OAuth Settings checkbox
- In the Callback URL field, enter this value: https://quikformsapp.com/sf
- In Selected OAuth Scopes, click the Add arrow to add all items to the Selected OAuth Scopes box
- Scroll to the bottom and click Save
- Navigate to Platform Tools > Apps > App Manager (Try using the Quick Find search bar!)
- Choose 'View' on the newly created Connected App's drop-down menu on the far right
- Under the API (Enable OAuth Settings) section, find the Consumer Key and Secret (click on 'Manage Consumer Details'). You will need these values in the following steps.
To connect in the Quik! App:
- Click on the CRMs icon on your Dashboard. From there, click on Add New Connection. Then choose Salesforce.
- Add a CONNECTION NAME. Since Quik! supports the ability to connect to multiple CRM accounts, you will need to give each a descriptive name so that you know which is which. For example, "John Doe's SalesForce Account".
- Enter your Salesforce Consumer Key into the CLIENT ID field.
- Enter your Salesforce Consumer Secret into the CLIENT SECRET field.
- Enter your Salesforce domain into the BASE URL field (by default, the domain will be https://login.salesforce.com unless your organization uses a custom Salesforce domain).
- CONNECTION VISIBILITY: Select from the dropdown if you would like your CRM connection to be Public (Available To All Users) or Private (Available Only To You)
- Click the ADD button
- A Salesforce login window should pop-up. In this window, either enter your Salesforce Admin credentials or click Allow Access. If credentials were entered, Salesforce will send a verification code to the email associated with the Salesforce Admin account. Open the email to find the verification code, enter the code, and finish the login process.
- The window will close automatically, and you will see the Salesforce connection has been added to your Quik! Account. You will also see a second "ConnectedApp" connection listed there. This second connection is a requirement in Salesforce and is only visible to Admins. If you wish to delete your Salesforce connection at any time, you must remove both connections.
All active connections listed in the CRM & Data Sources block can be edited with the EDIT icon and deleted with the x icon. Once added, connections can be selected on the ADD PEOPLE page to prefill your forms. See How to Add People for more details.
IMPORTANT TROUBLESHOOTING TIPS:
- Depending on your Salesforce account settings, your connection may expire in a set amount of time (e.g., 30 days). If this happens, you will see an error message on the Add People page. When you see the error, Quik! recommends removing the connection and then re-adding it as this will refresh the connection to make it usable again.
- If your organization uses a custom Salesforce login screen, this must be disabled when setting up the connection. You must use the default Salesforce login screen when setting up the connection.
- When setting up your integration in the Quik! App, if the Salesforce login window quickly pops up and then disappears, please ensure that you have PKCE disabled in Salesforce under your Connected Apps. To check for this, follow these steps:
- In Salesforce, navigate to Setup > Apps > App Manager > Edit
- Scroll down to the API (Enable OAuth Settings) section
- Uncheck this check box: "Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows"
-
- Save and then try to add the connection again in the Quik! App.