Package Setup
Firstly, it is necessary to install the LogicMelon package into the client's org - contact the Seven20 Product team to obtain the link for the latest package version. Seven20's LogicMelon package is dependent on the following core product packages:
- Seven20 - Utilities
- Seven20 - Core
- Seven20 - Parse and Match
- Seven20 - Integration Utilities
User Setup
A packaged permission named Logic Melon (Logic_Melon) is included - this must be assigned to any Users who will be using the integration.
User email addresses in Seven20 must match the email address related to their LogicMelon user account.
Credential Configuration
Configure the following Seven20 Configuration Settings metadata records as per below:
| Metadata Record Api Name | Value |
|---|---|
| Logic_Melon_Api_Key | To be provided by the client or LogicMelon |
| Logic_Melon_Endpoint | UK: https://www.logicmelon.com/Entry/AdCourierAPIXML/SevenTwenty (packaged default) USA: http://app.usa.logicmelon.com/Entry/AdCourierAPIXML/SevenTwenty |
| Logic_Melon_Secret | To be provided by the client or Logic Melon and often referred to as ‘Accounts master password’ |
When changing the value of the LogicMelon Endpoint away from the default (to US or otherwise), it will also be necessary to create a new remote site and trusted URL for the new endpoint value.
iFrame Setup
A packaged iFrame component named Logic Melon Iframe (Logic_Melon_Iframe) can be added to any Job (seven20__Job__c) lightning record page as required.
Webhook Setup
- In Salesforce setup, create a site
- Assign the below permissions to the Site:
| Permission Type | Name | Value |
|---|---|---|
| Apex Class | seven20.LogicMelonWebhook | Enabled |
| Custom Metadata Types | seven20.Trigger Action | Enabled |
| Object | Account | Read, Create |
A delivery URL based on this site needs to be provided to LogicMelon. To obtain this, copy the URL of the site and append the following: /services/apexrest/seven20/logic-melon/candidate/push
Configuration Options
Various configuration options are available to change the behaviour of the integration, these are controlled by Seven20 Configuration Metadata records:
| Configuration Name | Details |
|---|---|
| Add Candidates straight to ATS | If active, applications received from LogicMelon will be created as seven20__Application__c records; if inactive, seven20__Job_Board_Application__c records. Default is inactive. |
| Job Board Reference Field | Defines what field should be mapped as the reference when posting Jobs, the default value is seven20__Job_Board_Reference__c. See here for details. |