YM Careers Nimble Fuse Integration

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:

Directions

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

1. 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

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

3. Create the integration:

   1. 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

   2. 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.

   3. 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).

   4. 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