Microsoft App Studioを使用してEnterprise Workbotを作成する

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Enterprise Botを設定するには、以下が必要です:

  • Workatoで以下を実行します:

    • アクセス権:
      • Workbot。アカウントにプラットフォーム > Workbotオプションが表示されない場合は、Customer Success Managerにお問い合わせください。
      • Custom OAuth profilesアカウントにツール > Custom OAuth Profilesオプションが表示されない場合は、Customer Success Managerにお問い合わせください。
    • 以下を実行できる権限:
      • Workbotを作成および設定します。
      • コネクションを作成および設定します。
      • Custom OAuth Profilesを作成および設定します。
  • Microsoft組織内の次のいずれかのロール:

    • アプリケーション管理者
    • クラウドアプリケーション管理者
    • グローバル管理者
    • 特権ロール管理者

    Microsoftユーザー > 自分(自分の名前を選択) > 割り当て済みロールに移動して、ロールの割り当てを確認します。

MICROSOFT APP STUDIOは非推奨です

2022年1月1日の時点で、MicrosoftはApp Studioを非推奨にしました。 Enterprise Workbotを作成するには、Microsoft Teams Developer Portalガイドを使用します。 このガイドは参照用としてのみ保持しています。


ステップ1: WorkatoでWorkbotを作成する

1

Workatoアカウントにサインインします。

2

プラットフォーム > Workbotに移動します。

3

Custom botタブをクリックし、+ New custom botをクリックします。

4

Applicationフィールドで、Workbot for Microsoft Teamsを選択します。

5

Nameフィールドに、ボットの名前を入力します。

6

Create new appをクリックします。

このページは開いたままにします。ボットの設定を完了するために必要です。


ステップ2: Microsoft Teamsアプリを作成する

ステップ2.1: Microsoft App Studioをインストールする

次の手順を完了してMicrosoft App Studioをインストールします:

App Studioをすでにインストールしている場合は、次のステップに進んでください。

1

Microsoft Teamsアカウントにサインインします。

2

左側のナビゲーションメニューで、省略記号(...)をクリックし、App Studio.を検索します。

3

App Studioをクリックしてインストールします。

ステップ2.2: アプリを作成して設定する

1

App Studioで、マニフェスト editorタブに移動します。

2

Create new appをクリックします。

3

