Bolt for JavaScript

https://docs.slack.dev/tools/bolt-js
Admin
Bolt for JavaScript is a JavaScript framework designed to build Slack apps with the latest Slack...
Tokens:136,071
Snippets:1,203
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Org-wide installation store with example database

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Configure an App with an installationStore that handles org-wide installations by checking isEnterpriseInstall and enterprise.id, falling back to team.id. The companion database object provides a simple in-memory store for quick testing.

```javascript
const app = new App({  signingSecret: process.env.SLACK_SIGNING_SECRET,  clientId: process.env.SLACK_CLIENT_ID,  clientSecret: process.env.SLACK_CLIENT_SECRET,  stateSecret: process.env.SLACK_STATE_SECRET,  scopes: ["chat:write", "commands"],  installationStore: {    storeInstallation: async (installation) => {      if (        installation.isEnterpriseInstall &&        installation.enterprise !== undefined      ) {        return await database.set(installation.enterprise.id, installation);      }      if (installation.team !== undefined) {        return await database.set(installation.team.id, installation);      }      throw new Error("Failed to save installation data to installationStore");    },    fetchInstallation: async (installQuery) => {      if (        installQuery.isEnterpriseInstall &&        installQuery.enterpriseId !== undefined      ) {        return await database.get(installQuery.enterpriseId);      }      if (installQuery.teamId !== undefined) {        return await database.get(installQuery.teamId);      }      throw new Error("Failed to fetch installation");    },    deleteInstallation: async (installQuery) => {      if (        installQuery.isEnterpriseInstall &&        installQuery.enterpriseId !== undefined      ) {        return await database.delete(installQuery.enterpriseId);      }      if (installQuery.teamId !== undefined) {        return await database.delete(installQuery.teamId);      }      throw new Error("Failed to delete installation");    },  },});
```

```javascript
const database = {  store: {},  async get(key) {    return this.store[key];  },  async delete(key) {    delete this.store[key];  },  async set(key, value) {    this.store[key] = value;  },};
```

--------------------------------

### Installation object with user token

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Example `installation` object stored in `storeInstallation` when user scopes are requested. The `user` attribute contains the user token and scopes, while `tokenType` remains `"bot"`.

```json
{  team: { id: "T012345678", name: "example-team-name" },  user: {    token: "xoxp-314159-26*********-********************",    scopes: ["chat:write"],    id: "U012345678"  },  tokenType: "bot",  appId: "A01234567",  // ...}
```

--------------------------------

### start()

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/HTTPReceiver

Starts the HTTP server with various overloads.

```APIDOC
## start(port)

### Description
Starts the HTTP server on the specified port.

### Parameters
- **port** (number) - Required - The port number to listen on.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`
```

```APIDOC
## start(port)

### Description
Starts the HTTP server on the specified port.

### Parameters
- **port** (string) - Required - The port number as a string.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`
```

```APIDOC
## start(portOrListenOptions, serverOptions?)

### Description
Starts the HTTP server with the given port or listen options and optional server options.

### Parameters
- **portOrListenOptions** (string | number | ListenOptions) - Required - The port number or listen options.
- **serverOptions** (ServerOptions<typeof IncomingMessage, typeof ServerResponse>) - Optional - Additional server options.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`
```

```APIDOC
## start(portOrListenOptions, httpsServerOptions?)

### Description
Starts the HTTP server with the given port or listen options and optional HTTPS server options.

### Parameters
- **portOrListenOptions** (string | number | ListenOptions) - Required - The port number or listen options.
- **httpsServerOptions** (ServerOptions) - Optional - Additional HTTPS server options.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`
```

--------------------------------

### Org-wide installQuery object

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Example `installQuery` object passed to `fetchInstallation` and `deleteInstallation` handlers for org-wide installations. Includes `enterpriseId` and `isEnterpriseInstall`.

```json
{  userId: "U0000000001",  isEnterpriseInstall: true,  teamId: "T0000000001",  enterpriseId: "E0000000001",  conversationId: "D0000000001"}
```

--------------------------------

### Example database object for testing

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Simple in-memory database object used for quick testing of the installationStore. Provides async delete, get, and set methods backed by a plain object.

