Workbot for Microsoft Teams には以下の3つのトリガーがあります。

• New command
• New help message
• Tab opened

Workbot コマンドトリガー ​

Workbot コマンドを使用すると、Microsoft Teams からレシピをトリガーし、レシピでアプリのアクションを実行することができます (ServiceNow チケットの新規作成、Salesforce の商談のリスト表示など)。

つまり、Microsoft Teams 内からアプリのアクションを実行することができます。

Microsoft Teams 内で追加パラメータとともに「newissue」コマンドを送信し、応答を受信する

Microsoft Teams 内で Workbot にコマンドが送信されると、Workbot レシピがトリガーされ、そのアクションが実行されます。

Workbot コマンドトリガーのある Workbot レシピ

コマンドの設定 ​

「newissue」コマンドの例

入力項目 ​

以下の表に、このトリガーの入力項目とその説明を示します。

Command name ​

Workbot コマンドは、以下の方法でレシピを実行できます。

1. Workbot へのダイレクトメッセージでコマンド名を送信する (例 : newissue )
2. チャネルで Workbot をメンションしてコマンド名を送信する (例 : @workbot newissue )
3. コマンド名が埋め込まれたボタンを押す。 別のレシピの Workbot コマンドを実行するようにボタンを設定することが可能

「Create issue」ボタンを押すと「newissue」コマンドが送信され、レシピが実行される

Parameters ​

パラメータを追加することで、コマンド実行時にユーザに対して追加でデータを要求し、後続のアクションでデータピルとして使用することができるようになります。

たとえば、ServiceNow でインシデントを作成する際、 Urgency 、 Summary 、 Description などの追加情報を入力するようユーザーに求めることができます。 Urgency 、 Summary 、 Description をパラメータとして追加すると、Workbot がタスクモジュールを開き、ユーザーに各パラメータの入力を求めます。

コマンドにパラメータを追加すれば、Workbot からユーザーに情報の入力を求めることができる

ユーザーは、コマンドとともにパラメータを指定することで、このプロンプトをスキップすることもできます。

追加パラメータの Urgency、Summary、Description を指定した「newissue」コマンドの送信

パラメータの定義 ​

「newissue」コマンドに設定された3つのパラメータ

パラメータを定義しておくと、Workbot がタスクモジュールを開いて、各パラメータの値をユーザーから収集します。

パラメータを追加するには、Workbot コマンドトリガーの [Parameters] セクションで [Add a parameter] ボタンを選択します。

新しいパラメータの追加

パラメータを設定すると、タスクモジュールでユーザーがパラメータをどのように扱うかを制御できます。

パラメータの設定

以下の表に、パラメータの各設定項目について詳しく説明します。

パラメータ値を渡すためのテクニック ​

パラメータ値は、Workbot コマンドを呼び出す際のボタンに埋め込まれた追加パラメータ、あるいはタスクモジュール上でのユーザーの入力から渡されます。パラメータは、呼び出された Workbot レシピのアクションに必要な情報を渡すために使用されます。

「Re-open issue」ボタンは、「reopen_issue」コマンドの呼び出しだけでなくパラメータの引き渡しも行う

再度表示する問題を「reopen_issue」レシピで認識するため、「sys_id」を渡すように「Re-open issue」ボタンが設定されている

選択パラメータ というピックリストを使ってパラメータを渡すこともできます。

選択パラメータには選択肢の中の値が設定される

選択パラメータは、同じメッセージからボタンが押されたときに (ボタンにある他のパラメータとともに) 渡されます。

「Next」ボタンは、呼び出すコマンドレシピに対して「Google」という「opportunity_id」も渡している

Enterprise Workbot 用のファイル ​

コマンドに file パラメータが設定されている場合、ユーザーは Enterprise Workbot にファイルをアップロードできます。ファイルはそのユーザーの OneDrive for Business のストレージにアップロードされ、そのファイルデータは後続のアクションで使用できます。トリガー出力のファイルの部分は以下のようになります。

New help message トリガー ​

New help message トリガーは、help メッセージがボットに DM またはチャネル (「@workbot help」などでメンション) で送信されると実行されます。このトリガーは、Workbot のデフォルトのヘルプメッセージを利用するのではなく、help メッセージに対するボットの応答を完全にカスタマイズしたい場合に使用します。

このトリガーは、Post reply アクションと対にすることをお勧めします。この応答が、ボットの help を呼び出したときに表示される help メッセージとなります。

1つのボットについて同時にアクティブにできる New help message トリガーレシピは1つだけです。

New help message トリガーを使う理由 ​

ボットのヘルプメッセージは、その独自の機能に基づいてカスタマイズすることを強くお勧めします。これは、 New help message イベントに Post reply で応答することによって行います。トリガーに含まれるコンテキストは、以下の目的に使用できます。

• User ID を使用し、メッセージをユーザー向けにパーソナライズする。
• Is bot admin? を使用し、ユーザーがボット管理者かエンドユーザーかによって異なる help メッセージを表示する。
• help Salesforce など、ユーザーが help コマンドに追加して送信するテキストを使用して別の help メッセージを表示する。
• ボットコマンド、パーソナルコネクション、ボットのレシピやジョブへのリンクを表示する。

Post reply アクション内で定義されるカスタマイズされたヘルプメッセージを使用すると、以下のことが可能になります。

• ボット独自の機能をより詳しく説明する。
• 当該ユーザーに的を絞った他のアプリ (Salesforce、ServiceNow、Jira など) からの情報を含める。
• タスクモジュールを開いたり、ユーザーを特定のタブに移動させたりできる、複数のステップで構成された help フローを構築する。

入力 ​

入力は不要です。

出力 ​

ヘルプメッセージの優先順位 ​

ヘルプメッセージの優先順位は以下のとおりです。

1. レシピ内のカスタムヘルプ
2. デフォルトのヘルプ

Tab opened トリガー ​

このトリガーは、Enterprise Workbot でユーザーがタブを開くと実行されます。タブの動作について詳しくは、タブを参照してください。

入力 ​

出力 ​

詳細 ​

• Workbot for Microsoft Teams の使用
• Workbot のアクション
• Workbot のボタン、ピックリスト、タスクモジュール