Install AskHR from the Slack App Directory

This procedure explains how to install the AskHR application from the Slack App Directory and connect it to Applaud.

Prerequisites

Before you start, make sure you have:

• Slack Workspace: The workspace where you will install the app.
• Admin Access: Slack administrator rights.
• Account Access: The AskHR app connects to an account. Make sure you have the URL and user credentials.
• AI Assistant Setup: In Applaud, enable the AI assistant and select Use this bot to interact with external bots and generate responses.

Step 1: Locate AskHR in the Slack App Directory

1. Open the Slack App Directory in your browser or within the Slack app.
2. In the search bar, enter AskHR.
3. From the search results, select AskHR to open its details page.

Step 2: Install the Application

1. On the app details page, select Add to Slack.
2. Review the requested permissions.
3. Select Authorize.
4. When prompted, select Open Slack to return to your workspace.
5. In Slack, go to Apps to verify the installation.

Step 3: Configure the Application

1. In Slack, go to Apps and select AskHR.
2. On the About tab, select Configuration.
3. Review and update permissions as necessary, including who can use the app and what data it can access.

Step 4: Connect the Applaud instance to AskHR

1. In Slack, navigate to Apps and select AskHR.
2. On the Home tab, select Connect to Applaud.
3. Enter your Applaud instance URL, for example: https://company.applaudcloud.com, and select Submit.
   • The system uses a secure OAuth process in the background to connect Slack to your Applaud instance.
4. Once connected, a success message appears in the Slack app.

Step 5: Connect the Applaud user account

1. In Slack, go to Apps > AskHR > Home tab.
2. Select Connect your account.
3. The system redirects to your Applaud instance.
4. Log in using your Applaud credentials.
5. After successful authentication, return to Slack. The AskHR app is now fully connected to your user account.

Step 6: Test the Application

1. Send a message to the AskHR bot in Slack.
2. Confirm the bot responds quickly and without errors.

Step 7: Provide Access to Team Members

• Inform team members that the app is installed.
• Each team member must:
  1. Go to Apps > AskHR.
  2. Select Connect your account and log in with their Applaud credentials.

Additional instructions (If Needed)

Disconnect a user account

• In Apps > AskHR > Home, select Disconnect your account. This removes only the selected user’s connection.

Connect to a different Applaud instance

Disconnecting an instance removes all user connections. Users must reconnect individually after the new instance is added.

• In Apps > AskHR > Home, select Disconnect Applaud.

Uninstall AskHR

1. In Slack, navigate to Apps > AskHR > About > Configuration.
2. Select Remove App.
3. Confirm the removal.
4. Notify your team of the change.

Error Messages

If the connection fails or the AI assistant is unavailable, the app displays one of these messages:

• “We’re sorry! It seems our AI assistant is having trouble responding right now. Please try again later, or contact support if the issue persists.”
• “Apologies, but it seems you currently don’t have access. If this issue continues, please consider contacting the support for assistance.”

Notes for Enterprise Grid Customers