表示されるページで、以下を入力します:

  • Short name: ボットの短い名前。 例: OpsBot

  • Full name: 任意。ボットの完全な名前。 例: Opportunities Bot

  • App ID: GenerateをクリックしてApp IDを生成します。

    この情報を保存してください

    App IDを手元に控えておいてください。Workatoでボットの設定を完了するために必要です。

  • Package name: 逆ドメイン形式でパッケージ名を入力します。 例: com.workato.opsbot

  • バージョン: ボットのバージョンを入力します。 新しいボットの場合、バージョンは通常1.0.0です。

  • Short description: ボットの短い説明を入力します。

  • Full description: ボットの長い説明を入力します。 Note: Short descriptionと同じテキストが含まれている場合、Microsoftは完全な説明を却下します。

  • Website: https://www.workato.comを入力します

  • Privacy statement: https://www.workato.com/legal/privacy-policyを入力します

  • Terms of use: https://www.workato.com/legal/terms-of-serviceを入力します

  • Branding: アプリ独自のアイコンを使用することをお勧めしますが、デフォルトのWorkbotアイコンも使用できます。 独自のアイコンを使用する場合は、アイコンがMicrosoftのサイズ要件を満たしていることを確認します。

    デフォルトのWorkbotアイコンを使用するには、以下を右クリックして保存します:

    • フルカラー(192x192ピクセル)

    • 透明なアウトライン(32x32ピクセル: 画像は空白に見えますが、存在します。 アクセントカラーとして#108921を使用します。

ステップ2.3: ボットに個人用タブを追加する

次の手順を完了して、ボットに個人用タブを追加します:

このステップは任意です

ボットに個人用タブを追加しない場合は、次のステップに進んでください。

1

Capabilities > Tabsをクリックします。

2

Add a personal tab.をクリックします。

3

以下のフィールドに入力します:

  • Name: Getting startedを入力します
  • Entity ID: gettingstartedを入力します
  • Content URL: https://docs.workato.com/workbot-for-teams/getting-started.htmlを入力します
  • Website URL: https://docs.workato.com/workbot-for-teams/getting-started.htmlを入力します
4

保存をクリックします。

完了すると、ページは次のようになります:

ステップ2.4: ボットの認証情報を取得する

ステップ2.4.1: Client IDを取得する

1

左側のナビゲーションバーで、Capabilities > Botsをクリックします。

2

Set upをクリックします。

3

ボットに名前を付けます。 例: OpsBot

4

Scopesで、次のスコープを選択します:

  • 個人用
  • チーム
  • グループチャット

ボットが作成されたら、ボット名の下にあるBot IDを見つけます。 Bot IDはボットのClient IDとして使用されるため、手元に控えておいてください。Workatoで設定を完了するために必要です。

ステップ2.4.2: Client Secretを取得する

App passwordsで、Generate new password.を選択します。

パスワードはボットのClient Secretとして使用されるため、手元に控えておいてください。Workatoで設定を完了するために必要です。


ステップ3: Workatoがアプリと通信するように設定する

1

ステップ1のWorkatoページに戻ります。

2

Step 3セクションで、次のフィールドに入力します:

3

保存をクリックします。

4

Step 4セクションを展開し、ボットエンドポイントアドレスをコピーします。 次のような形式になります:

https://app.workato.com/skype_webhooks/event?coak_id=42

これを手元に控えておいてください。次のステップを完了するために必要です。


ステップ4: アプリがWorkatoと通信するように設定する

ステップ4.1: ボットのエンドポイントアドレスを設定する

1

Microsoft Teams App Studioに戻ります。

2

マニフェスト editor > Your bot > Capabilities > Botに移動します。

3

Messaging endpointセクションで、前のセクションボットエンドポイントアドレスBot endpoint addressフィールドに貼り付けます。

ステップ4.2: Workatoのドメインを許可リストに追加する

1

左側のナビゲーションバーで、Finish > Domains and permissionsに移動します。

2

Enter a valid domainフィールドに*.workato.comを入力します。

3

Addをクリックします。 ドメインがAdditional valid domainsセクションに追加されます。

ステップ4.3: ボットのマニフェストをダウンロードする

1

左側のナビゲーションバーで、Finish > テスト and distributeに移動します。

2

ページの右側にエラーがある場合は、先に進む前に解決してください。未解決のままにすると、インストールまたはアプリパッケージ(別名 マニフェスト)をダウンロードする際に問題が発生する可能性があります。 これらの問題は通常、Details > App detailsまたはCapabilities > Botsのフィールドに関連しています。

解決したら、次のステップに進みます。

3

Downloadをクリックします。 アプリのマニフェストは、デフォルトのダウンロードフォルダにダウンロードされます。 ファイルの場所をメモしておいてください。次のステップを完了するために必要です。

ステップ4.4: マニフェストをアプリストアにアップロードする

1

新しいブラウザタブを開き、Microsoft Teams Admin Centerに移動します。

2

左側のナビゲーションバーで、Teams apps > Manage appsに移動します。

3

アプリテーブルで、+ Uploadをクリックします。

4

前のセクションでダウンロードしたマニフェストファイルを選択してアップロードします。 これにより、ボットがMicrosoftテナントアプリカタログにアップロードされます。

ステップ4.5: ボットをチーム/チャネルに追加する

1

Microsoftテナントアプリカタログに移動します。

2

Build for <YOUR_NAME>セクションでアプリを見つけて選択します。 アプリが表示されない場合は、Microsoft Teamsからサインアウトし、再度サインインします。

3

Addボタンの横にある矢印をクリックし、Add to teamを選択します。

4

チーム名またはチャネル名を入力します。

ステップ4.6: 認証リダイレクトURLを設定する

1

Azure portalに移動します。

2

検索バーにApp Registrationと入力し、結果を選択します。

3

表示されるページで、ボットをクリックします。

4

左側のナビゲーションバーで、Authenticationをクリックします。

5

プラットフォーム configurationsで、+Add a platform/Webをクリックします。

6

Redirect URIsセクションで、次のURIを追加します:

  • https://www.workato.com/auth/skype/callback
  • https://www.workato.com/users/auth/skype
  • https://www.workato.com/oauth/callback
7

ページ上部付近にあるSaveをクリックします:


ステップ5: Workbotコネクションを確立する

1

Workatoアカウントのブラウザタブを開きます。

2

コネクションに移動します。

3

Create connectionをクリックします。

4

アプリのリストでWorkbot for Microsoft Teamsを検索してクリックします。

5

以下を入力します:

  • コネクション name: コネクションの名前を入力します。
  • Location: コネクションを保存するフォルダを選択します。
  • Advanced settings(詳細設定):API Scope(s)で、ボットに使用するAPIスコープを選択します。 デフォルトでは、User.ReadUser.Read.All、およびGroup.Read.Allが要求されます。
  • Custom OAuth profile: ボットに使用させるCustom OAuth profileを選択します。
6

接続をクリックします。 Microsoft Teamsで認証するよう求められます。

7

プロンプトが表示されたら、認証を行い、ボットの権限を承認します。


トラブルシューティング

アプリのサイドロードまたは認証中に権限の問題が発生した場合は、Microsoft Teams admin centerで次の設定を確認します:

組織全体のアプリ設定

1

Teams apps > Manage appsに移動します。

2

Org-wide app settingsをクリックします。

3

Third-party appsで、Allow third-party appsOnに設定されていることを確認します。

4

Custom appsで、Allow interaction with custom appsOnに設定されていることを確認します。

5

保存をクリックします。

アクセス許可ポリシー

1

Teams apps > Permission policiesに移動します。

2

組織全体のポリシーを選択します。

3

Third-party appsで、Allow all appsが設定されていることを確認します。または、アプリが許可されていることを確認します。

4

Custom appsで、Allow all appsが設定されていることを確認します。または、アプリが許可されていることを確認します。

5

保存をクリックします。

セットアップポリシー

1

Teams apps > Setup policiesに移動します。

2

組織全体のポリシーを選択します。

3

Upload custom appsOnに設定されていることを確認します。

Last updated: