Using the BambooHR Templates

​

Supported Actions

​

Create an Employee

1. Install the template from BambooHR Templates.
2. The Create an Employee dialog task is added with:
   • createEmployee – User intent to create an employee.
   • companyDomain, firstName, lastName – Entity nodes for employee details.
   • createEmployeeService – Bot action service to create the employee. Click Edit Request: Sample Request:
     {
       "firstName": "Alen",
       "lastName": "walker"
     }
     
   • createEmployeeMessage – Message node to display the result.
3. Click Train, then Talk to Bot to test.
4. Follow the prompts to create an employee.
5. Click View Employee to view employee details in BambooHR.

​

Get Employee by ID

1. Install the template from BambooHR Templates.
2. The Get Employee by ID dialog task is added with:
   • getEmployeeByID – User intent to find an employee by ID.
   • companyDomain and id – Entity nodes for employee details.
   • getEmployeeByIdService – Bot action service to fetch the employee. Click Edit Request: Sample Request:
     {
       "id": "114",
       "firstName": "Alen",
       "lastName": "walker"
     }
     
   • getEmployeeMessage – Message node to display the result.
3. Click Train, then Talk to Bot to test.
4. Follow the prompts to find the employee.
5. Click View Employee to view details in BambooHR.

​

List All Employees

1. Install the template from BambooHR Templates.
2. The List All Employees dialog task is added with:
   • listAllEmployees – User intent to list employees.
   • companyDomain – Entity node for the company domain.
   • listAllEmployeesService – Bot action service to fetch all employees. Click Edit Request: Sample Request:
     {
       "fields": ["firstName", "lastName"]
     }
     
     Sample Response:
     {
       "title": "Report",
       "fields": [
         { "id": "firstName", "type": "text", "name": "First Name" },
         { "id": "lastName", "type": "text", "name": "Last Name" }
       ],
       "employees": [
         { "id": "112", "firstName": "John", "lastName": "Smith" },
         { "id": "113", "firstName": "Harry", "lastName": "Anthony" },
         { "id": "114", "firstName": "Alen", "lastName": "walker" }
       ]
     }
     
   • listAllEmployeesMessage – Message node to display results.
3. Click Talk to Bot to test.
4. Follow the prompts to view employees.

​

Update an Employee

1. Install the template from BambooHR Templates.
2. The Update an Employee dialog task is added with:
   • updateEmployee – User intent to update an employee.
   • companyDomain, id, chooseField, firstName, lastName – Entity nodes.
   • updateEmployeeScript – Bot action script to prepare the update.
   • updateEmployeeService – Bot action service to update the employee. Click Edit Request: Sample Request:
     {
       "firstName": "Alen",
       "lastName": "walker"
     }
     
   • getEmployeeByIdService – Bot action service to fetch the updated employee by ID.
   • updateEmployeeMessage – Message node to display the result.
3. Click Talk to Bot to test.
4. Follow the prompts to update the employee.
5. Click View Employee to view details in BambooHR.

​

Get All Time Off Requests

1. Install the template from BambooHR Templates.
2. The Get All Time Off Requests dialog task is added with:
   • getTimeoffRequests – User intent to get time off requests.
   • companyDomain, startDate, endDate – Entity nodes for the request range.
   • getTimeoffRequestsService – Bot action service to fetch time off requests. Click Edit Request: Sample Response:
     [
       {
         "id": "1649",
         "employeeId": "112",
         "status": { "lastChanged": "2022-12-22", "status": "approved" },
         "name": "Mark Anderson",
         "start": "2022-12-14",
         "end": "2022-12-15",
         "type": { "id": "83", "name": "Vacation" },
         "amount": { "unit": "hours", "amount": "16" }
       }
     ]
     
   • getTimeoffRequestsMessage – Message node to display results.
3. Click Talk to Bot to test.
4. Follow the prompts.

​

Get a List of Who is Out

1. Install the template from BambooHR Templates.
2. The Get a List of Who Is Out dialog task is added with:
   • getListWhoisOut – User intent to list who is out.
   • companyDomain – Entity node for the company domain.
   • getListWhoOutService – Bot action service to get the list. Click Edit Request:
   • getListWhoIsOutMessage – Message node to display results.
3. Click Talk to Bot to test.
4. Follow the prompts.

​

Update a Request Status

1. Install the template from BambooHR Templates.
2. The Update a Request Status dialog task is added with:
   • updateRequestStatus – User intent to update a request.
   • companyDomain, requestID, requestStatus – Entity nodes.
   • updateRequestStatusScript – Bot action script to prepare the update.
   • updateRequestStatusService – Bot action service to update the request. Click Edit Request: Sample Request:
     {
       "status": "approved",
       "note": "Have fun!"
     }
     
   • updateRequestStatusMessage – Message node to display the result.
3. Click Talk to Bot to test.
4. Follow the prompts.