Bob HR

Feature

Description

Configuring Functions

You can use our Bob connector to push data to Bob. Here are the instructions to configure a post function that executes such an integration.

1. Go to the Workflow of choice from Project Settings

2. Select the transition you wish to add the post function to

3. Click Post Function→Add Post Function.

4. Select the OnLink Post Function option then Add.

5. Select Bob in the system field (Bob connection needs to be established first), Then select Add or Terminate employee as the function.

6. In the Input Field Mapping, map the relevant custom fields to each of the required fields as shown below. Ensure these custom fields are added to the issue screen from which the post function is being called.

Open

Add Employee Field Mapping

Find the API field you want to add. The list of API fields can be retrieved by calling https://apidocs.hibob.com/reference/get_company-people-fields API from Bob's documentation.

For example, let's say you want to set "Employment type" field. The above API returns below snippet.

{
"id": "payroll.employment.type",
"category": "employment",
"name": "Employment type",
"description": null,
"jsonPath": "payroll.employment.type",
"type": "list",
"typeData": {
"listId": "payrollEmploymentType"
},
"historical": true
}

The jsonPath value "payroll.employment.type" should then be used in the mapping config e.g. map:payroll.employment.type=customfield_10065

Similarly, you can add additional fields. Here's an example mapping:

map:displayName=customfield_10065
map:address.fullAddress=customfield_10066
map:work.title=customfield_10067
map:payroll.employment.type=customfield_10068
map:payroll.employment.activeEffectiveDate=customfield_10069
map:work.custom.field_1671035736351=customfield_10064

Inbound Webhooks

Follow instructions in our Webhook documentation to get started with creating a Webhook for Bob. Here is a quick loom video on the configuration steps
https://www.loom.com/share/add39dc765d44559acf8ac356079ac5d
Here are the config elements you will need to set:

config:auth_scheme=request_signing_bob
config:signature_token=<Token from Bob HR https://apidocs.hibob.com/reference/getting-started-1>
When you setup the first time set

config:skip_auth=true

This will allow to create the webhook on the Hi Bob and once its created. Use the Secret key for the
config:signature_token=<Token from Bob HR

and remove config:skip_auth=true

To map fields, use format like below. You can include all fields that are listed here - Webhooks (Global). The singature_token should be set to the secret signature from Bob UI. From their docs: “Requests from Bob to your system will be signed, and the secret signature can be grabbed from the Bob UI as part of the Webhook configuration.”