Skip to content

version 1.2.0

Choose a tag to compare

@seratch seratch released this 06 Oct 07:06
· 1508 commits to main since this release

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_SECRET

Changes

  • [bolt] #569 #571 #574 Steps from Apps support - Thanks @seratch @misscoded
  • [bolt] #572 Add appId to Installer and Bot model 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