Workbot for Microsoft Teamsトリガー ​

Workbot for Microsoft Teamsには次のトリガーがあります:

• 新しいコマンドトリガー
• 新しいヘルプメッセージトリガー
• タブオープントリガー
• 新しいメッセージトリガー（ベータ）

新しいコマンドトリガー ​

Workbotコマンドを使用すると、Microsoft Teamsからレシピをトリガーできます。 これらのレシピは、その後アプリでアクションを実行できます（たとえば、新しいServiceNowチケットの作成や、Salesforce商談の一覧表示）。

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

Teamsで追加パラメーターを含む'newissue'コマンドを送信し、その後返信を受信する

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

Workbotコマンドトリガーを使用するWorkbotレシピ

コマンドの設定 ​

'newissue'コマンドの例

入力 ​

次の表に、トリガーの入力フィールドとその動作を示します。

コマンド名 ​

Workbotコマンドは、次の方法でレシピを呼び出すことができます:

1. Workbotへのダイレクトメッセージでコマンド名を送信する。例:newissue
2. チャネルでコマンド名を送信し、Workbotにタグ付けする。例:@workbot newissue
3. 設定されたコマンド名でボタンを送信する: ボタンは、別のレシピのWorkbotコマンドを呼び出すように設定できます

'Create issue'ボタンは送信時に'newissue'コマンドを呼び出し、レシピを実行します

パラメーター ​

各パラメーターには、後続のレシピアクションでデータピルとして使用できる追加データを保存できます。

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

コマンドで追加パラメーターを指定すると、Workbotはユーザーに情報を求めることができます

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

追加パラメーターUrgency、Summary、Descriptionを指定して'newissue'コマンドを送信

パラメーターの定義 ​

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

パラメーターを定義すると、Workbotはタスクモジュールを開き、各パラメーターの値をユーザーから収集します。

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

新しいパラメーターの追加

パラメーターを設定することで、ユーザーがタスクモジュールでパラメーターを操作する方法を制御できます。

パラメーターの設定

次の表で、各パラメーター設定フィールドの動作を詳しく説明します。

パラメーター値を渡す高度な方法 ​

パラメーター値は、Workbotコマンドの呼び出し時に、ボタンおよびタスクモジュールによって渡すこともできます。 通常、パラメーターを使用して、呼び出されたWorkbotレシピにコンテキストを渡します。

'Re-open issue'ボタンは'reopen_issue'コマンドを呼び出すだけでなく、パラメーターも渡します

'Re-open issue'ボタンは'sys_id'を渡すように設定されているため、'reopen_issue'レシピはどの課題を再オープンするかを認識できます

パラメーターを渡す別の方法は、ピックリストChoice parameterを使用することです。

選択肢パラメーターは、選択肢から値を取得します（選択されている場合）

選択肢パラメーターは、同じメッセージ内のボタンが送信されるときに渡されます（ボタンに他のパラメーターがある場合はそれらも含みます）。

'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メッセージになります。

各ボットで一度にアクティブにできるNew help messageトリガーレシピは1つだけです。

New help messageトリガーを使用する理由 ​

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

• User IDを使用してユーザー向けにメッセージをパーソナライズする
• Is bot admin?を使用して、ユーザーがボット管理者かエンドユーザーかに応じて異なるhelpメッセージを表示する
• ユーザーがhelpコマンドと一緒に送信するテキストを使用して、代替のhelpメッセージを提供します。例:help Salesforce
• ボットコマンド、個人用コネクション、ボットレシピとジョブへのリンクを表示する

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

• ボット固有の機能をより詳しく説明する
• ユーザーにスコープ設定できる他のアプリ（例:Salesforce、ServiceNow、Jira）の情報を含める
• タスクモジュールを開いたり、ユーザーを特定のタブに移動させたりできる複数ステップのhelpフローを構築する

入力 ​

入力は不要です。

出力 ​

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

ヘルプメッセージは次の優先順位に従います:

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

タブオープントリガー ​

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

入力 ​

出力 ​

新しいメッセージトリガー ​

新しいメッセージトリガー

New messageトリガーは、ユーザーがWorkbotにダイレクトメッセージ（DM）を送信するか、チャネルでWorkbotをメンションし、ユーザーのメッセージに一致するアクティブな新しいコマンドトリガーがない場合に有効になります。 そのメッセージに応答する特定のコマンドトリガーが設定されていない場合、New messageトリガーが実行されます。

たとえば、Workbotに@workbot helloを送信し、helloコマンドで設定されたアクティブなレシピがない場合、New messageトリガーがイベントを取得し、レシピで定義されたワークフローを続行します。 このトリガーは、デフォルトのCommand not found応答よりも優先されます。

このトリガーは、Post messageおよびPost simple messageアクションと互換性があります。 新しいメッセージに対するWorkbotの応答をカスタマイズするために使用します。 New messageトリガーを使用する複数のレシピを同時にアクティブにできます。 さらに、トリガー条件を使用して特定のチャネルでフィルタリングできます。

入力 ​

このトリガーではユーザー入力は不要です。 ただし、トリガー条件を設定して、Workbotが1つ以上の特定のチャネルのメッセージにのみ応答するように設定できます。

出力 ​

仕組み ​

このトリガーは、ユーザーがWorkbotとやり取りしているが、その入力が既存のコマンドと一致しない場合に役立ちます。 これにより、Workbotとユーザーの間で、よりインタラクティブで動的な会話を作成できます。

次の例では、New messageトリガーとPost messageアクションを組み合わせています。 このアクションにより、ユーザーはチケットの作成、レコードの検索、サポートへの相談などのオプションを選択してタスクを完了できます。

チャネルIDを取得する方法 ​

チャネルIDは、Microsoft Teams内の特定のチャネルに対応します。 チャネルIDを使用して、イベントをチャネルでフィルタリングし、Workbotからの応答を促すチャネルを制御するトリガー条件を設定できます。 これにより、Workbotのアクションがそれらのチャネルのコンテキストに関連したものになります。

Microsoft TeamsからチャネルIDを取得するには、次の手順を実行します。

https://teams.microsoft.com/l/channel/19%3Aae37e692418942c28c2c97cd38493cf5%40thread.tacv2/%5BDocs%5D%20Test?groupId=55563081-256e-4922-8f4e-e2a760294320&tenantId=76a89289-583c-40a2-9709-e076eed5d680

19%3Aae37e692418942c28c2c97cd38493cf5%40thread.tacv2

19:[email protected]

19:[email protected]

19:ae37e692418942c28c2c97cd38493cf5