From 94e2671fe94aec3b073ec182d4b3d34d161a762b Mon Sep 17 00:00:00 2001 From: Sudheer2137 Date: Mon, 23 Jun 2025 15:22:01 +0530 Subject: [PATCH] Lookup Job applications --- .../.codeblocks/block_0.js | 2 ++ .../.codeblocks/{block_0.sh => block_1.sh} | 0 .../README.md | 36 +++++++++++++++---- 3 files changed, 31 insertions(+), 7 deletions(-) create mode 100644 plugins/greenhouse-lookup-job-applications/.codeblocks/block_0.js rename plugins/greenhouse-lookup-job-applications/.codeblocks/{block_0.sh => block_1.sh} (100%) diff --git a/plugins/greenhouse-lookup-job-applications/.codeblocks/block_0.js b/plugins/greenhouse-lookup-job-applications/.codeblocks/block_0.js new file mode 100644 index 00000000..71c339bf --- /dev/null +++ b/plugins/greenhouse-lookup-job-applications/.codeblocks/block_0.js @@ -0,0 +1,2 @@ +curl --request GET \ + --url 'https://boards-api.greenhouse.io/v1/boards/{board_token}/jobs'\ diff --git a/plugins/greenhouse-lookup-job-applications/.codeblocks/block_0.sh b/plugins/greenhouse-lookup-job-applications/.codeblocks/block_1.sh similarity index 100% rename from plugins/greenhouse-lookup-job-applications/.codeblocks/block_0.sh rename to plugins/greenhouse-lookup-job-applications/.codeblocks/block_1.sh diff --git a/plugins/greenhouse-lookup-job-applications/README.md b/plugins/greenhouse-lookup-job-applications/README.md index 1029eb95..a73e17f4 100644 --- a/plugins/greenhouse-lookup-job-applications/README.md +++ b/plugins/greenhouse-lookup-job-applications/README.md @@ -2,7 +2,7 @@ description: A plugin that allows hiring managers or recruiters to retrieve candidate applications for a specific job. difficulty_level: BEGINNER -fidelity: GUIDE +fidelity: TEMPLATE installation_asset_uuid: 1bcce37f-d556-4883-a34f-c66500c4275a installation_link: https://my.moveworks.com/agent-studio/plugin-workspace/plugins?externalAssetId=06f6255e-527d-47b4-9dbd-3d74743e7366 name: Lookup Job Applications @@ -24,29 +24,50 @@ This guide will walk you through the simple installation process in Agent Studio # Prerequisites - Access to Agent Studio -- The **View Open Jobs** plugin built in Creator Studio. It retrieves all open roles within the organization. Refer to the [View Open Jobs](https://developer.moveworks.com/creator-studio/resources/plugin?id=greenhouse-view-open-jobs) guide for setup instructions. # What are we building? ## Agent Design -This [purple chat](https://developer.moveworks.com/creator-studio/developer-tools/purple-chat/?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Fetch+all+job+applications+for+the+Data+Engineer+role%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Searching+Greenhouse+for+job+applications+matching+the+%27Data+Engineer%27+role...%22%2C%22status%22%3A%22pending%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+job+applications+for+the+%3Cstrong%3EData+Engineer%3C%2Fstrong%3E+role%3A%3C%2Fp%3E%22%7D%2C%7B%22richText%22%3A%22%3Col%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ECandidate%3A+Sudheer+Sunkara%3C%2Fb%3E%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3ECurrent+Stage%3A+Application+Review%3C%2Fli%3E%5Cn++++++%3Cli%3ESource%3A+Referral%3C%2Fli%3E%5Cn++++++%3Cli%3E%3Ca+href%3D%5C%22https%3A%2F%2Fexample.com%2Fresume1%5C%22%3EResume%3C%2Fa%3E%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ECandidate%3A+Dasari+Manoj+Kumar%3C%2Fb%3E%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3ECurrent+Stage%3A+Application+Review%3C%2Fli%3E%5Cn++++++%3Cli%3ESource%3A+Referral%3C%2Fli%3E%5Cn++++++%3Cli%3E%3Ca+href%3D%5C%22https%3A%2F%2Fexample.com%2Fresume2%5C%22%3EResume%3C%2Fa%3E%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ECandidate%3A+Pradeep+VR%3C%2Fb%3E%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3ECurrent+Stage%3A+Coding+Review%2FTechnical+Design%3C%2Fli%3E%5Cn++++++%3Cli%3ESource%3A+Referral%3C%2Fli%3E%5Cn++++++%3Cli%3E%3Ca+href%3D%5C%22https%3A%2F%2Fexample.com%2Fresume3%5C%22%3EResume%3C%2Fa%3E%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn%3C%2Fol%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22Data+Engineer+Job%22%2C%22connectorName%22%3A%22greenhouse%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D) shows the experience we are going to build. +This [purple chat](https://developer.moveworks.com/creator-studio/developer-tools/purple-chat/?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Fetch+all+job+applications+for+the+Data+Engineer+role%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EHere+are+the+job+applications+for+the+%3Cstrong%3EData+Engineer%3C%2Fstrong%3E+role%3A%3C%2Fp%3E%22%7D%2C%7B%22richText%22%3A%22%3Col%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ECandidate%3A+Sudheer+Sunkara%3C%2Fb%3E%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3ECurrent+Stage%3A+Application+Review%3C%2Fli%3E%5Cn++++++%3Cli%3ESource%3A+Referral%3C%2Fli%3E%5Cn++++++%3Cli%3E%3Ca+href%3D%5C%22https%3A%2F%2Fexample.com%2Fresume1%5C%22%3EResume%3C%2Fa%3E%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ECandidate%3A+Dasari+Manoj+Kumar%3C%2Fb%3E%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3ECurrent+Stage%3A+Application+Review%3C%2Fli%3E%5Cn++++++%3Cli%3ESource%3A+Referral%3C%2Fli%3E%5Cn++++++%3Cli%3E%3Ca+href%3D%5C%22https%3A%2F%2Fexample.com%2Fresume2%5C%22%3EResume%3C%2Fa%3E%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ECandidate%3A+Pradeep+VR%3C%2Fb%3E%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3ECurrent+Stage%3A+Coding+Review%2FTechnical+Design%3C%2Fli%3E%5Cn++++++%3Cli%3ESource%3A+Referral%3C%2Fli%3E%5Cn++++++%3Cli%3E%3Ca+href%3D%5C%22https%3A%2F%2Fexample.com%2Fresume3%5C%22%3EResume%3C%2Fa%3E%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn%3C%2Fol%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D) shows the experience we are going to build. # Installation Steps We recommend creating the connector for Greenhouse first, prior to installing this plugin. Please follow the [Greenhouse Connector](https://developer.moveworks.com/creator-studio/resources/connector?id=greenhouse) guide to create the connector. -After you have configured the connector, please refer to our [plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace) for more information on how to install a plugin. +After you have configured the connector, please refer to our [plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace-installation) for more information on how to install a plugin. Note: Make sure only hiring managers, recruiters or HR team members can use this plugin to fetch candidate applications. In the plugin settings, choose "Launch to selected users" and add their email addresses. This keeps the "Lookup Job Applications" feature secure and only available to the right people. Check the Launch Rules [guide](https://help.moveworks.com/docs/launch-configuration) for help. # Customization Options -Some slot descriptions reference the **View Open Jobs** plugin. Please update them only if this plugin was referred to by a different name. +We need the **board_token** as part of the API endpoint to fetch open jobs. Please follow these steps to find the board_token in Greenhouse: + +- Go to Greenhouse **Settings** + - Log in to your Greenhouse account. + - Click on **Configure (⚙️)** → **Job Boards & Posts**. +- Open Job Board Settings + - Find your job board under **Job Boards**. + - Click on the **Board Name** to open its setting +- Locate the **board_token** + - In the Board Settings section, find the URL field. + - The last part of the URL is the **board_token** +- Use the board_token in the API Request + - Once you have the **board_token**, use it in the Greenhouse Job Board API to fetch open jobs. + - Replace **{board_token}** with the value found in previous step. # Appendix -### API #1: Fetch Job Applications +### **API #1: List Jobs** + +The [**List Jobs**](https://developers.greenhouse.io/job-board.html#list-jobs) endpoint allows you to retrieve a list of all currently open job roles within the company. Job board data is publicly available, so authentication is not required for any GET endpoints. + +```jsx +curl --request GET \ + --url 'https://boards-api.greenhouse.io/v1/boards/{board_token}/jobs'\ +``` + +### API #2: Fetch Job Applications The [List Candidates](https://developers.greenhouse.io/harvest.html?shell#get-list-candidates) API in Greenhouse allows you to retrieve candidate applications for a specific job. The API will be queried using the `job_id` parameter to filter applications. Additionally, we’ll use the `fields` parameter to limit the API response to relevant details, ensuring efficient data retrieval. @@ -58,4 +79,5 @@ curl 'https://harvest.greenhouse.io/v1/candidates?job_id={{internal_job_id}}&upd **Query Parameters :** - Key ( **job_id** ) : Value ( **{{internal_job_id}}** ) -- Key ( **updated_after** ) : Value ( **{{updated_after}}** ) \ No newline at end of file +- Key ( **updated_after** ) : Value ( **{{updated_after}}** ) + - This value is dynamically derived through LLM logic to always fetch applications that have been updated in the last 14 days relative to the date when the user triggers the query. \ No newline at end of file