Prerequisites
Before starting, ensure you have:- Salesforce Edition: Professional, Enterprise, Unlimited, or Developer
- Admin Access: System Administrator permissions in your Salesforce org
- Thnks Account: Active Thnks organization account with Enterprise or Enterprise+ plan level
- Email Matching: User email addresses must match between Thnks and Salesforce accounts
New in v1.8: Users must have matching email addresses between their Thnks and Salesforce accounts to use the “Send Thnks” feature within Salesforce.
5-Step Quick Install
Step 1: Configure Thnks Platform Connection
Contact your Thnks Account Manager or integrations@thnks.com to:- Enable Salesforce integration on your Thnks account
- Choose your connection method:
- User Connection: Each user enables their own Thnks ↔ Salesforce connection
- Org Connection: Single admin-managed connection for all users
Step 2: Install the Salesforce App
- Navigate to the Thnks AppExchange listing
- Click “Get It Now” and select your Salesforce instance
- Choose installation option:
- Install for Admins Only (recommended for initial setup)
- Install for Specific Profiles (configure access levels)
- Complete the installation process
Step 3: Configure Organization Token
Required for Send Thnks Feature: You must obtain an Organization Token from Thnks to enable sending Thnks from within Salesforce.
- Contact your Thnks Account Manager or integrations@thnks.com to get your Organization Token
- In Salesforce, go to App Launcher → search “Thnks” → “Manage Thnks Settings”
- Navigate to the “Send Thnks” tab
- Enter your Organization Token in the “Thnks Organization Token” field
- Configure additional settings:
- Thnks API Endpoint:
https://api.thnks.com/
(default) - Thnks Sending Interface URL:
https://app.thnks.com/#/auto-login
(default) - Enable ‘Send Thnks’ Feature: Check this box
- Default New Requests to Auto-Approve: Check if you want automatic approval (Only applies to Thnks Requests send via Flow automation, not Thnks sent via iframe)
- Thnks API Endpoint:
Step 4: Add Send Thnks Component to Lightning Pages
To enable the “Send a Thnks” button on record pages:- Navigate to Setup → Object Manager
- Select Contact, Account, or Opportunity
- Go to Lightning Record Pages
- Edit the relevant page layout
- In Lightning App Builder:
- Drag the “Send Thnks” component to your desired location
- Configure component settings as needed
- Save and Activate the page
Step 5: Add Thnks Related Lists (Optional)
For better visibility of Thnks activity:- Setup → Object Manager → Select object (Contact, Account, Lead, Opportunity)
- Page Layouts → Select the relevant layout
- Related Lists section → Drag “Thnks” into the layout
- Configure the related list fields and Save
Post-Installation Checklist
1
Verify Installation
- Thnks app appears in App Launcher
- “Manage Thnks Settings” is accessible
- All tabs (Contact Settings, Leads Settings, etc.) are visible
2
Configure Permissions
- Assign “Thnks Admin” permission set to administrators
- Assign “Thnks Standard User” permission set to end users
- Test access levels are working correctly
3
Test Send Thnks Feature
- “Send a Thnks” button appears on configured record pages
- Iframe loads correctly when clicked
- User can authenticate and send test Thnks
- Thnks record is created in Salesforce after sending
Testing Your Installation
Test Direct Sending
- Navigate to a Contact record
- Click “Send a Thnks” button
- Verify the Thnks interface loads in the iframe
- Send a test Thnks to yourself
- Confirm the Thnks record appears in Salesforce
Test Data Synchronization
- Send a Thnks from the Thnks web app or mobile app
- Verify the Thnks record is created in Salesforce
- Check that the record is associated with the correct Contact/Lead
- Confirm status updates as the Thnks progresses
Common Issues & Solutions
Send Thnks button not appearing
Send Thnks button not appearing
Authentication error in iframe
Authentication error in iframe
- Confirm user’s Salesforce email matches their Thnks account email
- Verify user has an active Thnks account
- Check Organization Token is valid and properly configured
Thnks records not syncing
Thnks records not syncing
- Verify Thnks account has Salesforce integration enabled
- Check Contact/Lead matching settings in Manage Thnks Settings
- Confirm user connection is properly established
Next Steps
After successful installation:- Review the Install Guide for detailed configuration options
- Configure automated workflows using Salesforce Flows
- Set up custom field mapping for ROI tracking
- Train users on the new Send Thnks functionality