diff --git a/docs/english/guides/ai-apps.md b/docs/english/guides/ai-apps.md index 64c2cb795..95d885ad6 100644 --- a/docs/english/guides/ai-apps.md +++ b/docs/english/guides/ai-apps.md @@ -279,7 +279,7 @@ public class AssistantSimpleApp { } }); - app.use(assistant); + app.assistant(assistant); app.event(MessageEvent.class, (req, ctx) -> { return ctx.ack(); diff --git a/docs/english/guides/app-distribution.md b/docs/english/guides/app-distribution.md index 0b9d8de0c..416131aa6 100644 --- a/docs/english/guides/app-distribution.md +++ b/docs/english/guides/app-distribution.md @@ -11,7 +11,7 @@ A newly created Slack app can only be installed in its development workspace in ### Slack app configuration -To enable App Distribution, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, go to **Settings** > **Manage Distribution** on the left pane, and follow the instructions there. +To enable App Distribution, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, go to **Settings** > **Manage Distribution** on the left pane, and follow the instructions there. For **Redirect URL**, Bolt apps respond to `https://{your app's public URL domain}/slack/oauth/callback` if you go with recommended settings. To know how to configure such settings, consult the list of the available env variables below in this page. @@ -40,7 +40,6 @@ import com.slack.api.bolt.App; import com.slack.api.bolt.jetty.SlackAppServer; import java.util.HashMap; import java.util.Map; -import static java.util.Map.entry; // API Request Handler App // expected env variables: @@ -58,10 +57,10 @@ apiApp.command("/hi", (req, ctx) -> { App oauthApp = new App().asOAuthApp(true); // Mount the two apps with their root path -SlackAppServer server = new SlackAppServer(new HashMap<>(Map.ofEntries( - entry("/slack/events", apiApp), // POST /slack/events (incoming API requests from the Slack Platform) - entry("/slack/oauth", oauthApp) // GET /slack/oauth/start, /slack/oauth/callback (user access) -))); +Map apps = new HashMap<>(); +apps.put("/slack/events", apiApp); // POST /slack/events (incoming API requests from the Slack Platform) +apps.put("/slack/oauth", oauthApp); // GET /slack/oauth/start, /slack/oauth/callback (user access) +SlackAppServer server = new SlackAppServer(apps); server.start(); // http://localhost:3000 ``` @@ -107,7 +106,6 @@ import com.slack.api.bolt.service.builtin.AmazonS3OAuthStateService; import java.util.HashMap; import java.util.Map; -import static java.util.Map.entry; // The standard AWS env variables are expected // export AWS_REGION=us-east-1 @@ -139,10 +137,10 @@ OAuthStateService stateService = new AmazonS3OAuthStateService(awsS3BucketName); oauthApp.service(stateService); // Mount the two apps with their root path -SlackAppServer server = new SlackAppServer(new HashMap<>(Map.ofEntries( - entry("/slack/events", apiApp), // POST /slack/events (incoming API requests from the Slack Platform) - entry("/slack/oauth", oauthApp) // GET /slack/oauth/start, /slack/oauth/callback (user access) -))); +Map apps = new HashMap<>(); +apps.put("/slack/events", apiApp); // POST /slack/events (incoming API requests from the Slack Platform) +apps.put("/slack/oauth", oauthApp); // GET /slack/oauth/start, /slack/oauth/callback (user access) +SlackAppServer server = new SlackAppServer(apps); server.start(); // http://localhost:3000 ``` @@ -287,7 +285,7 @@ app.event(TokensRevokedEvent.class, app.defaultTokensRevokedEventHandler()); app.event(AppUninstalledEvent.class, app.defaultAppUninstalledEventHandler()); ``` -To enable your own custom `InstallationService` classes to work with the built-in event handlers, the classes need to implement the following methods in the [`InstallationService`](https://github.com/seratch/java-slack-sdk/blob/main/bolt/src/main/java/com/slack/api/bolt/service/InstallationService.java) interface: +To enable your own custom `InstallationService` classes to work with the built-in event handlers, the classes need to implement the following methods in the [`InstallationService`](https://github.com/slackapi/java-slack-sdk/blob/main/bolt/src/main/java/com/slack/api/bolt/service/InstallationService.java) interface: * `void deleteBot(Bot bot)` * `void deleteInstaller(Installer installer)` diff --git a/docs/english/guides/app-home.md b/docs/english/guides/app-home.md index f88ee35ca..7c83e5da7 100644 --- a/docs/english/guides/app-home.md +++ b/docs/english/guides/app-home.md @@ -8,7 +8,7 @@ An [App Home](/surfaces/app-home) is a private, one-to-one space in Slack shared ### Slack app configuration -To enable Home tabs, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, go to **Features** > **App Home** on the left pane, and then turn on **Home Tab**. +To enable Home tabs, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, go to **Features** > **App Home** on the left pane, and then turn on **Home Tab**. To enable the Events API, go to **Features** > **Event Subscriptions** on the left pane. There are a few things to do on the page. diff --git a/docs/english/guides/audit-logs-api.md b/docs/english/guides/audit-logs-api.md index 413dc5af5..a91041509 100644 --- a/docs/english/guides/audit-logs-api.md +++ b/docs/english/guides/audit-logs-api.md @@ -4,7 +4,7 @@ lang: en # Audit Logs API -The [Audit Logs API](https://api.lack.com/docs/audit-logs-api) is used for monitoring what is happening in your [Enterprise Grid](/enterprise) organization. +The [Audit Logs API](https://api.slack.com/docs/audit-logs-api) is used for monitoring what is happening in your [Enterprise Grid](/enterprise) organization. The Audit Logs API can be used by security information and event management (SIEM) tools to provide an analysis of how your Slack organization is being accessed. You can also use this API to write your own applications to see how members of your organization are using Slack. @@ -20,7 +20,7 @@ import com.slack.api.Slack; import com.slack.api.audit.*; Slack slack = Slack.getInstance(); -String token = System.getenv("SLACK_ADMIN_ACCESS_TOKN"); // `auditlogs:read` scope required +String token = System.getenv("SLACK_ADMIN_ACCESS_TOKEN"); // `auditlogs:read` scope required AuditClient audit = slack.audit(token); ``` @@ -89,7 +89,7 @@ import com.slack.api.audit.*; import com.slack.api.audit.response.LogsResponse; import java.util.concurrent.CompletableFuture; -String token = System.getenv("SLACK_ADMIN_ACCESS_TOKN"); // `auditlogs:read` scope required +String token = System.getenv("SLACK_ADMIN_ACCESS_TOKEN"); // `auditlogs:read` scope required AsyncAuditClient audit = Slack.getInstance().auditAsync(token); CompletableFuture response = audit.getLogs(req -> req diff --git a/docs/english/guides/events-api.md b/docs/english/guides/events-api.md index 3cde6e422..38ca2bd05 100644 --- a/docs/english/guides/events-api.md +++ b/docs/english/guides/events-api.md @@ -8,7 +8,7 @@ The [Events API](/apis/events-api/) is a streamlined way to build apps and bots ### Slack app configuration -To enable the Events API, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Event Subscriptions** on the left pane. There are a few things to do on the page. +To enable the Events API, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Event Subscriptions** on the left pane. There are a few things to do on the page. * Turn on **Enable Events** * Set the **Request URL** to `https://{your app's public URL domain}/slack/events` (this step is not required for Socket Mode apps) diff --git a/docs/english/guides/getting-started-with-bolt.md b/docs/english/guides/getting-started-with-bolt.md index 97eddc1d3..e18594e39 100644 --- a/docs/english/guides/getting-started-with-bolt.md +++ b/docs/english/guides/getting-started-with-bolt.md @@ -63,7 +63,7 @@ If instead you would prefer to use the `Java-WebSocket` implementation, swap its org.java-websocket Java-WebSocket - 1.5.1 + 1.6.0 ``` @@ -329,8 +329,8 @@ The default constructor expects the following two environment variables to exist |Env Variable|Description| |-|-| -|`SLACK_BOT_TOKEN`|The valid bot token value starting with `xoxb-` in your development workspace. To issue a bot token, install your Slack app that has a bot user to your development workspace. Visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Settings** > **Install App** on the left pane (Add [`app_mentions:read`](/reference/scopes/app_mentions.read) bot scope if you see the message saying "Please add at least one feature or permission scope to install your app.").

If you run an app that is installable for multiple workspaces, no need to specify this. Consult [App Distribution (OAuth)](/tools/java-slack-sdk/guides/app-distribution) for further information.| -|`SLACK_SIGNING_SECRET`|The secret value shared only with the Slack Platform. It is used for verifying incoming requests from Slack. Request verification is crucial for security as Slack apps have internet-facing endpoints. To know the value, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, go to **Settings** > **Basic Information** on the left pane, and find **App Credentials** > **Signing Secret** on the page. Refer to [Verifying requests from Slack](/authentication/verifying-requests-from-slack) for more information.| +|`SLACK_BOT_TOKEN`|The valid bot token value starting with `xoxb-` in your development workspace. To issue a bot token, install your Slack app that has a bot user to your development workspace. Visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Settings** > **Install App** on the left pane (Add [`app_mentions:read`](/reference/scopes/app_mentions.read) bot scope if you see the message saying "Please add at least one feature or permission scope to install your app.").

If you run an app that is installable for multiple workspaces, no need to specify this. Consult [App Distribution (OAuth)](/tools/java-slack-sdk/guides/app-distribution) for further information.| +|`SLACK_SIGNING_SECRET`|The secret value shared only with the Slack Platform. It is used for verifying incoming requests from Slack. Request verification is crucial for security as Slack apps have internet-facing endpoints. To know the value, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, go to **Settings** > **Basic Information** on the left pane, and find **App Credentials** > **Signing Secret** on the page. Refer to [Verifying requests from Slack](/authentication/verifying-requests-from-slack) for more information.| If you prefer configuring an `App` in a different way, write some code to initialize `AppConfig` on your own. diff --git a/docs/english/guides/incoming-webhooks.md b/docs/english/guides/incoming-webhooks.md index f951c68d2..f41fcce27 100644 --- a/docs/english/guides/incoming-webhooks.md +++ b/docs/english/guides/incoming-webhooks.md @@ -8,7 +8,7 @@ lang: en ### Slack app configuration -To enable this feature, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, go to **Features** > **Incoming Webhooks** on the left pane, and then turn on **Activate Incoming Webhooks**. +To enable this feature, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, go to **Features** > **Incoming Webhooks** on the left pane, and then turn on **Activate Incoming Webhooks**. Then, install the app to your development workspace. Each time your app is installed, a new webhook URL will be generated. diff --git a/docs/english/guides/interactive-components.md b/docs/english/guides/interactive-components.md index 4f79bc9b3..dd3b69b2e 100644 --- a/docs/english/guides/interactive-components.md +++ b/docs/english/guides/interactive-components.md @@ -10,7 +10,7 @@ See [Composing messages](/tools/java-slack-sdk/guides/composing-messages) to lea ### Slack app configuration -To enable interactive components, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Interactivity & Shortcuts** on the left pane. There are three things to do on the page. +To enable interactive components, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Interactivity & Shortcuts** on the left pane. There are three things to do on the page. * Turn on the feature * Set the **Request URL** to `https://{your app's public URL domain}/slack/events` (this step is not required for Socket Mode apps) diff --git a/docs/english/guides/modals.md b/docs/english/guides/modals.md index 9055ecf1d..b38a7d7b6 100644 --- a/docs/english/guides/modals.md +++ b/docs/english/guides/modals.md @@ -8,7 +8,7 @@ lang: en ## Slack app configuration -The first step to use modals in your app is to enable interactive components. Visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Interactivity & Shortcuts** on the left pane. There are three things to do on the page. +The first step to use modals in your app is to enable interactive components. Visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Interactivity & Shortcuts** on the left pane. There are three things to do on the page. * Turn on the feature * Set the **Request URL** to `https://{your app's public URL domain}/slack/events` (this step is not required for Socket Mode apps) diff --git a/docs/english/guides/scim-api.md b/docs/english/guides/scim-api.md index 8e0cdc172..524897b7d 100644 --- a/docs/english/guides/scim-api.md +++ b/docs/english/guides/scim-api.md @@ -20,7 +20,7 @@ import com.slack.api.Slack; import com.slack.api.scim.*; Slack slack = Slack.getInstance(); -String token = System.getenv("SLACK_ADMIN_ACCESS_TOKN"); // `admin` scope required +String token = System.getenv("SLACK_ADMIN_ACCESS_TOKEN"); // `admin` scope required SCIMClient scim = slack.scim(token); ``` diff --git a/docs/english/guides/shortcuts.md b/docs/english/guides/shortcuts.md index 57e6343af..937584e21 100644 --- a/docs/english/guides/shortcuts.md +++ b/docs/english/guides/shortcuts.md @@ -15,7 +15,7 @@ Your app has 3 seconds to call `ack()`, which acknowledges a shortcut request is ### Slack app configuration -To enable shortcuts, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Interactivity & Shortcuts** on the left pane. There are four things to do on the page. +To enable shortcuts, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Interactivity & Shortcuts** on the left pane. There are four things to do on the page. * Turn on the feature * Set the **Request URL** to `https://{your app's public URL domain}/slack/events` (this step is not required for Socket Mode apps) diff --git a/docs/english/guides/slash-commands.md b/docs/english/guides/slash-commands.md index bb3c0433d..9c03668e8 100644 --- a/docs/english/guides/slash-commands.md +++ b/docs/english/guides/slash-commands.md @@ -10,7 +10,7 @@ Responding to slash command invocations is a common use case. Your app has to re ## Slack app configuration -To enable slash commands, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, go to **Features** > **Slash Commands** on the left pane. There are a few things to do there on the page. +To enable slash commands, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, go to **Features** > **Slash Commands** on the left pane. There are a few things to do there on the page. * Click **Create New Command** button * Input the command information on the dialog: diff --git a/docs/english/guides/socket-mode.md b/docs/english/guides/socket-mode.md index d45dd8138..b7cdf1bbe 100644 --- a/docs/english/guides/socket-mode.md +++ b/docs/english/guides/socket-mode.md @@ -8,7 +8,7 @@ With [Socket Mode](/apis/events-api/using-socket-mode), instead of creating a se ## Slack app configuration -To enable Socket Mode, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Settings** on the left pane. There are a few things to do on the page. +To enable Socket Mode, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Settings** on the left pane. There are a few things to do on the page. * Go to **Settings** > **Basic Information** * Add a new **App-Level Token** with the [`connections:write`](/reference/scopes/connections.write) scope diff --git a/docs/english/guides/steps-from-apps.md b/docs/english/guides/steps-from-apps.md index 098faf837..c1aa4d64a 100644 --- a/docs/english/guides/steps-from-apps.md +++ b/docs/english/guides/steps-from-apps.md @@ -24,7 +24,7 @@ All three events must be handled for a workflow step to function. ### Slack app configuration -To enable Steps from Apps, visit the [Slack app settings page](http://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Workflow Steps** on the left pane. There are two things to do on the page. +To enable Steps from Apps, visit the [Slack app settings page](https://api.slack.com/apps), choose the app you're working on, and go to **Features** > **Workflow Steps** on the left pane. There are two things to do on the page. * Turn on the feature (**Turn on workflow steps**) * Click the **Add Step** button and set the name and Callback ID diff --git a/docs/english/guides/supported-web-frameworks.md b/docs/english/guides/supported-web-frameworks.md index 937844e8f..fb952b0df 100644 --- a/docs/english/guides/supported-web-frameworks.md +++ b/docs/english/guides/supported-web-frameworks.md @@ -227,8 +227,9 @@ The simplest way is to have some code that initializes the **App** instance in a package hello; import com.slack.api.bolt.App; +import com.slack.api.bolt.AppConfig; import io.micronaut.context.annotation.Factory; -import javax.inject.Singleton; +import jakarta.inject.Singleton; @Factory public class AppFactory { diff --git a/docs/english/guides/web-api-basics.md b/docs/english/guides/web-api-basics.md index ca6bc398e..7dec1d23b 100644 --- a/docs/english/guides/web-api-basics.md +++ b/docs/english/guides/web-api-basics.md @@ -479,4 +479,4 @@ config.getHttpClientResponseHandlers().add(new ResponsePrettyPrintingListener()) Slack slack = Slack.getInstance(config); ``` -You may encounter situations where more configurable options or flexibilities while making real-world applications would be helpful. If you have feature requests, go to our [GitHub Issue Tracker](http://github.com/slackapi/java-slack-sdk/issues) and tell us about it. +You may encounter situations where more configurable options or flexibilities while making real-world applications would be helpful. If you have feature requests, go to our [GitHub Issue Tracker](https://github.com/slackapi/java-slack-sdk/issues) and tell us about it. diff --git a/docs/english/index.md b/docs/english/index.md index c81d13742..25704c0f1 100644 --- a/docs/english/index.md +++ b/docs/english/index.md @@ -20,7 +20,7 @@ These docs have lots of information on Bolt for Java and the Java Slack SDK. The If you get stuck, we're here to help. The following are the best ways to get assistance working through your issue: -* Visit the [Issue Tracker](http://github.com/slackapi/java-slack-sdk/issues) for questions, bug reports, feature requests, and general discussion related to Bolt for Java. Try searching for an existing issue before creating a new one. +* Visit the [Issue Tracker](https://github.com/slackapi/java-slack-sdk/issues) for questions, bug reports, feature requests, and general discussion related to Bolt for Java. Try searching for an existing issue before creating a new one. * Visit the [Slack Developer Community](https://slackcommunity.com/) for getting help or for bonding with your fellow Slack developers. * [Email](mailto:support@slack.com) our developer support team: `support@slack.com`. diff --git a/docs/japanese/guides/app-distribution.md b/docs/japanese/guides/app-distribution.md index 56084fc0b..6ea81f777 100644 --- a/docs/japanese/guides/app-distribution.md +++ b/docs/japanese/guides/app-distribution.md @@ -7,7 +7,7 @@ ### Slack アプリの設定 -アプリの配布を有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Settings** > **Manage Distribution** へ遷移します。ページの説明に従って設定を行います。 +アプリの配布を有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Settings** > **Manage Distribution** へ遷移します。ページの説明に従って設定を行います。 **Redirect URL** については Bolt for Java では `https://{あなたのドメイン}/slack/oauth/callback` のような URL で応答します。この URL を変更する方法などはこのページのあとのセクションの一覧を参照してください。 @@ -36,7 +36,6 @@ import com.slack.api.bolt.App; import com.slack.api.bolt.jetty.SlackAppServer; import java.util.HashMap; import java.util.Map; -import static java.util.Map.entry; // Slack API からのペイロードリクエストを処理する App // 環境変数 SLACK_SIGNING_SECRET が存在する前提 @@ -53,10 +52,10 @@ apiApp.command("/hi", (req, ctx) -> { App oauthApp = new App().asOAuthApp(true); // これら二つの App をルーとパスの指定とともにマウント -SlackAppServer server = new SlackAppServer(new HashMap<>(Map.ofEntries( - entry("/slack/events", apiApp), // POST /slack/events (Slack API からのリクエストのみ) - entry("/slack/oauth", oauthApp) // GET /slack/oauth/start, /slack/oauth/callback (ユーザーがブラウザーでアクセス) -))); +Map apps = new HashMap<>(); +apps.put("/slack/events", apiApp); // POST /slack/events (Slack API からのリクエストのみ) +apps.put("/slack/oauth", oauthApp); // GET /slack/oauth/start, /slack/oauth/callback (ユーザーがブラウザーでアクセス) +SlackAppServer server = new SlackAppServer(apps); server.start(); // http://localhost:3000 ``` @@ -102,7 +101,6 @@ import com.slack.api.bolt.service.builtin.AmazonS3OAuthStateService; import java.util.HashMap; import java.util.Map; -import static java.util.Map.entry; // 標準的な AWS の環境変数が設定済であることが前提 // export AWS_REGION=us-east-1 @@ -134,10 +132,10 @@ OAuthStateService stateService = new AmazonS3OAuthStateService(awsS3BucketName); oauthApp.service(stateService); // ルーとパスとともに二つの App をマウント -SlackAppServer server = new SlackAppServer(new HashMap<>(Map.ofEntries( - entry("/slack/events", apiApp), // POST /slack/events (Slack API からのリクエストのみ) - entry("/slack/oauth", oauthApp) // GET /slack/oauth/start, /slack/oauth/callback (ユーザーがブラウザーでアクセス) -))); +Map apps = new HashMap<>(); +apps.put("/slack/events", apiApp); // POST /slack/events (Slack API からのリクエストのみ) +apps.put("/slack/oauth", oauthApp); // GET /slack/oauth/start, /slack/oauth/callback (ユーザーがブラウザーでアクセス) +SlackAppServer server = new SlackAppServer(apps); server.start(); // http://localhost:3000 ``` @@ -270,7 +268,7 @@ app.event(TokensRevokedEvent.class, app.defaultTokensRevokedEventHandler()); app.event(AppUninstalledEvent.class, app.defaultAppUninstalledEventHandler()); ``` -あなたが実装したカスタムの `InstallationService` の実装クラスをこれらの組み込みのイベントハンドラーと連携して動作させるためには、[`InstallationService` インターフェース](https://github.com/seratch/java-slack-sdk/blob/main/bolt/src/main/java/com/slack/api/bolt/service/InstallationService.java)に定義されている以下のメソッドを適切に実装してください: +あなたが実装したカスタムの `InstallationService` の実装クラスをこれらの組み込みのイベントハンドラーと連携して動作させるためには、[`InstallationService` インターフェース](https://github.com/slackapi/java-slack-sdk/blob/main/bolt/src/main/java/com/slack/api/bolt/service/InstallationService.java)に定義されている以下のメソッドを適切に実装してください: * `void deleteBot(Bot bot)` * `void deleteInstaller(Installer installer)` diff --git a/docs/japanese/guides/app-home.md b/docs/japanese/guides/app-home.md index d21d5f3f6..868716646 100644 --- a/docs/japanese/guides/app-home.md +++ b/docs/japanese/guides/app-home.md @@ -4,7 +4,7 @@ ### Slack アプリの設定 -Home タブを有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **App Home** へ遷移します。画面を少し下スクロールすると見つかる **Home Tab** を有効化します。 +Home タブを有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **App Home** へ遷移します。画面を少し下スクロールすると見つかる **Home Tab** を有効化します。 イベント API を有効にするには、左ペインの **Features** > **Event Subscriptions** へ遷移します。この画面でいくつかやることがあります。 diff --git a/docs/japanese/guides/audit-logs-api.md b/docs/japanese/guides/audit-logs-api.md index befb84ee7..55ccbcd01 100644 --- a/docs/japanese/guides/audit-logs-api.md +++ b/docs/japanese/guides/audit-logs-api.md @@ -16,7 +16,7 @@ import com.slack.api.Slack; import com.slack.api.audit.*; Slack slack = Slack.getInstance(); -String token = System.getenv("SLACK_ADMIN_ACCESS_TOKN"); // `auditlogs:read` scope が必要 +String token = System.getenv("SLACK_ADMIN_ACCESS_TOKEN"); // `auditlogs:read` scope が必要 AuditClient audit = slack.audit(token); ``` @@ -86,7 +86,7 @@ import com.slack.api.audit.*; import com.slack.api.audit.response.LogsResponse; import java.util.concurrent.CompletableFuture; -String token = System.getenv("SLACK_ADMIN_ACCESS_TOKN"); // `auditlogs:read` scope が必要 +String token = System.getenv("SLACK_ADMIN_ACCESS_TOKEN"); // `auditlogs:read` scope が必要 AsyncAuditClient audit = Slack.getInstance().auditAsync(token); CompletableFuture response = audit.getLogs(req -> req diff --git a/docs/japanese/guides/events-api.md b/docs/japanese/guides/events-api.md index 68f4e6514..d23cf1430 100644 --- a/docs/japanese/guides/events-api.md +++ b/docs/japanese/guides/events-api.md @@ -4,7 +4,7 @@ ### Slack アプリの設定 -イベント API を有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Event Subscriptions** へ遷移します。この画面でいくつかやることがあります。 +イベント API を有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Event Subscriptions** へ遷移します。この画面でいくつかやることがあります。 * **Enable Events** を Off から On にする * `https://{あなたのドメイン}/slack/events` を **Request URL** に設定 (ソケットモードの場合、この手順は不要です) diff --git a/docs/japanese/guides/getting-started-with-bolt-socket-mode.md b/docs/japanese/guides/getting-started-with-bolt-socket-mode.md index 323fb6bb5..477d9992e 100644 --- a/docs/japanese/guides/getting-started-with-bolt-socket-mode.md +++ b/docs/japanese/guides/getting-started-with-bolt-socket-mode.md @@ -50,7 +50,7 @@ org.java-websocket Java-WebSocket - 1.5.1 + 1.6.0 ``` @@ -162,8 +162,8 @@ new SocketModeApp(app).start(); |環境変数名|説明| |-|-| -|**SLACK_BOT_TOKEN**|開発用ワークスペース(Development Workspace)での有効なボットトークン(形式は `xoxb-` から始まります)です。このボットトークンを発行するには Slack アプリを開発用ワークスペースにインストールする必要があります。[Slack アプリ管理画面](http://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Install App** から実行します(「Please add at least one feature or permission scope to install your app.」というメッセージが表示されている場合は [`app_mentions:read`](/reference/scopes/app_mentions.read) bot scope を追加してください)。

複数のワークスペースにインストール可能なアプリとして実行する場合はこの環境変数を設定する必要はありません。そのようなアプリの開発については「[アプリの配布 (OAuth)](/tools/java-slack-sdk/guides/app-distribution)」を参考にしてください。| -|**SLACK_APP_TOKEN**|この Slack アプリの有効なアプリレベルトークン(形式は `xapp-` から始まります)です。トークンを発行するには、[Slack アプリ管理画面](http://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Basic Information** > **App-Level Tokens** へ移動し、`connections:write` というスコープにしたトークンを作成します。| +|**SLACK_BOT_TOKEN**|開発用ワークスペース(Development Workspace)での有効なボットトークン(形式は `xoxb-` から始まります)です。このボットトークンを発行するには Slack アプリを開発用ワークスペースにインストールする必要があります。[Slack アプリ管理画面](https://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Install App** から実行します(「Please add at least one feature or permission scope to install your app.」というメッセージが表示されている場合は [`app_mentions:read`](/reference/scopes/app_mentions.read) bot scope を追加してください)。

複数のワークスペースにインストール可能なアプリとして実行する場合はこの環境変数を設定する必要はありません。そのようなアプリの開発については「[アプリの配布 (OAuth)](/tools/java-slack-sdk/guides/app-distribution)」を参考にしてください。| +|**SLACK_APP_TOKEN**|この Slack アプリの有効なアプリレベルトークン(形式は `xapp-` から始まります)です。トークンを発行するには、[Slack アプリ管理画面](https://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Basic Information** > **App-Level Tokens** へ移動し、`connections:write` というスコープにしたトークンを作成します。| なお、**App** を別の方法(例: 規定の環境変数名を使わない)で初期化したい場合は **AppConfig** を自前で初期化するコードを書いてください。 diff --git a/docs/japanese/guides/getting-started-with-bolt.md b/docs/japanese/guides/getting-started-with-bolt.md index a20af8423..e9fdd88e8 100644 --- a/docs/japanese/guides/getting-started-with-bolt.md +++ b/docs/japanese/guides/getting-started-with-bolt.md @@ -150,8 +150,8 @@ server.start(); |環境変数名|説明| |-|-| -|**SLACK_BOT_TOKEN**|開発用ワークスペース(Development Workspace)での有効なボットトークン(形式は `xoxb-` から始まります)です。このボットトークンを発行するには Slack アプリを開発用ワークスペースにインストールする必要があります。[Slack アプリ管理画面](http://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Install App** から実行します(「Please add at least one feature or permission scope to install your app.」というメッセージが表示されている場合は [`app_mentions:read`](/reference/scopes/app_mentions.read) bot scope を追加してください)。

複数のワークスペースにインストール可能なアプリとして実行する場合はこの環境変数を設定する必要はありません。そのようなアプリの開発については「[アプリの配布 (OAuth)](/tools/java-slack-sdk/guides/app-distribution)」を参考にしてください。| -|**SLACK_SIGNING_SECRET**|この秘密の値は Slack プラットフォームとだけ共有する情報です。これは Slack アプリが受けたリクエストが本当に Slack API サーバーからのリクエストであるかを検証するために使用します。Slack アプリは公開されたエンドポイントを持つため、リクエストの検証はセキュリティのために重要です。この値は [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Basic Information** へ遷移して **App Credentials** > **Signing Secret** の情報を表示させると確認できます。より詳細な情報は「[Verifying requests from Slack(英語)](/authentication/verifying-requests-from-slack)」を参考にしてください。| +|**SLACK_BOT_TOKEN**|開発用ワークスペース(Development Workspace)での有効なボットトークン(形式は `xoxb-` から始まります)です。このボットトークンを発行するには Slack アプリを開発用ワークスペースにインストールする必要があります。[Slack アプリ管理画面](https://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Install App** から実行します(「Please add at least one feature or permission scope to install your app.」というメッセージが表示されている場合は [`app_mentions:read`](/reference/scopes/app_mentions.read) bot scope を追加してください)。

複数のワークスペースにインストール可能なアプリとして実行する場合はこの環境変数を設定する必要はありません。そのようなアプリの開発については「[アプリの配布 (OAuth)](/tools/java-slack-sdk/guides/app-distribution)」を参考にしてください。| +|**SLACK_SIGNING_SECRET**|この秘密の値は Slack プラットフォームとだけ共有する情報です。これは Slack アプリが受けたリクエストが本当に Slack API サーバーからのリクエストであるかを検証するために使用します。Slack アプリは公開されたエンドポイントを持つため、リクエストの検証はセキュリティのために重要です。この値は [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスして、開発中のアプリを選択、左ペインの **Settings** > **Basic Information** へ遷移して **App Credentials** > **Signing Secret** の情報を表示させると確認できます。より詳細な情報は「[Verifying requests from Slack(英語)](/authentication/verifying-requests-from-slack)」を参考にしてください。| なお、**App** を別の方法(例: 規定の環境変数名を使わない)で初期化したい場合は **AppConfig** を自前で初期化するコードを書いてください。 diff --git a/docs/japanese/guides/incoming-webhooks.md b/docs/japanese/guides/incoming-webhooks.md index 182094bf6..b9075351e 100644 --- a/docs/japanese/guides/incoming-webhooks.md +++ b/docs/japanese/guides/incoming-webhooks.md @@ -4,7 +4,7 @@ ### Slack アプリ設定 -この機能を有効にするためには [Slack アプリ管理画面](http://api.slack.com/apps) にアクセスして、そこから開発しているアプリを選択します。そして、左ペインの **Features** > **Incoming Webhooks** に遷移し **Activate Incoming Webhooks** を On に変更して有効化します。 +この機能を有効にするためには [Slack アプリ管理画面](https://api.slack.com/apps) にアクセスして、そこから開発しているアプリを選択します。そして、左ペインの **Features** > **Incoming Webhooks** に遷移し **Activate Incoming Webhooks** を On に変更して有効化します。 その次に、そのアプリを開発用ワークスペース(Development Workspace)にインストールします。アプリをインストールする度に新しい Webhook の URL が発行されます。 diff --git a/docs/japanese/guides/interactive-components.md b/docs/japanese/guides/interactive-components.md index b7a4f1a7d..c4c012bce 100644 --- a/docs/japanese/guides/interactive-components.md +++ b/docs/japanese/guides/interactive-components.md @@ -6,7 +6,7 @@ ### Slack アプリの設定 -インタラクティブコンポーネントを有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Interactivity & Shortcuts** へ遷移します。このページで以下の設定を行います。 +インタラクティブコンポーネントを有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Interactivity & Shortcuts** へ遷移します。このページで以下の設定を行います。 * **Interactivity** を Off から On にする * `https://{あなたのドメイン}/slack/events` を **Request URL** に設定 (ソケットモードの場合、この手順は不要です) diff --git a/docs/japanese/guides/modals.md b/docs/japanese/guides/modals.md index 4a57e24b7..a437a32d3 100644 --- a/docs/japanese/guides/modals.md +++ b/docs/japanese/guides/modals.md @@ -4,7 +4,7 @@ ### Slack アプリの設定 -モーダルを使うための最初のステップは、[インタラクティブコンポーネント](/tools/java-slack-sdk/guides/interactive-components)を有効にすることです。[Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Interactivity & Shortcuts** へ遷移します。このページで以下の設定を行います。 +モーダルを使うための最初のステップは、[インタラクティブコンポーネント](/tools/java-slack-sdk/guides/interactive-components)を有効にすることです。[Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Interactivity & Shortcuts** へ遷移します。このページで以下の設定を行います。 * **Interactivity** を Off から On にする * `https://{あなたのドメイン}/slack/events` を **Request URL** に設定 (ソケットモードの場合、この手順は不要です) diff --git a/docs/japanese/guides/scim-api.md b/docs/japanese/guides/scim-api.md index cd76fd267..85bdc4aa1 100644 --- a/docs/japanese/guides/scim-api.md +++ b/docs/japanese/guides/scim-api.md @@ -16,7 +16,7 @@ import com.slack.api.Slack; import com.slack.api.scim.*; Slack slack = Slack.getInstance(); -String token = System.getenv("SLACK_ADMIN_ACCESS_TOKN"); // `admin` scope が必要 +String token = System.getenv("SLACK_ADMIN_ACCESS_TOKEN"); // `admin` scope が必要 SCIMClient scim = slack.scim(token); ``` diff --git a/docs/japanese/guides/shortcuts.md b/docs/japanese/guides/shortcuts.md index 1d04c50cc..6601651b6 100644 --- a/docs/japanese/guides/shortcuts.md +++ b/docs/japanese/guides/shortcuts.md @@ -9,7 +9,7 @@ Slack アプリは 3 秒以内に `ack()` メソッドでショッートカッ #### Slack アプリの設定 -ショートカットを有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Interactivity & Shortcuts** へ遷移します。このページで以下の設定を行います。 +ショートカットを有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Interactivity & Shortcuts** へ遷移します。このページで以下の設定を行います。 * **Interactivity** を Off から On にする * `https://{あなたのドメイン}/slack/events` を **Request URL** に設定 (ソケットモードの場合、この手順は不要です) diff --git a/docs/japanese/guides/slash-commands.md b/docs/japanese/guides/slash-commands.md index 7c07ef289..5c85505dc 100644 --- a/docs/japanese/guides/slash-commands.md +++ b/docs/japanese/guides/slash-commands.md @@ -6,7 +6,7 @@ ### Slack アプリの設定 -スラッシュコマンドを有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Slash Commands** へ遷移します。このページで以下の設定を行います。 +スラッシュコマンドを有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Slash Commands** へ遷移します。このページで以下の設定を行います。 * **Create New Command** ボタンをクリック * ダイアログ内で必要なコマンドの情報を入力 diff --git a/docs/japanese/guides/socket-mode.md b/docs/japanese/guides/socket-mode.md index c6e536bc1..5b5f8122d 100644 --- a/docs/japanese/guides/socket-mode.md +++ b/docs/japanese/guides/socket-mode.md @@ -4,7 +4,7 @@ ### Slack アプリの設定 -ソケットモードを有効にするには、[Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Settings** へ遷移します。この画面でいくつかやることがあります。 +ソケットモードを有効にするには、[Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Settings** へ遷移します。この画面でいくつかやることがあります。 * **Settings** > **Basic Information** へ遷移 * **App-Level Token** に [`connections:write`](/reference/scopes/connections.write) スコープが付与されたものを一つ追加 diff --git a/docs/japanese/guides/steps-from-apps.md b/docs/japanese/guides/steps-from-apps.md index ab445ce3c..c476a0af5 100644 --- a/docs/japanese/guides/steps-from-apps.md +++ b/docs/japanese/guides/steps-from-apps.md @@ -14,7 +14,7 @@ ### Slack アプリの設定 -ワークフローステップを有効にするには [Slack アプリ管理画面](http://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Workflow Steps** へ遷移します。このページで以下の設定を行います。 +ワークフローステップを有効にするには [Slack アプリ管理画面](https://api.slack.com/apps)にアクセスし、開発中のアプリを選択、左ペインの **Features** > **Workflow Steps** へ遷移します。このページで以下の設定を行います。 * 機能を有効にします (**Turn on workflow steps**) * **Add Step** ボタンをクリックして、ステップの **Name** と **Callback ID** を設定します。 diff --git a/docs/japanese/guides/supported-web-frameworks.md b/docs/japanese/guides/supported-web-frameworks.md index 7e003e992..b8a6c9c13 100644 --- a/docs/japanese/guides/supported-web-frameworks.md +++ b/docs/japanese/guides/supported-web-frameworks.md @@ -224,8 +224,9 @@ public class Application { package hello; import com.slack.api.bolt.App; +import com.slack.api.bolt.AppConfig; import io.micronaut.context.annotation.Factory; -import javax.inject.Singleton; +import jakarta.inject.Singleton; @Factory public class AppFactory {