Configure Flow for Slack
UKG Flow allows you to punch The entries on a timecard that mark the beginning (in-punch) or end (out-punch) of a work interval, such as the beginning of a shift or transfer., submit requests, and view schedules in Slack™ without the need to switch applications.
-
Gather the following tenant details and credentials:
- Vanity URL (basic vanity URL or SSO URL)
- Client ID
- Client Secret
-
Search for and download the UKG Flow app from the Slack marketplace.
-
Configure the system setting as follows:
- Click Tap Main Menu
> Administration > Application Setup > System Configuration > System Settings > Global Values tab. - Define the Flow Service callback URL. In global.oAuth.authCode.redirection.uris, add https://useast1-gateway.ukg.net/flex/flow/callback to the list of URLs. Separate this URL by a comma from any other URLs in the list.
- Click Tap Save.
- Click Tap Main Menu
-
Configure the FAP as follows:
- Click Tap Main Menu
> Administration > Application Setup > Access Profiles > Function Access Profiles. - Select the profile. Click Tap Edit.
- (Optional) Enter a Description.
- From Function, select APIs and do the following:
- To support attested punches, in Initiate Business Processes An organized flow of activities or tasks that achieves a business goal. An automated business process minimizes the amount of paperwork and manual tasks to complete that process by way of automatic actions, online forms, and automatically generated messages. API, select Allowed in Access Scope.
- Select Rest API. In Current User Information API, select Allowed in Access Scope.
- Click Tap Save & Return.
- Repeat for other people's FAPs.
- Click Tap Main Menu
UKG Flow supports notifications for the following request subtypes Classifications of schedule requests from employees.:
- Time off requests
- Notification to the manager when an employee submits a time off request
- Notification to the employee when the manager approves or rejects a time off request
- Shift swap requests Employees can exchange their scheduled shift with a shift scheduled for another qualified employee.
- Notification to the recipient when a requestor submits a shift swap request
- Notification to the requestor when a recipient approves or rejects a shift swap request
These notifications go to the Home page The page that is presented to the user upon login, which contains the tiles that let the user access or navigate to common tasks. and to the UKG Flow chat window.
Note: To receive the notifications, the recipients must have the UKG Flow application installed and registered.
Configure notifications for the request subtypes
- Click Tap Main Menu
> Administration > Application Setup > Employee Self Service > Request Subtypes. - Select the time off or shift swap request subtype.
- Select the following:
- For time off requests:
- For Employee Pending Notification, select Request Status Change—Employee.
- For Manager Notification, select Submission Notification—Manager.
- For shift swap requests:
- For Employee (Requester) Notification, select Shift Swap Request for Requester.
- For Employee (Recipient) Notification, select Shift Swap Request for Recipient.
Note: Manager notification is not needed for auto-approved shift swap requests.
- For time off requests:
- Click Tap Save.
- Repeat for another request subtype.
Connect the workflow notifications to Flex Flow services
- Click Tap Main Menu
> Administration > Application Setup > Event/Notification > Workflow Notifications Informs people to run business processes or integrations, complete forms, or respond to events in business processes. Example: Approve a time-off request.. - Select a workflow notification for the request subtype. Click Tap Edit.
Workflow names are not standardized and can be named as needed. Example workflow names for the request subtypes include the following:
- Request Status Change Employee
- Submission Notification Manager
- Shift Swap Request for Requester
- Shift Swap Request for Recipient
- Select Trigger Business Process.
- In Template, select the most recent version of the Flex Flow Service Notification template.
- In Business Process will run as, select System User so that the notification is sent from the system account.
- Click Tap Save.
- Repeat for another workflow notification.
- Log in to the Slack app directory.
- Search for and select the UKG Flow app and click tap Add to Slack.
- On the Slack landing page, click tap Add to Slack.
- In the upper right corner of the permissions page:
- Select the workspace to configure and use Flow.
- Click Tap Allow.
- In This site is trying to open Slack, click tap Open.
- Register the tenant as follows:
- In the app chat box, enter update registration.
- Click Tap Register Tenant.
Note: If you need to re-register the tenant such as with a new URL — for example to change the vanity URL to move from UAT to Production — enter update registration and complete the registration process with the updated details.
- Enter the following credentials for the tenant:
- Vanity URL
- Client Id
- Client Secret
Note: To confirm that the entries are correct, you can click tap Show Credentials.
- Click Tap Register Tenant.
- To finish the registration, the UKGPro Workforce Management or Pro Suite login page opens. Do the following:
- Enter your Username and Password.
- Click Tap Log In.
- Enter a slash (/) in the chat box and select one of the following commands:
- /ukg/login — Log in.
- /ukg/help — View definitions of the available commands.
- /ukg/update_registration — Update registration details.
- /ukg/punch — Submit and view punches.
- Close the browser.
- Open the UKG Flow app.
- Before you select a command, enter Login. Otherwise, you are prompted to log in each time that you select a command.
- Enter your Username and Password.
- Click Tap Log In.
Note: The log-in is valid for 7 days. During this time, you do not need to log in each time you access the commands.
- Click Tap or enter the command for each of the following:
- Punch — Check that the Punch and View Punches buttons are shown, and that you can clock in or clock out. The available options vary depending on the attestation The act of confirming or attesting that something is true. For example, when punching out, users may need to attest that they took their meal breaks. profile.
- Time Off — Check that the Time Off and Time Off Status buttons are shown, and that you can submit a request.
- My Schedule — Check that your schedule is shown.
- Help — Check that definitions of the commands are shown.