Embeddedユーザー向けSlack Enterprise Workbotの設定
このガイドでは、Embeddedパートナーがエンドカスタマー向けにSlack Enterprise Workbotを有効化する方法について説明します。
SLACK MARKETPLACEにボットを掲載
ホワイトラベル化されたWorkbotをSlack Marketplaceに掲載するには、カスタマーサクセスマネージャーにお問い合わせください。
前提条件
開始する前に、Slack Enterprise Workbotがあることを確認してください。 作成する必要がある場合は、Slack Enterprise Workbotの作成ガイドを参照してください。
手順
Embeddedカスタマー向けにSlack Enterprise Workbotを設定するには、次の手順を完了します:
- アプリの公開配布を有効化する
- カスタムOAuthプロファイルをエンドカスタマーと共有する
- レシピを構築する
- Workatoマニフェストをエクスポートする
- パッケージをカスタマーワークスペースにインポートする
- カスタマーのWorkbot for Slackコネクションを認証する
アプリの公開配布を有効化する
アプリの公開配布を有効化するには、次の手順を完了します:
Slack API Webサイトで次のページを開きます: Your Apps（アプリ）。
Slack Enterprise Workbotの作成ガイドで作成したSlackアプリを選択します。
次に移動します: Settings > Manage Distribution（設定＞配布を管理）。
Share Your App With Other Workspaces（アプリを他のワークスペースと共有）セクションを見つけ、Remove Hard Coded Information（ハードコードされた情報を削除）を展開します。
OAuthトークンやWebhook URLなど、アプリからハードコードされた情報をすべて削除したことを確認するチェックボックスを選択します。
アプリのパブリック配布を有効にするには、Activate Public Distribution（パブリック配布を有効化）をクリックします。
カスタムOAuthプロファイルをエンドカスタマーと共有する
Slack Enterprise Workbotの作成ガイドで作成したCustom OAuth profileをエンドカスタマーと共有します。 このプロファイルにより、カスタマーのSlackアカウントは、パートナーのSlackアカウントで定義されたボット設定にアクセスできるため、カスタマーは自社のSlackインスタンスでOAuthアプリを作成する必要がありません。
カスタムOAuthプロファイルを共有するには、次の手順を実行します:
Workatoアカウントにサインインします。
顧客を管理に移動します。
カスタマーを選択します。
設定＞Custom OAuth profilesに移動します。
プロファイルを割り当てるをクリックして、カスタマーワークスペースにカスタムOAuthプロファイルを設定します。 OAuthプロファイルを割り当てるダイアログが表示されます。
Select app（アプリを選択）ドロップダウンメニューからWorkbot for Slackを選択します。
Slack Enterprise Workbotの作成ガイドで作成したCustom OAuth profileを選択します。
ユーザーがWorkbot for Slackコネクションを作成すると、カスタマーワークスペースではこのプロファイルがデフォルトで使用されます。 この方法を使用して、各カスタマーワークスペースとOAuthプロファイルを個別に共有する必要があります。 Custom OAuth profiles APIエンドポイントを使用して、OAuthプロファイルをプログラムで管理することもできます。
レシピを構築する
カスタマーワークスペースにデプロイするために、Workbot for Slackコネクションを使用してレシピを開発します。
Workatoマニフェストをエクスポートする
レシピを作成し、OAuthプロファイルを共有したら、ボットレシピを含むマニフェストをカスタマーワークスペースにエクスポートします。 Workatoマニフェストをエクスポートするには、マニフェストの作成ガイドを参照するか、次の手順を完了します:
Workatoマニフェストのエクスポート
ツール＞レシピライフサイクルマネジメント＞エクスポートに移動します。
新しいマニフェストを作成をクリックします。
マニフェスト名フィールドにマニフェストの名前を入力します。
ソースフォルダドロップダウンメニューを使用して、ソースフォルダを選択します。 このフォルダとすべてのサブフォルダ内のすべてのレシピおよび依存アセットがマニフェストの一部になります。
次へをクリックします。
マニフェストを作成をクリックします。
パッケージをビルドしてエクスポートをクリックします。
ダウンロードをクリックして、マニフェストコンテンツを含むzipファイルをダウンロードします。
パッケージをカスタマーワークスペースにインポートする
パッケージをカスタマーワークスペースにインポートするには、パッケージをインポートするガイドを参照するか、次の手順を実行します:
パッケージを顧客ワークスペースにインポート
マニフェストをインポートする顧客ワークスペースに切り替えます。
ツール＞レシピライフサイクルマネジメント＞インポートに移動します。
インポートをクリックします。
パッケージを含むZIPファイルをZIPファイルを選択で選択します。
ターゲットフォルダドロップダウンメニューを使用して、インポート先を選択します。
次へをクリックします。
パッケージの詳細を確認して、顧客ワークスペースとの統合方法を確認します。
次へをクリックしてインポートを開始します。
インポートが完了したら、完了をクリックします。
カスタマーのWorkbot for Slackコネクションを認証する
カスタマーワークスペースにパッケージをインポートすると、Workbot for Slackコネクションが利用可能になります。 カスタマーに、ボットをインストールする予定のワークスペース用のSlack認証情報を使用して、このコネクションを認証するよう依頼します。
コネクションは共有されたCustom OAuth profileを自動的に使用し、カスタマーがインストールしたアプリパッケージが、パートナーのSlackインスタンスで設定されたアプリに接続されるようにします。
EMBEDDEDカスタマーではCUSTOM OAUTH PROFILEフィールドが無効
カスタマーがWorkbot for Slackコネクションを認証すると、Custom OAuth profileセレクターは無効になります。 コネクションでは引き続き共有されたカスタムOAuthプロファイルが使用され、このワークスペース内のこのアプリでは他のカスタムOAuthプロファイルは利用できません。
結果
カスタマーワークスペース内のレシピを開始する準備ができました。 コネクションにCustom OAuth profileが含まれているため、ボットはカスタマーのSlackインスタンスで想定どおりに機能するはずです。
Last updated: