Microsoft Teams Enterprise Workbotを作成する
Enterprise Workbotsは、Workatoボットプラットフォームを内部で活用できる、ユーザーが作成するMicrosoft Teamsアプリです。ボットのアイデンティティは、次のように完全にカスタマイズできます。
- ブランディング(ボット名、ボットロゴ、アクセントカラー)
- カスタムOAuthプロファイル(ボットID、アプリシークレット)
- 権限
これらのMicrosoft Teamsアプリは、メンバーが使用できるようにMicrosoft Teamsのグループまたはチャネルにサイドロードできます。ボットのブランディングと権限を制御したい場合、または目的別のボットを複数使用したい場合は、Enterprise Workbotが適しています。
機能の提供状況
特定の料金プランをご利用のお客様は、Enterprise Workbot機能を利用できます。詳細については、ご利用の料金プランおよび契約を参照してください。
非推奨に関する注意
このページでは、Microsoft Teams Developer Portalを使用してアプリを作成および管理します。 2022年1月1日の時点で、MicrosoftはApp Studioを非推奨にしました。
このページで概説する方法は、新しい推奨方法ですが、App Studioの手順は参照用に保持されています。
VIRTUAL PRIVATE WORKATO (VPW)のお客様
この機能を使用するには、お使いのVirtual Private Workato(VPW)インスタンスに固有の設定手順が必要です。 VPWをご利用のお客様は、インスタンスの設定詳細について、VPWのプライベートドキュメントを参照してください。
前提条件
Enterprise Botを設定するには、次が必要です。
Workatoで:
アクセス権:
- Workbot: アカウントにプラットフォーム > Workbotオプションが表示されない場合は、Customer Success Managerにお問い合わせください。
- Custom OAuth profiles: アカウントにツール > Custom OAuth Profilesオプションが表示されない場合は、Customer Success Managerにお問い合わせください。
以下を実行できる権限:
- Workbotを作成および設定します。
- カスタムOAuthプロファイルを作成および設定します。
Microsoft組織内:
次のロールのいずれか:
- アプリケーション管理者
- クラウドアプリケーション管理者
- グローバル管理者
- 特権ロール管理者
委任された権限とアプリケーション権限
Enterprise Workbotは、委任された権限またはアプリケーション権限のいずれかを使用するように設定できます。
デフォルトオプションとして設定されている委任された権限では、OAuthユーザーの権限を使用してWorkatoでコネクションを確立します。コネクションを設定するユーザーには、必須ロールのいずれかが必要です。
アプリケーション権限は、委任された権限と比較してセキュリティを強化します。この方法では、コネクションがユーザーから独立した状態に保たれるため、ユーザーがログアウトしても切断されず、管理者以外でもコネクションを設定できます。
詳細については、アプリケーション権限の設定(任意)手順を参照してください。
MicrosoftでUsers > You(自分の名前を選択)> Assigned rolesに移動し、ロールの割り当てを確認します。
WorkatoでWorkbotを作成する
WorkatoでWorkbotを作成するには、次の手順を実行します。
Workatoアカウントにサインインします。
プラットフォーム > Workbotに移動します。
Custom botsタブをクリックします。このタブが表示されない場合は、ワークスペースがCustom OAuth profilesにアクセスできることを確認してください。
Create a custom botをクリックして、New botページを開きます。
ApplicationドロップダウンメニューからWorkbot for Microsoft Teamsを選択します。
Nameフィールドにボットの一意の名前を入力します。名前にはスペースを含めることができますが、特殊文字は使用できません。
Create new appをクリックします。これにより、Microsoft Teams Developer Portalが新しいタブで開き、今後の設定で使用するBot endpoint addressが表示されます。
残りの手順を完了するために、WorkatoタブとMicrosoft Teams Developer Portalタブの両方を開いたままにします。
Microsoft Teamsアプリを作成する
Microsoft Teams Developer Portalでボットを作成する
Microsoft Teams Developer Portalでボットを作成するには、次の手順を実行します。
ツール > ボット管理に移動します。
+ New Botをクリックします。
Bot nameフィールドにボットの名前を入力します。一貫性を保つため、Workatoボットと同じ名前を使用します。
Addをクリックして、ボットをDeveloper Portalに追加します。
Workatoタブに移動し、Bot endpoint addressをコピーします。次の例のようになります。
https://app.workato.com/skype_webhooks/event?coak_id=42Developer Portalタブに戻り、コピーした値をBot endpoint addressフィールドに貼り付けます。
保存をクリックします。
Developer PortalページのURLからBot IDをコピーします。次の例のようになります。
https://dev.teams.microsoft.com/bots/<YOUR-BOT-ID>/configure後で使用するために、Bot IDを安全に保存します。
アプリを作成する
Microsoft Teams Developer Portalでアプリを作成するには、次の手順を実行します。
Appsに移動し、+ New appをクリックします。
Nameフィールドにアプリの名前を入力します。
Addをクリックしてアプリを作成します。
作成したアプリを選択し、Configure > Basic informationに移動します。
次の必須フィールドに入力します。
- Short description: アプリの概要説明を80文字以内で入力します。
- Long description: アプリの詳細な説明を4,000文字以内で入力します。
- Developer or company name: アプリに関連付けられている開発者または会社の名前を入力します。
- Website: 有効なHTTPS URLを入力します。
- Privacy policy: プライバシーポリシーへのリンクを入力します。
- Terms of use: 利用規約へのリンクを入力します。
Microsoft Teams Developer Portalでボットを作成する手順からBot IDをコピーし、Application (client) IDフィールドに貼り付けます。
保存をクリックします。
任意です。ボットのブランディングを設定するには、Configure > Brandingに移動します。
Configure > Domainsに移動します。
Create your first domainをクリックして、Add domainダイアログを開きます。
*.workato.comを入力します。
Addをクリックします。
ボットの権限を設定する
Microsoft Teams Developer Portalでボットの権限を設定するには、次の手順を実行します。
Configure > App featuresに移動し、Botをクリックします。
Select an existing botドロップダウンメニューから、新しく作成したボットを選択します。
What can your bot do?フィールドでUpload and download filesを選択します。
Select the scopes where people can use your botフィールドで、Personal、Team、Group Chatを選択します。
保存をクリックします。
Add a commandをクリックします。
以下のフィールドに入力します:
- Command:
helpを入力します。 - 説明(ヘルプテキスト):
Type 'help' to view available commandsを入力します。 - Select the scopes where people can use this command: Personal、Team、Group Chatを選択します。
Addをクリックします。
保存をクリックします。
認証リダイレクトURLを設定する
Microsoft Azure Portalで認証リダイレクトURLを設定するには、次の手順を実行します。
Microsoft Azure Portalにサインインします。
App registrationsに移動します
表示されるページでボットをクリックします。
Manage > Authenticationに移動します。
サポートされているアカウントの種類で、任意の組織ディレクトリ内のアカウント(任意のMicrosoft Entra IDテナント - マルチテナント)が選択されていることを確認します。
Platform configurationsで+Add a platformをクリックし、Webを選択します。
データセンターに応じてリダイレクトURIを入力します。
Workato Enterpriseのお客様
- US Data Center:
https://www.workato.com/oauth/callback - EU Data Center:
https://app.eu.workato.com/oauth/callback - JP Data Center:
https://app.jp.workato.com/oauth/callback - SG Data Center:
https://app.sg.workato.com/oauth/callback - AU Data Center:
https://app.au.workato.com/oauth/callback - IL Data Center:
https://app.il.workato.com/oauth/callback - CN Data Center:
https://app.workatoapp.cn/oauth/callback - KR Data Center:
https://app.kr.workato.com/oauth/callback - UKデータセンター:
https://app.uk.workato.com/oauth/callback
Self-service(Workato Free、Workato Pro、またはDeveloper Sandbox)ユーザー
- セルフサービスデータセンター:
https://app.trial.workato.com/oauth/callback
Configureをクリックして変更を保存します。
クライアントシークレットを追加する
Microsoft Azure Portalでボットにクライアントシークレットを追加するには、次の手順を実行します。
クライアントシークレット
クライアントシークレットは定期的に、通常は毎年期限切れになり、更新が必要です。これはEmbeddedとDirectの両方のユースケースに適用されます。 Embeddedシナリオでは、共有カスタムOAuthプロファイルで使用されるトークンを更新する必要があるのはEmbeddedパートナーのみであり、エンドカスタマーがアクションを実行する必要はありません。アクセストークンの有効期限は、portal.azure.comで確認できます。
Manage > Certificates & secrets > Client secretsに移動します。
+ New client secretを選択します。
Descriptionフィールドにクライアントシークレットの説明を入力します。
Expiresドロップダウンメニューを使用して有効期限を設定します。
Addをクリックして、クライアントシークレットをアプリに追加します。
Value列のシークレットの横にあるCopy to clipboardをクリックします。クライアントシークレットの値は、作成後に再度表示することはできません。ページを離れる前に、シークレットを安全に保存してください。
アプリと通信するようにWorkatoを設定する
カスタムOAuthプロファイルの設定を完了するには、Workatoで次の手順を実行します。
WorkatoでWorkbotを作成する手順のWorkatoページに戻ります。
Step 3セクションに移動し、次のフィールドに入力します。
- Client ID - your bot ID: Microsoft Teams Developer Portalでボットを作成する手順のBot IDを入力します。ツール > Bot management > Your botにもあります。
- Client secret: クライアントシークレットを追加する手順のclient secretを入力します。
- Application ID: アプリIDを入力します。この値は、Developer PortalでAppsに移動し、アプリを選択してBasic informationをクリックすると確認できます。
保存をクリックします。
組織に公開する
アプリを組織に公開するには、次の手順を実行します。
Microsoft Teams Developer Portalタブに移動します。
Publish > Publish to orgに移動します。
Publish your appをクリックして、Microsoft Teams管理者に公開リクエストを送信します。
プロセスを完了するには、Microsoft Teams管理者に公開リクエストの承認を依頼します。
Microsoft Teamsにボットを追加する
Microsoft Teamsインスタンスにボットを追加するには、次の手順を実行します。
Microsoft Teamsチャネルに移動し、1対1のチャットまたはグループチャットを開きます。
テキストボックスに@を入力し、Get botsを選択します。
ボットを探して選択します。
Postをクリックして、ボットをMicrosoft Teamsチャネルに追加します。
埋め込み顧客向けのENTERPRISE WORKBOTを設定する
Embeddedパートナーがエンドカスタマー向けにEnterprise Workbotを有効にするには、追加の手順が必要です。詳細については、Embeddedユーザー向けにMicrosoft Teams Enterprise Workbotを設定するを参照してください。
アプリケーション権限を設定する(任意)
委任された権限の代わりにアプリケーション権限でWorkbotアプリを設定するには、この追加手順に従ってMicrosoft Teamsで設定します。
最終更新日: