Create and Configure the AptEdge Slack Bot

1. Open the manifest.json provided by your AptEdge account representative.

2. Copy the entire JSON contents.

3. Open https://api.slack.com/apps?new_app=1 and click “From manifest.”

4. Choose the Slack workspace where the app will be installed.

5. Click Next.

6. Paste the copied manifest JSON into the editor, replacing the existing contents.

7. Click Next.

8. Open the “Basic Information” page of the app settings. 

9. The app icon to this (left-click, then right-click and hit “Save image as…”): 

10. Click “Save Changes”.

Step 2: Retrieve Your AptEdge Support Token

1. In another tab, navigate to your AptEdge instance (i.e. aptedge.aptedge.io)

2. Navigate to: Admin Settings -> Apps

   

3. Copy your Support App Token using the clipboard icon to the right.

   Keep this tab open for later steps.

Step 3: Configure Interactivity & Shortcuts

1. Return to your tab where you are configuring your Slack app settings.

2. Open "Interactivity & Shortcuts"

3. 

4. Update the Request URL by replacing:

   1. Replace [INSTANCE_NAME] with the name of your Instance.

   2. Replace [SUPPORT_TOKEN] with the token you copied from your clipboard. 

5. Click Save Changes

Step 4: Configure Event Subscriptions

1. Open "Event Subscriptions"

   

2. Update the Request URL by replacing:

   1. Replace [INSTANCE_NAME] with the name of your Instance.

   2. Replace [SUPPORT_TOKEN] with the token you copied from your clipboard. 

3. You should now see "Verified" with a green checkmark above the URL.

4. Click Save Changes.

Step 5: Install the Slack App

1. In the Slack app settings, go to: Settings -> Install App
2. Install the Application to the applicable Slack Instance.
3. Navigate to "OAuth & permissions"
4. Under OAuth Tokens, copy the Bot User OAuth Token
5. Return to your AptEdge instance, Admin Settings -> Apps

6. Under "Slack App", paste the copied token into the Token field and Save

   

Step 6: Testing the App

1. Add the app to a Slack channel.

   1. Open a Slack channel.

   2. In the top right, click the person icon (e.g. ).

   3. In the modal that appears, click the “Integrations” tab.

   4. In the “Apps” box, click “Add apps” or “Add an app.”

   5. Search for “AskAptEdge” and click “Add.”

2. Inside the channel, "@AskAptedge your question"

3. A reaction emoji should be added to your message. After a short time, a response should be added in your message’s thread.