Slack Next-gen Platform - External API Calls

$ slack create? Select a template to build from:  Hello World  A simple workflow that sends a greeting  Scaffolded project  A solid foundational project that uses a Slack datastore> Blank project  A, well.. blank project  To see all available samples, visit github.com/slack-samples.

$ cd zealous-elk-261$ slack run? Choose a workspace  seratch  T03E94MJU   App is not installed to this workspaceUpdating 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 CorpConnected, awaiting events

// -------------------------// Workflow definition// -------------------------import { DefineWorkflow, Schema } from "deno-slack-sdk/mod.ts";export const workflow = DefineWorkflow({  callback_id: "translator-workflow",  title: "Translator Workflow",  input_parameters: {    properties: {      // The channel to post the translation result      channel_id: { type: Schema.slack.types.channel_id },      // Need this to open a form      interactivity: { type: Schema.slack.types.interactivity },    },    required: ["channel_id", "interactivity"],  },});// TODO: Add function steps to the workflow// -------------------------// Trigger Definition// -------------------------import { Trigger } from "deno-slack-api/types.ts";// This trigger starts the workflow when an end-user clicks the linkconst trigger: Trigger<typeof workflow.definition> = {  type: "shortcut",  name: "Translator Trigger",  workflow: `#/workflows/${workflow.definition.callback_id}`,  inputs: {    // The channel where an end-user clicks the link    channel_id: { value: "{{data.channel_id}}" },    // This input is required for opening a form within the workflow    interactivity: { value: "{{data.interactivity}}" },  },};// As long as the trigger object is default exported,// you can generate a trigger with this code:// $ slack triggers create --trigger-def ./workflow_and_trigger.tsexport default trigger;

import { Manifest } from "deno-slack-sdk/mod.ts";import { workflow as TranslatorWorkflow } from "./workflow_and_trigger.ts";export default Manifest({  name: "zealous-elk-261",  description: "Translate text in Slack",  icon: "assets/default_new_app_icon.png",  // Add your workflow to this list  workflows: [TranslatorWorkflow],  // All the domains except slack.com must be listed  outgoingDomains: [    "api-free.deepl.com", // only for free tier usage    "api.deepl.com",  ],  botScopes: ["commands", "chat:write", "chat:write.public"],});

$ slack triggers create --trigger-def ./workflow_and_trigger.ts? Choose an app  [Use arrows to move, type to filter]   seratch  T03E94MJU   App is not installed to this workspace>  seratch (dev)  T03E94MJU   zealous-elk-261 (dev) A04DHV08MPF

$ slack triggers create --trigger-def ./workflow_and_trigger.ts? Choose an app  seratch (dev)  T03E94MJU   zealous-elk-261 (dev) A04DHV08MPF Trigger created   Trigger ID:   Ft04DEBXXXX   Trigger Type: shortcut   Trigger Name: Translator Trigger   URL: https://slack.com/shortcuts/Ft04DEBXXXXX/YYYY

import { DefineFunction, Schema, SlackFunction } from "deno-slack-sdk/mod.ts";import { FunctionSourceFile } from "https://deno.land/x/[email protected]/mod.ts";// The metadata definition for the translator functionexport const def = DefineFunction({  callback_id: "translate",  title: "Translate",  description: "Translate text using DeepL's API",  // This example code uses a 3rd party module "deno_slack_source_file_resolver"  // to automatically resolve the relative path of this source file.  source_file: FunctionSourceFile(import.meta.url),  input_parameters: {    properties: {      text: { type: Schema.types.string },      source_lang: { type: Schema.types.string }, // optional      target_lang: { type: Schema.types.string },    },    required: ["text", "target_lang"],  },  output_parameters: {    properties: { translated_text: { type: Schema.types.string } },    required: ["translated_text"],  },});export default SlackFunction(def, async ({ inputs, env }) => {  // When running a dev version of your app,  // placing `.env` file with variables is the way to configure `env`.  // As for the deployed prod one, you need to run  // `slack env add DEEPL_AUTH_KEY (value)` before running the app's workflow.  const authKey = env.DEEPL_AUTH_KEY;  if (!authKey) {    // Since it's impossible to continue in this case, this function returns an error.    const error =      "DEEPL_AUTH_KEY env value is missing! Please add `.env` file for `slack run`. If you've already deployed this app, `slack env add DEEPL_AUTH_KEY (value)` command configures the env variable for you.";    return { error };  }  // Build an HTTP request towards DeepL's text translation API  const subdomain = authKey.endsWith(":fx") ? "api-free" : "api";  const deeplApiUrl = `https://${subdomain}.deepl.com/v2/translate`;  const body = new URLSearchParams();  body.append("auth_key", authKey);  body.append("text", inputs.text);  if (inputs.source_lang) { // this input is optional    body.append("source_lang", inputs.source_lang.toUpperCase());  }  body.append("target_lang", inputs.target_lang.toUpperCase());  // When there is no Deno library to perform external API calls,  // simply using the built-in `fetch` function is recommended.  const response = await fetch(deeplApiUrl, {    method: "POST",    headers: {      "content-type": "application/x-www-form-urlencoded;charset=utf-8",    },    body,  });  const status = response.status;  if (status != 200) {    const body = await response.text();    const error = `DeepL API error (status: ${status}, body: ${body})`;    return { error };  }  // When the translation succeeds, the response body is JSON data.  const result = await response.json();  if (!result || result.translations.length === 0) {    const error = `Translation failed: ${JSON.stringify(result)}`;    return { error };  }  // When it's successful, the outputs must include "translated_text" as it's required.  return { outputs: { translated_text: result.translations[0].text } };});

DEEPL_AUTH_KEY=[your auth key here]

// Receive the original text and which language to translate intoconst formStep = workflow.addStep(Schema.slack.functions.OpenForm, {  title: "Run DeepL Translator",  // To use this built-in function,  // either a preceding function or the trigger of workflow  // must provide interactivity in inputs.  interactivity: workflow.inputs.interactivity,  submit_label: "Translate",  // The fields are similar to Block Kit, but some differences exist.  // Refer to https://api.slack.com/future/forms#type-parameters for details.  fields: {    elements: [      {        name: "text",        title: "Original Text",        type: Schema.types.string,      },      {        name: "target_lang",        title: "Target Language",        type: Schema.types.string,        description: "Select the language to translate into",        enum: [          "English",          "Japanese",          "Korean",          "Chinese",          "Italian",          "French",          "Spanish",        ],        choices: [          { value: "en", title: "English" },          { value: "ja", title: "Japanese" },          { value: "kr", title: "Korean" },          { value: "zh", title: "Chinese" },          { value: "it", title: "Italian" },          { value: "fr", title: "French" },          { value: "es", title: "Spanish" },        ],        default: "en",      },    ],    required: ["text", "target_lang"],  },});// Import your translator function and add it to this workflowimport { def as translate } from "./function.ts";const translateStep = workflow.addStep(translate, {  text: formStep.outputs.fields.text,  target_lang: formStep.outputs.fields.target_lang,});// Post the translation result using the built-in message functionworkflow.addStep(Schema.slack.functions.SendMessage, {  channel_id: workflow.inputs.channel_id,  message:    `>${formStep.outputs.fields.text}
${translateStep.outputs.translated_text}`,});