スラッシュコマンド ​

Build a Slack bot commandを開始点として使用し、新しいレシピを作成します。 これにより、Workbot for SlackのNew commandトリガーとPost command replyアクションがレシピに追加されます。

新しいSlackボットコマンドを作成

トリガーを選択します。

AppドロップダウンメニューからJiraを選択します。

コマンドが実行するアクションとして、ActionドロップダウンメニューからCreateを選択します。

コマンドで操作するデータとして、Action dataドロップダウンメニューからIssueを選択します。

Parametersフィールドで、Add command inputをクリックします。 このフィールドでは、Jiraプロジェクトキーや課題タイプなど、上流のボットコマンドから受け取ることを想定するパラメーターを定義できます。

次のパラメーターを作成します。

• project_issue_type

  • Label: プロジェクト課題タイプ
  • Data type: 文字列
  • Optional?: いいえ
  • Hint: プロジェクトキーと課題タイプを2つのハイフンで区切って入力します
  • Example input value: IM--Task

• summary

  • Label: 概要
  • Data type: 文字列
  • Optional?: いいえ
  • Hint: Jira課題の概要を入力します

• description

  • Label: 説明
  • Data type: 文字列
  • Optional?: はい
  • Hint: Jira課題の説明を入力します

[
  {
    "control_type": "text",
    "label": "Project issue type",
    "name": "project_issue_type",
    "type": "string",
    "optional": false,
    "hint": "Enter project key and issue type separated by two hyphens",
    "sample": "IM--Task"
  },
  {
    "control_type": "text",
    "label": "Summary",
    "name": "summary",
    "type": "string",
    "optional": false,
    "hint": "Enter the summary for the Jira issue"
  },
  {
    "control_type": "text",
    "label": "Description",
    "name": "description",
    "type": "string",
    "optional": true,
    "hint": "Enter the description for the Jira issue"
  }
]

Slash commandセクションを展開し、Enable Slash CommandをYesに設定します。

Command nameフィールドに/createissueを入力します。 この名前はスラッシュコマンドの呼び出しに使用されます。 コマンド名は/で始まり、スペースを含めることはできません。

トリガー設定の上部までスクロールし、URLをコピーします。 Workatoは、スラッシュコマンドを有効にして有効なコマンド名を入力した後に、このリクエストURLを生成します。

リクエストURLをコピー

任意です。 Auto-reply messageフィールドに入力します。 たとえば、このフィールドにCommand received, working...と入力できます。

コマンドが呼び出されると、Workbot for Slackはこの返信をユーザーのみに自動送信します。 空のままにすると、Workbot for Slackの返信には受信を確認するためにユーザーのコマンドがそのまま反映されます。 このフィールドではデータピルを使用できません。

任意です。 Dialog for missing parametersフィールドでYesを選択します。 これにより、ユーザーはダイアログで不足しているパラメーターを入力できます。

Noを選択すると、Workbotは会話内でこれらの値を収集します。

任意です。 Dialog titleフィールドにCreate new issue in Jiraを入力します。

保存をクリックします。

Slack API Webサイトに移動し、Your appsを選択します。

Enterprise Workbotに対応するアプリを選択します。

Enterpriseボットを選択

Slash Commandsをクリックします。

Create New Commandをクリックします。

Create New Commandを選択

Commandフィールドに/createissueを入力します。

WorkatoのURLをRequest URLフィールドに貼り付けます。

Short descriptionフィールドに説明を入力します。 たとえば、Creates a new issue in Jiraです。

任意です。 スラッシュコマンドで渡すことができるパラメーターをUsage hintフィールドに入力します。

Escape channels, users, and links sent to your appチェックボックスを選択します。 これにより、SlackはWorkatoへのリクエストペイロード内のユーザーとチャンネルをエスケープします。

保存をクリックします。

Workatoのレシピに戻り、Select an app and actionをクリックします。

アプリとしてJiraを検索して選択します。

Create issueアクションを選択します。

Jiraコネクションを選択します。

Project issue typeフィールドをEnter project and issue typeに切り替え、Workbot for Slackのプロジェクト課題タイプStep 1データピルをマッピングします。

Workbot for Slackの概要Step 1データピルをSummaryフィールドにマッピングします。

Workbot for Slackの説明Step 1データピルをDescriptionフィールドにマッピングします。

Create issueアクションを設定

+ Add stepをクリックし、Action in appを選択します。

アプリとしてJiraを検索して選択します。

Get issueアクションを選択します。

JiraのIDStep 2データピルをIssue ID or keyフィールドにマッピングします。

Workbot for SlackのPost command replyアクションを選択します。

新しく作成されたJira課題の詳細を含めるように、返信を設定します。

保存をクリックします。

テストレシピをクリックします。

Slackを開き、Enterprise Workbotが追加されているチャンネルを選択します。

/createissueを入力し、Returnを押してコマンドを送信し、Create new issue in Jiraダイアログを開きます。

/slashcommand name1: value 1 name2: value 2 name3: value 3...

/createissue project_issue_type: UI--Bug summary: Button is misaligned description: At the registration page, the registration button is misaligned.

フィールドに入力し、Submitをクリックします。