UKG Flow for Google Chat

How to configure UKG Flow for Google Chat

UKG Flow for Google Chat Overview

UKG Flow enables access to the following functions in the Google Chat™ collaboration tool without the need to switch applications:

  • View and submit punches
    • Simple and attestation-based punches
    • Punch history
  • View the current accruals balance
  • Request time off and view the status of requests
  • View daily and weekly schedules
    • Swap recommended shifts

Configure UKG Flow in UKG Pro WFM

  1. Gather the following tenant details and credentials:

    • Vanity URL (basic vanity URL or SSO URL)
    • Client ID
    • Client Secret
  2. Search for and download the UKG Flow app from the appropriate marketplace.

  3. Log in to UKG Pro WFM with an administrator account.

  4. Configure the system setting as follows:
    a. Click Main Menu > Administration > Application Setup > System Configuration > System Settings > Global Values tab.
    b. 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.
    c. Click Save.

  5. Configure the FAP as follows:
    a. Click Main Menu > Administration > Application Setup > Access Profiles > Function Access Profiles.
    b. Select the profile. Click Edit.
    c. (Optional) Enter a Description.
    d. From Function, select APIs and do the following:

    • To support attested punches, in Initiate Business Processes API, select Allowed in Access Scope.
    • Select Rest API. In Current User Information API, select Allowed in Access Scope.
      e. Click Save & Return.
      f. Repeat for other people's FAPs.

Integrate UKG Flow with Google Chat

  1. Log in to the Google Chat workspace marketplace.
  2. Search for and select the UKG Flow app and click Install.
    • Note: Do not select Add to Space because UKG Flow does not support the chat space.
  3. In the permissions page:
    a. Read the terms of service and privacy policy.
    b. Click Continue.
  4. Select the email address that is associated with Google Chat and click Continue.
  5. Select the email ID to use, and click Done.
  6. Confirm that the UKG Flow app appears in direct messages in the left navigation bar.
  7. Click the chat box and do the following:
    a. In the app chat box, enter update registration.
    b. Click Register Tenant.
  8. Enter the following credentials for the tenant:
    • Vanity URL
    • Client ID
    • Client Secret
    • Note: To confirm that the entries are correct, you can click Show Credentials.
  9. Click Register Tenant.
  10. To finish the registration, the UKG Pro Workforce Management or Pro Suite login page opens. Do the following:
    a. Enter your Username and Password.
    b. Click Log In.
    c. When registration is successful, close the browser.

Test the UKG Flow integration with Google Chat

  1. Open the UKG Flow app.
  2. Enter login or user/login and click Login.
    a. Enter your Username and Password.
    b. Click 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.
  3. Click 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 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.

Alternatively, you can enter a slash (/) in the chat box and select one of the following commands:

  • /login — Log in.
  • /punch — Submit and view punches.
  • /time-off — View accrual balances and time-off options.
  • /my-schedule — View your schedule for today and next week.
  • /help — View definitions of the available commands.