YM Careers Nimble Fuse Integration | Nimble AMS Help Preview

If your association uses YM Careers, you may want to automatically create and update leads for the individuals and companies viewing your job board. This recipe sets up a Nimble Fuse integration with YM Careers which automatically creates new leads and updates existing leads every Sunday at 7 AM.

Recipe Prep

Before completing this recipe, you first need to:

Have YM Career Center Solutions Integration installed.
Have Nimble Fuse installed.

To make this recipe, you should understand:

How Map Custom Lead Fields for Data Conversion (external)
How to Edit Page Layouts for Custom and External Objects (external)

Ingredients

You will create the following ingredients in your org to make this recipe:

Name	Type	Description
YMCareers	Integration Setting	An inbound integration for YM Careers which creates lead records.
[multiple]	Integration parameters
[no name]	Integration Callout Worker	A callout worker that reaches out to YM Careers for new lead information on a weekly basis.
[no name]	Integration Response Worker	A response worker that updates existing leads and creates new leads on a weekly basis.

Directions

Add new fields to the Lead record page and create an integration setting for the integration

For the Lead object, add the following fields (external) to the Lead Layout page layout:

Field
`Allow Contact`
`Career Id`
`Extension`
`Has Applied Jobs`
`Has Company Profile`
`Has Contact Resume`
`Has Job Alerts`
`Has Job Posting`
`Has Resume Subscription`
`Is Member`
`Joined Date`
`Last Login`
`Member Number`
`Posted Resume`
`Primary Affiliation`
`Site Name`
`User Type`

Map the Primary Affiliation lead field to the Primary Affiliation Account field.

Create the integration:

Create a new callout integration setting with the following values:

Field	Value
`Name`	`YMCareers`
`Description`	`An inbound integration for YM Careers which creates and updates leads.`
`Authentication Key`	[unique 256-bit WEP authentication key]
`Class`	`NUINT_YMC.GetNonMemberList`
`Logging Level`	`INFO`

Create the following integration parameters:

Key	Value	Description
`AuthEndpointUrl`	`http://api-stg.careerwebsite.com/v1/api/api-access-token`	The YM Careers endpoint URL
`AuthPassword`	[your YM Careers account password]	The YM Careers password
`AuthUsername`	[your YM Careers account username]	The YM Careers username
`DebugMode`	`false`	Enable this and use it in conjunction with `NonMemberListDebugEndDate` and `NonMemberListDebugStartDate` to perform debug tests on the integration.
`NonMemberListDebugEndDate`	[blank]	When `DebugMode` is enabled, to debug the integration for an exact date range, enter the end date. Example: 2018-09-25 00:00:00
`NonMemberListDebugStartDate`	[blank]	When `DebugMode` is enabled, if you want to debug the integration for an exact date range, enter the start date. Example: 2018-09-17 00:00:00
`NonMemberListEndpointUrl`	`http://api-stg.careerwebsite.com/v1/lead-generation/non-member-list`	The YM Careers URL which returns the full list of leads.
`NonMemberListNumberOfDays`	`7`	The number of days worth of leads to request from YM Careers. This must align with the same number of days defined in the schedules used for the callout and response workers to ensure no duplicates are mistakenly created.
`NonMemberListPartnerId`	[your YM Careers partner ID]	Your YM Careers partner ID
`NonMemberListUserType`	`candidate\|recruiter`	Defines the types of users to return from YM Careers.

Create an integration callout worker with the following values so it requests new leads every Sunday at 7AM of the time zone set on your org:

Field	Value
`Worker Schedule`	`0 0 7 * * 1`
`Worker Active`	`Selected`

Learn how to write a different schedule (external).

Create an integration response worker with the following values so it retrieves new leads a few minutes after the request:

Field	Value
`Worker Schedule`	`0 2 7 * * 1`
`Worker Batch Size`	10
`Worker Active`	Selected