Integrating with Messaging Channels

UnO AI Pilot can be integrated with various messaging channels such as Slack, Teams, and Google Chat.

Integration with Slack and Teams

To integrate UnO AI Pilot with Slack and Teams  messaging tools, you must run the following steps:

  1. Install UnO AI Pilot on a machine having a public internet connection.

  2. Provide the required Slack and Teams parameters in the <values.yaml> configuration file.

  3. Ensure that the email id that you set in UnO OIDC provider has right privileges and matches the email id you set on Slack and Teams.

  4. Run some configuration steps for the messaging tools:

For Slack:

  1. Define UnO AI Pilot app on Slack by following the instructions contained in the Slack documentation.

  2. In addition to the settings listed in the Slack documentation, set the following parameters:

    Additional bot events:

    app_home_opened

    Additional scopes:

    users.profile:read

    users:read.email

    Interactivity & Shortcuts -> Request URL:

    https://<UnO_host>/webhooks/slack_auth/webhook

    Event Subscriptions -> Request URL:

    https://<UnO_host>/webhooks/slack_auth/webhook

  3. On Slack, go to General Information -> Display Information and set the fields as indicated in the App settings table below.

  4. In addition to this, go to App settings ->App Home select the checkbox Allow users to send Slash commands and messages from the messages tab.

For Teams

  1. Register UnO AI Pilot's bot with Azure by following the instructions contained in the Azure documentation.

  2. Define UnO AI Pilot app on Teams. A tutorial video for this step is also available.

  3. On Teams, set the parameter Configuration -> Messaging endpoint: https:///<UnO_host>/webhooks/botframework_auth/webhook.

  4. On Teams, go to App Details -> Descriptions to set the name, and the short and long descriptions for the app, as indicated in the App settings table below.

  5. Go to App Details -> Branding to set the app icon as indicated in the App settings table below.

Table 1.
App Settings
App Name UnO AI Pilot
Short description Your automation Virtual Assistance
Long description UnO AI Pilot is an Intelligent Virtual Assistant designed to improve the HCL Universal Orchestrator (UnO) customer experience through Natural Language Processing (NLP) interactions, enabling personalized self-service automation with instant, round-the-clock responses. As the product expert, HCL Universal Orchestrator (UnO) allows users to explore product capabilities, perform routine tasks, and receive troubleshooting support.
App icon for Teams
App icon for Slack
Background color for Teams
Background color for Slack
You can follow your conversation with UnO AI Pilot even using both channels. For example, you can ask your question to UnO AI Piloton Slack, and then continue the conversation on Teams.

Integration with Google Chat

Before starting to install UnO AI Pilot, you must check the following system prerequisites:
  1. Google Workspace account with access to Google Chat.
  2. Google Cloud project (PROJECT_ID).
  3. In the Google Cloud console, enable the Google Chat API.
  4. UnO AI Pilot has to be reachable from Google Chat API.
To integrate UnO AI Pilot with Google Chat messaging tools, you must run the following steps:
  1. Provide the required Google Chat parameters in the <values.yaml> configuration file.
  2. Update the environment with GCP project ID, for example:PROJECT_ID="channel".
  3. Map the email ID of your Google Chat with the UnO OIDC provider user ID.
  4. Add the UnO AI Pilot app to your Google Chat/Space.
  5. You can now run the UnO AI Pilot actions from the Google Chat.
To configure UnO AI Pilot with Google Chat API, you must run the following steps:
  1. In the App status select Live - available to users.
  2. In the App name, type UnO AI Pilot.
  3. In the Avatar URL, enter https://storage.googleapis.com/UnO AI Pilot-img/full_color.png
  4. Enable Interactive features.
  5. Select Receive 1:1 messages.
  6. Select Join spaces and group conversations.
  7. In the Connection settings, click App URL.
  8. In the App URL, enter https://<UnO host>/webhooks/hangouts/webhook

Customizing environment files 

For Universal Orchestrator, before starting UnO AI Pilot installation, modify the  <values.yaml>/.env. TEMPLATE configuration file to set UnO AI Pilot common properties and optionally configure UnO AI Pilot integration with Slack and Teams messaging tools.

Table 2.
Common properties
Properties for UnO AI Pilot integration with Messaging tools (Slack and Teams)UnO AI Pilot
BOTFRAMEWORK_APP_ID ID for UnO AI Pilot Teams account
BOTFRAMEWORK_APP_PASSWORD Password for UnO AI Pilot Teams account
SLACK_TOKEN The token generated by the Slack bot
SLACK_CHANNEL The Slack bot channel ID
SLACK_SIGNING_SECRET The Slack unique string for UnO AI Pilot.
GOOGLE_PROJECT_ID ID for GCP project 
Note: After configuring the values in the values.yaml make sure to do helm upgrade <ReleaseName> -n <namespace>".