# Slack Bot Installation

## Slack App Setup

Before using the bot, a Slack app must be created and installed to your workspace.

1. Go to [api.slack.com/apps](https://api.slack.com/apps?new_app=1) to create a new app.
2. Click **Create New App** → **From a manifest**.
3. Pick your workspace and select **DuploCloud**.
4. Copy the manifest below into the JSON window, replacing `{customer-name}` with the customer's name, then click **Create**.
5. Scroll down to **Display Information** and update the logo.

   ![DuploCloud logo for Slack](/files/1UiBKdp7fKjXCCaxYadO)
6. Go to **Collaborators** in the left sidebar and add collaborators.
7. Go to **Install App** and request to install the app to the DuploCloud workspace.
8. In the **Basic Information** tab, scroll to **App-Level Tokens** and click **Generate Token and Scope**.
   * Name the token `slack`
   * Add the scope `connections:write`
   * Click **Generate** and save the app token
9. Return to the **Install App** tab. Once your installation request is approved, install the app and save the bot token.

   ![Slack bot install request approved](/files/wNzSnSe5VTiKDJ5t8jK6)

### Slack App Manifest

Replace all instances of `{customer-name}` before creating the app.

```json
{
    "display_information": {
        "name": "DuploAI {customer-name}",
        "description": "AI HelpDesk by DuploCloud for {customer-name}",
        "background_color": "#000000",
        "long_description": "The DuploAI Slack Bot serves as the seamless gateway that brings the power of DuploAI's HelpDesk experience directly into Slack, enabling teams to leverage AI-powered DevOps assistance within their existing communication workflows."
    },
    "features": {
        "bot_user": {
            "display_name": "DuploAI {customer-name}",
            "always_online": true
        },
        "shortcuts": [
            {
                "name": "Ask DuploAI {customer-name}",
                "type": "message",
                "callback_id": "ai_shortcut_invoke",
                "description": "Invokes HelpDesk AI Agent for this message"
            }
        ]
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "app_mentions:read",
                "assistant:write",
                "channels:history",
                "channels:read",
                "chat:write",
                "commands",
                "groups:history",
                "im:history",
                "users:read",
                "files:write"
            ]
        }
    },
    "settings": {
        "event_subscriptions": {
            "bot_events": [
                "app_mention",
                "message.channels",
                "message.groups",
                "message.im"
            ]
        },
        "org_deploy_enabled": true,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false
    }
}
```

### Backend Helm Installation

Once the Slack app tokens are saved, the remaining configuration is handled during the backend Helm installation. The `SLACK_APP_TOKEN` and `SLACK_BOT_TOKEN` from the steps above, along with the DuploCloud portal URL and token, are passed in as Helm values and stored in a Kubernetes secret named `slack-managed-portals`:

```yaml
slackBackend:
  image:
    tag: <version>
  envFromSecret:
    create: true
    secretName: "slack-managed-portals"
    data:
      SLACK_APP_TOKEN: "<your-slack-app-token>"
      SLACK_BOT_TOKEN: "<your-slack-bot-token>"
      DUPLO_SLACK_APP_PORTALS: |
        - duplo_host: https://your-company.duplocloud.net
          duplo_token: <your-duplocloud-token>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.duplocloud.com/docs/getting-started/installation/slackbot-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.