```javascript
const database = {  store: {},  async delete(key) {    delete this.store[key];  },  async get(key) {    return this.store[key];  },  async set(key, value) {    this.store[key] = value;  },};
```

--------------------------------

### start()

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/SocketModeReceiver

Starts the receiver and opens the web socket connection.

```APIDOC
## start()

### Description
Starts the receiver and establishes the web socket connection.

### Method
`start(): Promise<AppsConnectionsOpenResponse>`

### Returns
`Promise<AppsConnectionsOpenResponse>` - A promise that resolves with the response from the apps.connections.open API.
```

--------------------------------

### start(portOrListenOptions, serverOptions?)

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/ExpressReceiver

Starts the receiver server with optional listen and server options.

```APIDOC
## start(portOrListenOptions, serverOptions?)

### Description
Starts the receiver server with optional listen and server options.

### Method
start

### Parameters
- **portOrListenOptions** (`number` | `ListenOptions`) - Required - The port number or listen options.
- **serverOptions?** (`ServerOptions<typeof IncomingMessage, typeof ServerResponse>`) - Optional - Server options.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`

```

--------------------------------

### start(...args)

Source: https://docs.slack.dev/tools/bolt-js/reference/interfaces/Receiver

Starts the receiver with the provided arguments.

```APIDOC
## start(...args)

### Description
Starts the receiver with the provided arguments.

### Method
start

### Signature
`start(...args): Promise<unknown>;`

### Parameters
- **args** (`...any[]`) - Required - Arguments to pass to the start method.

### Returns
`Promise<unknown>`
```

--------------------------------

### Install Slack CLI, login, and create a project

Source: https://docs.slack.dev/tools/bolt-js/getting-started

Install the Slack CLI, authenticate with your workspace, and create a new project using the 'Starter App' template. Run these commands in order to set up your development environment.

```bash
curl -fsSL https://downloads.slack-edge.com/slack-cli/install.sh | bash
```

```bash
slack login
```

```bash
slack create first-slack-app
```

--------------------------------

### start(portOrListenOptions, httpsServerOptions?)

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/ExpressReceiver

Starts the receiver server with optional HTTPS server options.

```APIDOC
## start(portOrListenOptions, httpsServerOptions?)

### Description
Starts the receiver server with optional HTTPS server options.

### Method
start

### Parameters
- **portOrListenOptions** (`number` | `ListenOptions`) - Required - The port number or listen options.
- **httpsServerOptions?** (`ServerOptions`) - Optional - HTTPS server options.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`

```

--------------------------------

### Install npm packages

Source: https://docs.slack.dev/tools/bolt-js/tutorials/ai-assistant

Install all necessary packages for the project.

```bash
npm install
```

--------------------------------

### App Initialization with Installer Options

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Shows how to initialize a Slack Bolt app with custom OAuth installer options, including state store and callback customization.

