version 1.2.0
New Features
Steps from Apps
Workflow Steps from apps allow your app to create and process custom workflow steps that users can add using Workflow Builder. Check the document for details: https://slack.dev/java-slack-sdk/guides/steps-from-apps
import com.slack.api.bolt.App;
import com.slack.api.bolt.middleware.builtin.WorkflowStep;
App app = new App();
WorkflowStep step = WorkflowStep.builder()
.callbackId("copy_review")
.edit((req, ctx) -> { return ctx.ack(); })
.save((req, ctx) -> { return ctx.ack(); })
.execute((req, ctx) -> { return ctx.ack(); })
.build();
app.step(step);If you are a Koltin developer, try the Kotlin extensions out! With the optional modules, building Workflow Steps can be even more concise!
val step = WorkflowStep.builder()
.callbackId("copy_review")
.edit { _, ctx ->
ctx.configure(withBlocks {
input {
blockId("task_name_input")
element {
plainTextInput {
actionId("task_name")
placeholder("Write a task name")
}
}
label("Task name")
}
})
ctx.ack()
}
.save { req, ctx ->
val values = req.payload.view.state.values
val inputs = mapOf("taskName" to stepInput { it.value(values["task_name_input"]?.get("task_name")?.value) })
val outputs = listOf(stepOutput { it.name("taskName").type("text").label("Task Name") })
ctx.update(inputs, outputs)
ctx.ack()
}
.executeAutoAcknowledgement(false)
.execute { req, ctx ->
val step = req.payload.event.workflowStep
GlobalScope.async {
try {
val email = step.inputs["taskAuthorEmail"]?.value.toString()
val outputs = mapOf("taskName" to step.inputs["taskName"]?.value)
ctx.complete(outputs)
} catch (e: Exception) {
ctx.fail(mapOf("message" to "Something wrong! ($e)"))
}
}
ctx.ack()
}
.build()
val app = App()
app.step(step)New Events API Payload Support
Events will no longer contain full lists of authed_users or authed_teams
https://api.slack.com/changelog/2020-09-15-events-api-truncate-authed-users
Since this version, this SDK supports newly added authorizations and is_ext_shared_channel fields in Events API payloads. Also, the slack-api-client provides the method to call apps.event.authorizations.list API method for fetching the complete set of installations associated with a given event.
If you need a full list of all the parties an event is visible to, you'll call the apps.event.authorizations.list method.
Google Cloud Function extension for Bolt
A new Bolt extension is available for Google Cloud Functions users. This module requires JDK 11+.
package functions;
import com.slack.api.bolt.App;
public class HelloSlack extends SlackApiFunction {
private static final App app = new App();
static {
app.command("/hi", (req, ctx) -> {
return ctx.ack("Hi from Google Cloud Functions!");
});
}
public HelloSlack() { super(app); }
}
// gcloud functions deploy my-first-function \
// --entry-point functions.HelloSlack \
// --runtime java11 --trigger-http --memory 512MB --allow-unauthenticated \
// --set-env-vars SLACK_BOT_TOKEN=$SLACK_BOT_TOKEN,SLACK_SIGNING_SECRET=$SLACK_SIGNING_SECRETChanges
- [bolt] #569 #571 #574 Steps from Apps support - Thanks @seratch @misscoded
- [bolt] #572 Add
appIdtoInstallerandBotmodel classes - Thanks @mihristov @seratch - [bolt] #573 Improve the compatibility with Bolt for JS / Python - Thanks @seratch
- [bolt] #577 Change the fallback behavior of Events API handlers to be compatible with Bolt JS/Python - Thanks @seratch
- [bolt-google-cloud-functions] #498 #550 Add Google Cloud Functions support - Thanks @seratch
- [bolt-helion] Upgrade Helidon SE version from 1.4 to 2.0 - Thanks @seratch
- [slack-app-backend] #576 Add complete support for new Events API payload format - Thanks @seratch
- [slack-api-client] #566 #568 Stop propagation of okhttp's exception message including header values - Thanks @AlexeiZenin @seratch
- [slack-api-client] Add new fields to Audit Logs API response - Thanks @seratch
- [slack-api-client] Upgrade okhttp version from 4.8 to 4.9 - Thanks @seratch
- [*-kotlin-extensions] Upgrade Kotlin language version from 1.3 to 1.4 - Thanks @seratch
- All issues/pull requests: https://github.com/slackapi/java-slack-sdk/milestone/3?closed=1
- All changes: v1.1.6...v1.2.0