Summary

PeopleFluent Recruiting can now integrate with Broadbean.  Broadbean allows recruiters to simultaneously post job advertisements to over 7,000 job boards in 100 countries, plus search engines and social media channels. You can multi-post to your site, job boards, search engines, and Indeed.

Use of this integration in PeopleFluent Recruiting requires your organization to be registered with Broadbean.  Broadbean will provide you with a Client ID and Client Secret, which are used to set up the integration on the Company level.  PeopleFluent users who will access the integration need to be registered as users with Broadbean and will be provided with a Broadbean username.

Configuration

Broadbean must first be enabled on the company level, and then for each user. You will need to have the Broadbean-provided Client Id and Client Secret to enable the integration. Please have these items handy. Note: Disabling Broadbean at the company level disables it for all of the company's users. 

Enabling the Broadbean Integration on the Company Level

The Broadbean integration can be configured on the company level by a Company Administrator.

1. Click the gear icon ⚙️ in the left sidebar.
2. Hover over Recruiting Preferences.
3. Click Integrations.
4. Scroll to the Job Boards section and locate the Broadbean tile.
5. Click the settings icon ⚙️.
6. Enter the Client Id and Client Secret in the appropriate fields.

7. Click Save Changes and the Broadbean integration is enabled for the company.

Enabling the Broadbean Integration on the User Level

The Broadbean integration can be enabled on the user level by a Company Administrator or by users who can access and configure their own user profiles.  You will need the user's Broadbean username.  Please have it handy.

1. Click the gear icon ⚙️  in the left sidebar.
2. Click User Settings. The Broadbean tile will display in the General Integrations section.
3. Click Enabled to open the settings.
4. Enter the Broadbean username in the Username field.

5. Click Save Changes. Broadbean integration is now enabled for the user.

Advertising a Position via Broadbean

1. Go to the Advertise page for a position. The Broadbean integration is shown in the Premium Advertising section.

2. Click Enabled and then click Save Changes. The Broadbean advertising page opens in a new window.

3. On the Choose Job Boards screen, select the job boards to which you are posting the position and click Continue.
4. On the Advert Details screen, fill in the job advert details.  Some key information from your job posting is pulled through from PF Recruiting to Broadbean and will be pre-populated in the details.  These fields include:

• Position Title
• Position Reference ID (if in use).
• Position Location - For USA locations, Country, State and City must be populated to be passed through to Broadbean.  For non-USA countries, location will be passed through as long as Country is populated.
• Position Type -  Full Time, Part Time, Contract, etc.
• Position Description - The position description that is passed through is fully editable.  Cut and paste, HTML formatting and spell check options are available.  HTML will only be displayed on channels that support it, otherwise plain text will be sent. Please note that any edits made in Broadbean will not update the job description in PeopleFluent Recruiting.

The images below highlight the information that is passed from PF Recruiting to Broadbean. 

5. Update and/or complete the advert details as necessary.  When you are ready to move to the next step, click Continue.
6. On the Preview+ Send screen review the details.

• If there are any required fields that are empty, those fields will be presented in red text.

• In some cases, information that you entered in the previous step will generate additional fields.  When that is the case, those fields are highlighted in red on the preview screen.  
• You are not able to make amendments on the preview screen.  Click Go Back to return to the previous screen to make any updates.

7. For some boards, the Destinations & Advertisements Periods field will display.  When this is the case, you will be able to select an option to choose how long the advert will live in the external channels.  Some boards choose to handle this on their end and, in that case, this field is not available.

8. When you have completed the advert details, click Send Advert. The page updates with a confirmation message.

Once a job posting is enabled, the Broadbean integration in the Premium Advertising section will display a status message.  This message will update automatically based on the status in Broadbean (Delivered, Expired, etc.)

Viewing the Advertisement

You have the ability to view the job posting in Broadbean after it has been enabled. You will be able to see the boards to which the advert is posted, how much time is left for the advert on each board and renew, if necessary.  You can also make edits to the posting. 

1. Go to the Advertise page for a position and locate the Broadbean integration in the Premium Advertising section.  You will notice that a new icon is displayed to the left of the Enabled button.  Click on this icon.

2. You are taken to the Advert dashboard in Broadbean.  Please refer to Broadbean help documentation for information about making edits to the job posting.

Identifying Broadbean Candidates in the Application

When a candidate applies to a job via Broadbean, this information displays in the Details section of the Candidates profile.  

Summary

Candidates that are created in PeopleFluent Recruiting will now have a system-generated Candidate Reference ID.  This ID will be a numeric value that is incremented by one every time a new candidate is created.  Note that if a newly crated candidate has the same email as a candidate already in the system, then the existing Candidate Referenced ID will be associated with the new candidate record.  The ID can be displayed as a column in the Candidate tables and you can search and filter candidate records using the new ID.

Summary

The public/api/v3/company/{companyId}/positions endpoint now supports pagination and sorting, using the following parameters:

• page
• page_size
• sort_field: creation_date/name (default: creation_date)
• sort_direction: ascending/descending (default: descending)

See API Documentation for additional details.

Summary

You can now easily retrieve and update the Position posting status (Enabled, Internal Only, Unlisted, Disabled) via the API.  This can be done on an individual position or in bulk for multiple positions.  In the API, the posting status is referred to as the "candidate_type" and can have a value of "all" (for Enabled), "none" (for Disabled), "unlisted" or "internal".

See API Documentation for additional details.