```APIDOC
## App Initialization with Installer Options

### Description
Configure OAuth installation behavior when initializing the Slack Bolt app by passing an `installerOptions` object to the `App` constructor.

### Method
Constructor

### Endpoint
`new App(options)`

### Parameters
#### Request Body
- **signingSecret** (string) - Required - Slack app signing secret.
- **clientId** (string) - Required - Slack app client ID.
- **clientSecret** (string) - Required - Slack app client secret.
- **scopes** (string[]) - Required - Bot scopes to request during installation.
- **installerOptions** (object) - Optional - Customization options for OAuth installation.
  - **authVersion** (string) - Optional - OAuth version: `v2` for new apps, `v1` for classic apps. Default: `v2`.
  - **directInstall** (boolean) - Optional - Skip installation page and redirect to authorization URL. Default: `false`.
  - **installPath** (string) - Optional - Path for starting installation. Default: `/slack/install`.
  - **metadata** (string) - Optional - Static information shared between requests.
  - **redirectUriPath** (string) - Optional - Path for OAuth callback. Default: `/slack/oauth_redirect`.
  - **stateVerification** (boolean) - Optional - Verify state parameter. Default: `true`.
  - **userScopes** (string[]) - Optional - User scopes to request. Default: `[]`.
  - **callbackOptions** (object) - Optional - Customized responses during OAuth.
    - **success** (function) - Optional - Callback on successful installation.
    - **failure** (function) - Optional - Callback on failed installation.
  - **stateStore** (object) - Optional - Custom state generator and validator.
    - **generateStateParam** (async function) - Required - Generate state parameter.
    - **verifyStateParam** (async function) - Required - Verify state parameter.

### Request Example
```javascript
const app = new App({
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  clientId: process.env.SLACK_CLIENT_ID,
  clientSecret: process.env.SLACK_CLIENT_SECRET,
  scopes: [
    "channels:manage",
    "channels:read",
    "chat:write",
    "groups:read",
    "incoming-webhook",
  ],
  installerOptions: {
    authVersion: "v2",
    directInstall: false,
    installPath: "/slack/install",
    metadata: "",
    redirectUriPath: "/slack/oauth_redirect",
    stateVerification: "true",
    userScopes: ["chat:write"],
    callbackOptions: {
      success: (installation, installUrlOptions, req, res) => {
        res.send("The installation succeeded!");
      },
      failure: (error, installUrlOptions, req, res) => {
        res.send("Something strange happened...");
      },
    },
    stateStore: {
      generateStateParam: async (installUrlOptions, now) => {
        const state = randomStringGenerator();
        const value = { options: installUrlOptions, now: now.toJSON() };
        await database.set(state, value);
        return state;
      },
      verifyStateParam: async (now, state) => {
        const value = await database.get(state);
        const generated = new Date(value.now);
        const seconds = Math.floor(
          (now.getTime() - generated.getTime()) / 1000,
        );
        if (seconds > 600) {
          throw new Error("The state expired after 10 minutes!");
        }
        return value.options;
      },
    },
  },
});
```

### Response
No response body is returned; the `App` instance is created.

### Error Handling
- If `stateVerification` is `true` and state verification fails, an error is thrown.
- If `verifyStateParam` throws an error, the OAuth flow fails.
```

--------------------------------

### Start the application

Source: https://docs.slack.dev/tools/bolt-js/tutorials/code-assistant

Run this command in your terminal to start the Code Assistant app.

```bash
npm start
```

--------------------------------

### start(port)

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/ExpressReceiver

Starts the receiver server on the specified port.

```APIDOC
## start(port)

### Description
Starts the receiver server on the specified port.

### Method
start

### Parameters
- **port** (`number`) - Required - The port number to listen on.

### Returns
`Promise<Server<typeof IncomingMessage, typeof ServerResponse>>`

```

--------------------------------

### start(..._args): Promise<AwsHandler>

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/AwsLambdaReceiver

Starts the receiver and returns an AWS Lambda handler.

```APIDOC
## Method

### start(..._args): Promise<AwsHandler>

Starts the receiver and returns an AWS Lambda handler.

#### Parameters
- **_args** (any[]) - Optional - Additional arguments.

#### Returns
- `Promise<AwsHandler>` - A promise that resolves to an AWS Lambda handler.

```

--------------------------------

### Start the app

Source: https://docs.slack.dev/tools/bolt-js/concepts/adding-agent-features

Starts the Bolt app with OAuth using the Slack CLI.

```bash
slack run app-oauth.js
```

--------------------------------

### Start web server with heroku ps:scale

Source: https://docs.slack.dev/tools/bolt-js/deployments/heroku

Starts a web server instance using the Heroku CLI. This is required after deploying the app to Heroku.

```bash
heroku ps:scale web=1
```

--------------------------------

### Install local dev app

Source: https://docs.slack.dev/tools/bolt-js/concepts/adding-agent-features

Installs a new local dev app using the Slack CLI.

```bash
slack install -E local
```

--------------------------------

### Install serverless-offline

Source: https://docs.slack.dev/tools/bolt-js/deployments/aws-lambda

Command to install serverless-offline as a development dependency for local emulation.

```bash
npm install --save-dev serverless-offline
```

--------------------------------

### Customize install page with renderHtmlForInstallPath

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Customizes the HTML returned by the install path. The renderHtmlForInstallPath callback receives the generated addToSlackUrl and must return a string of HTML, typically containing an Add to Slack button.

