slack-next-generation-platform-tutorials VS deno-slack-sdk

Tutorials I wrote: https://dev.to/seratch/series/21161

While it has become easier to automate within Slack, there are things that cannot be done with existing app development. For example, as of 2023, you cannot add slash commands to the entire workspace or set a home tab for users. Also, note that this next-generation platform feature is only available in paid Slack workspaces, and usage charges apply for workflow executions that exceed the free tier. For more details, please read the series of articles I wrote a few months ago: https://dev.to/seratch/series/21161

The complete project is available at https://github.com/seratch/slack-next-generation-platform-tutorials/tree/main/01_The_Simplest_Hello_World

The official documents: https://api.slack.com/automation

This article guides you on how to build a remote function for Slack's automation platform on Cloudflare Workers. The slack-cloudflare-workers library provides the toolset for swiftly creating such an app in TypeScript.

By the way, since the beginning of this year (2023), a new app development mechanism for extending the Workflow Builder, called the next-generation automation platform, has been added to the Slack platform.

$ cd frosty-mink-263 $ slack run ? Choose a workspace seratch T03E94MJU App is not installed to this workspace Updating dev app install for workspace "Acme Corp" ⚠️ Outgoing domains No allowed outgoing domains are configured If your function makes network requests, you will need to allow the outgoing domains Learn more about upcoming changes to outgoing domains: https://api.slack.com/future/changelog ✨ seratch of Acme Corp Connected, awaiting events

$ slack run ? Choose a workspace seratch T03E94MJU objective-fox-22 A04G9S43G2K Updating dev app install for workspace "Acme Corp" ⚠️ Outgoing domains No allowed outgoing domains are configured If your function makes network requests, you will need to allow the outgoing domains Learn more about upcoming changes to outgoing domains: https://api.slack.com/future/changelog ✨ seratch of Acme Corp Connected, awaiting events 2022-12-27 17:10:46 [info] [Fn04GHQFQMC6] (Trace=Tr04GQD13VH8) Function execution started for workflow function 'Scheduled Trigger Demo Workflow' 2022-12-27 17:10:46 [info] [Wf04H31WBE1X] (Trace=Tr04GSSF1CTE) Execution started for workflow 'Scheduled Trigger Demo Workflow' 2022-12-27 17:10:46 [info] [Fn04GHQFQMC6] (Trace=Tr04GQD13VH8) Function execution completed for function 'Scheduled Trigger Demo Workflow' 2022-12-27 17:10:46 [info] [Wf04H31WBE1X] (Trace=Tr04GSSF1CTE) Execution completed for workflow 'Scheduled Trigger Demo Workflow'

$ slack datastore --help Query an App Datastore USAGE $ slack datastore [flags] SUBCOMMANDS delete Delete a datastore item. Docs: https://api.slack.com/future/ get Get an item from the slack datastore. Docs: https://api.slack.com/future/ put Create/Update an App Datastore. Docs: https://api.slack.com/future/ query Query for datastore items. Docs: https://api.slack.com/future/ FLAGS -h, --help help for datastore GLOBAL FLAGS --apihost string Slack API host -f, --force ignore warnings and continue executing command -l, --local-run run use the local run app created by the run command. -r, --runtime string project's runtime language: deno, deno1.1, deno1.x, etc (Default: deno) -s, --skip-update skip checking for latest version of CLI --slackdev use the Slack Dev API (--apihost=dev.slack.com) -v, --verbose when set print debug logging -w, --workspace string use a specific workspace by domain name EXAMPLE $ slack datastore put '{"datastore": "todos", "app": "A0123A45BCD", "item": {"id": "42", "description": "Create a PR", "status": "Done"}}' ADDITIONAL HELP $ slack datastore --help for more information about a specific command. For more information, read the documentation: https://api.slack.com/future

The only Slack next-gen app specific part is SlackFunctionTester and its createContext utility. This utility helps you easily build valid arguments for a function. The utility is a quite simple library. It never prevents you from having various test patterns, so you can pass any test data as inputs, env, token, and others.