```javascript
const app = new App({
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  // ...
  installerOptions: {
    renderHtmlForInstallPath: (addToSlackUrl) => {
      return `<a href="${addToSlackUrl}">Add to Slack</a>`;
    },
  },
});
```

--------------------------------

### Initialize and start Bolt app

Source: https://docs.slack.dev/tools/bolt-js/tutorials/ai-assistant

Initializes the Bolt app with environment variables, registers listeners, and starts the app. Uses socket mode and logs errors if startup fails.

```javascript
// Initialize the Bolt app
const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  appToken: process.env.SLACK_APP_TOKEN,
  socketMode: true,
  logLevel: LogLevel.DEBUG,
  clientOptions: {
    slackApiUrl: process.env.SLACK_API_URL || 'https://slack.com/api',
  },
});
// Register the action and event listeners
registerListeners(app);
// Start the Bolt app
(async () => {
  try {
    await app.start();
    app.logger.info('⚡️ Bolt app is running!');
  } catch (error) {
    app.logger.error('Failed to start the app', error);
  }
})();
```

--------------------------------

### Org-wide installation object (isEnterpriseInstall true)

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Org-wide installation object with `isEnterpriseInstall` set to `true`. The `team` is `undefined` and an `enterprise` object is present.

```json
{  team: undefined,  enterprise: { id: "E0000000001", name: "laboratories" },  user: { token: undefined, scopes: undefined, id: "U0000000001" },  tokenType: "bot",  isEnterpriseInstall: true,  appId: "A0000000001",  authVersion: "v2",  bot: {    scopes: [      "chat:write",    ],    token: "xoxb-000001-00*********-********************",    userId: "U0000000002",    id: "B0000000001"  }}
```

--------------------------------

### Example database object for stateStore testing

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

A simple in-memory database object for quick testing of the stateStore example. Provides async get and set methods that store values in a plain object.

```javascript
const database = {
  store: {},
  async get(key) {
    return this.store[key];
  },
  async set(key, value) {
    this.store[key] = value;
  },
};
```

--------------------------------

### Create project directory

Source: https://docs.slack.dev/tools/bolt-js/tutorials/code-assistant

Creates a new directory named 'code-assistant' and navigates into it. Run this in your terminal before cloning the starter template.

```bash
mkdir code-assistant
cd code-assistant
```

--------------------------------

### Customize OAuth installer options in App initialization

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Configures a Slack Bolt app with custom installer options for OAuth. Overrides authVersion, directInstall, installPath, metadata, redirectUriPath, stateVerification, userScopes, callbackOptions, and stateStore. The stateStore example uses a random state generator and a database to validate state expiration after 10 minutes.

```javascript
const app = new App({
  signingSecret: process.env.SLACK_SIGNING_SECRET,
  clientId: process.env.SLACK_CLIENT_ID,
  clientSecret: process.env.SLACK_CLIENT_SECRET,
  scopes: [
    "channels:manage",
    "channels:read",
    "chat:write",
    "groups:read",
    "incoming-webhook",
  ],
  installerOptions: {
    authVersion: "v2",
    directInstall: false,
    installPath: "/slack/install",
    metadata: "",
    redirectUriPath: "/slack/oauth_redirect",
    stateVerification: "true",
    /**
     * Example user scopes to request during installation.
     */
    userScopes: ["chat:write"],
    /**
     * Example pages to navigate to on certain callbacks.
     */
    callbackOptions: {
      success: (installation, installUrlOptions, req, res) => {
        res.send("The installation succeeded!");
      },
      failure: (error, installUrlOptions, req, res) => {
        res.send("Something strange happened...");
      },
    },
    /**
     * Example validation of installation options using a random state and an
     * expiration time between requests.
     */
    stateStore: {
      generateStateParam: async (installUrlOptions, now) => {
        const state = randomStringGenerator();
        const value = { options: installUrlOptions, now: now.toJSON() };
        await database.set(state, value);
        return state;
      },
      verifyStateParam: async (now, state) => {
        const value = await database.get(state);
        const generated = new Date(value.now);
        const seconds = Math.floor(
          (now.getTime() - generated.getTime()) / 1000,
        );
        if (seconds > 600) {
          throw new Error("The state expired after 10 minutes!");
        }
        return value.options;
      },
    },
  },
});
```

--------------------------------

### Test Serverless CLI with serverless help

Source: https://docs.slack.dev/tools/bolt-js/deployments/aws-lambda

Run this command after installing the Serverless Framework to verify the CLI is working and display available commands.

```bash
serverless help
```

--------------------------------

### Get Heroku web address with heroku info

Source: https://docs.slack.dev/tools/bolt-js/deployments/heroku

Retrieves the Heroku web address, which is used as the Request URL for Slack events and actions. The example output shows the Web URL field.

```bash
heroku info# ...# Web URL: https://sharp-rain-871.herokuapp.com/
```

--------------------------------

### Defer initialization with deferInitialization and app.init()

Source: https://docs.slack.dev/tools/bolt-js/concepts/deferring-initialization

Set deferInitialization to true in the App constructor, then call app.init() before app.start() inside an async function. If start() is called before init(), Bolt raises an exception. The example catches errors and exits the process.

```javascript
const { App } = require('@slack/bolt');// deferInitialization is one of the options you can set in the constructorconst app = new App({  token,  signingSecret,  deferInitialization: true,});(async () => {  try {    // Must call init() before start() within an async function    await app.init();    // Now safe to call start()    await app.start(process.env.PORT || 3000);  } catch (e) {    app.logger.error(e);    process.exit(1);  }})()
```

--------------------------------

### Extract custom properties with HTTPReceiver

Source: https://docs.slack.dev/tools/bolt-js/concepts/receiver

Use the `customPropertiesExtractor` option on `HTTPReceiver` to extract custom properties from incoming HTTP requests. The returned object is added to the context, which can be accessed in middleware via `context`. This example also shows how to start the app and log the context.

```javascript
const { App, HTTPReceiver } = require('@slack/bolt');
const app = new App({
  token: process.env.SLACK_BOT_TOKEN,
  receiver: new HTTPReceiver({
    signingSecret: process.env.SLACK_SIGNING_SECRET,
    customPropertiesExtractor: (req) => {
      return {
        "headers": req.headers,
        "foo": "bar",
      };
    }
  }),
});
app.use(async ({ logger, context, next }) => {
  logger.info(context);
  await next();
});
(async () => {
  // Start your app
  await app.start(process.env.PORT || 3000);
  app.logger.info('⚡️ Bolt app is running!');
})();
```

--------------------------------

### Installation object for workspace install

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Shape of the installation object passed to storeInstallation after a single-workspace install. Includes team, user, bot, and token details; enterprise is undefined for workspace installs.

```json
{  team: { id: "T012345678", name: "example-team-name" },  enterprise: undefined,  user: { token: undefined, scopes: undefined, id: "U012345678" },  tokenType: "bot",  isEnterpriseInstall: false,  appId: "A01234567",  authVersion: "v2",  bot: {    scopes: [      "chat:write",    ],    token: "xoxb-244493-28*********-********************",    userId: "U001111000",    id: "B01234567"  }}
```

--------------------------------

### Navigate to project directory

Source: https://docs.slack.dev/tools/bolt-js/tutorials/ai-assistant

Change into the cloned project directory.

```bash
# Change into this project directorycd bolt-js-assistant-template
```

--------------------------------

### Navigate into the project directory

Source: https://docs.slack.dev/tools/bolt-js/getting-started

Navigate into the project directory created by 'slack create' to start developing your app.

```bash
$ cd first-slack-app  
```

--------------------------------

### Install Heroku CLI on macOS

Source: https://docs.slack.dev/tools/bolt-js/deployments/heroku

Installs the Heroku CLI using Homebrew on macOS. Requires Homebrew to be installed.

```bash
brew install heroku/brew/heroku
```

--------------------------------

### Run the app with 'slack run'

Source: https://docs.slack.dev/tools/bolt-js/getting-started

Run the starter app locally. The output shows the Bolt app is running successfully, indicating the app is ready to test.

```bash
$ slack run  

...  

INFO:slack_bolt.App:⚡️ Bolt app is running!  

...  
```

--------------------------------

### Workspace installation object in an org (isEnterpriseInstall false)

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Installation object for an app installed to an individual workspace within an organization. Both `team` and `enterprise` are present, and `isEnterpriseInstall` is `false`.

```json
{  team: { id: "T0000000001", name: "experimental-sandbox" },  enterprise: { id: "E0000000001", name: "laboratories" },  // ...  isEnterpriseInstall: false,  // ...}
```

--------------------------------

### init()

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/App

Initializes the app. Returns a promise that resolves when initialization is complete.

```APIDOC
## init()

### Description
Initializes the app. Returns a promise that resolves when initialization is complete.

### Method
N/A (SDK method)

### Endpoint
N/A

### Parameters
None

### Returns
`Promise<void>`

### Source
[src/App.ts:458](https://github.com/slackapi/bolt-js/blob/main/src/App.ts#L458)
```

--------------------------------

### Disable state verification for org-wide installs

Source: https://docs.slack.dev/tools/bolt-js/concepts/authenticating-oauth

Disable OAuth state verification for org-wide installations from admin pages. Set `stateVerification` to `false` in `installerOptions` to allow installation to proceed.

```javascript
const app = new App({  signingSecret: process.env.SLACK_SIGNING_SECRET,  clientId: process.env.SLACK_CLIENT_ID,  clientSecret: process.env.SLACK_CLIENT_SECRET,  scopes: ["chat:write"],  installerOptions: {    stateVerification: false,  },});
```

--------------------------------

### Install @slack/bolt package

Source: https://docs.slack.dev/tools/bolt-js/creating-an-app

Install the Bolt for JavaScript package as a dependency for your project.

```bash
$ npm install @slack/bolt
```

--------------------------------

### init(app)

Source: https://docs.slack.dev/tools/bolt-js/reference/interfaces/Receiver

Initializes the receiver with the provided App instance.

```APIDOC
## init(app)

### Description
Initializes the receiver with the provided App instance.

### Method
init

### Signature
`init(app): void;`

### Parameters
- **app** (`App`) - Required - The Bolt App instance.

### Returns
`void`
```

--------------------------------

### Custom authorize function for multi-workspace apps

Source: https://docs.slack.dev/tools/bolt-js/concepts/authorization

Shows how to initialize an App with a custom authorize function and provide a sample implementation that looks up installation credentials from an in-memory array. The authorize function must return a Promise resolving to an object with botToken, botId, and botUserId, and throws an error if no matching installation is found.

```javascript
const app = new App({ authorize: authorizeFn, signingSecret: process.env.SLACK_SIGNING_SECRET });
```

```javascript
// NOTE: This is for demonstration purposes only.
// All sensitive data should be stored in a secure database
// Assuming this app only uses bot tokens, the following object represents a model for storing the credentials as the app is installed into multiple workspaces.
const installations = [
  {
    enterpriseId: 'E1234A12AB',
    teamId: 'T12345',
    botToken: 'xoxb-123abc',
    botId: 'B1251',
    botUserId: 'U12385',
  },
  {
    teamId: 'T77712',
    botToken: 'xoxb-102anc',
    botId: 'B5910',
    botUserId: 'U1239',
  },
];

const authorizeFn = async ({ teamId, enterpriseId }) => {
  // Fetch team info from database
  for (const team of installations) {
    // Check for matching teamId and enterpriseId in the installations array
    if ((team.teamId === teamId) && (team.enterpriseId === enterpriseId)) {
      // This is a match. Use these installation credentials.
      return {
        // You could also set userToken instead
        botToken: team.botToken,
        botId: team.botId,
        botUserId: team.botUserId
      };
    }
  }
  throw new Error('No matching authorizations');
}
```

--------------------------------

### new App<AppCustomContext>(__namedParameters?)

Source: https://docs.slack.dev/tools/bolt-js/reference/classes/App

Creates a new instance of the App class with optional configuration options.

```APIDOC
## Constructor

### Description
Creates a new Slack App instance.

### Signature
`new App<AppCustomContext>(__namedParameters?): App<AppCustomContext>;`

### Parameters
- **__namedParameters** (`AppOptions`, optional) - Configuration options for the app. Defaults to `{}`.

### Returns
`App<AppCustomContext>` - A new App instance.
```
Tokens:
Raw