Feishu と Alibaba Cloud エンタープライズサービスを連携するためのマニュアル - サポートサービス

お客様へ

お客様とお客様のチームが Feishu ワークベンチで Alibaba Cloud エンタープライズサービスをシームレスかつ便利にご利用いただくために、この設定ガイドに従って設定を完了してください。

パート 1：設定手順 (所要時間：約 10 分)

操作者： お客様の Feishu 組織の管理者/アプリケーション開発者

主な目的： カスタムアプリを作成し、必要な権限を付与して、当社のプラットフォームとの安全な連携を実現します。

手順 1：カスタムアプリの作成

[Feishu オープンプラットフォーム] にログインしてください。
プラットフォームで新しい カスタムアプリ を作成し、アプリケーション名と説明を定義します (組織のメンバーがクエリやアクセスしやすいように、Alibaba Cloud エンタープライズサービスと指定することを推奨します)。

手順 2：アプリケーション機能の追加

アプリケーションのバックグラウンド左側のナビゲーションバーで [機能の追加] を見つけてクリックしてください。このページで、以下の 2 つのコア機能をアプリに追加する必要があります。

Web アプリ
1. 目的：追加後、お客様のチームは Feishu で「Alibaba Cloud エンタープライズサービス」アプリケーションを直接開いて使用できます。
2. 操作：「Web アプリ」カードを見つけ、[+] をクリックして追加してください。[手順 4] に従って、デスクトップ側のリンクを追加できます。
Bot
1. 目的：Bot を有効にすると、「Alibaba Cloud エンタープライズサービス」アプリケーションが新しいメッセージリマインダーを送信できるようになり、重要な情報を見逃すことがなくなります。
2. 操作：「ロボット」カードを見つけ、[+] をクリックして追加してください。

手順 3：アプリケーション認証情報の取得と提供

Feishu チャネルを有効にするには、お客様の 組織名、App ID、App Secret を提供してください。

組織名：[Feishu オープンプラットフォーム] の右上、お客様の名前の下にあるのが「組織名」です。また、新しいアプリケーションの左上隅の下にも「Production app@ (組織名)」という形式で組織名が表示されます。

アプリケーションが正常に作成された後、[認証情報と基本情報] ページで App ID と App Secret を見つけてコピーしてください。

コピーした 組織名、アプリケーションの App ID、App Secret を、設定のためにお客様のテクニカルサービスマネージャー (TAM) に提供してください (セルフサービス設定は後日サポートされる予定です)。

手順 4：Web アプリリンクの設定

Web アプリケーションの設定で デスクトップホームページ を入力してください。ホームページのリンク形式は以下の通りです。{appId} は、お客様の Web アプリの App ID に置き換える必要があることにご注意ください。

https://ailink.gts.work/feishu/{appId}/workbench

「Feishu の新しいタブで開く」を選択することを推奨します。

手順 5：アプリケーション権限のアクティブ化

アプリケーション機能 (メッセージリマインダーの送信や情報カードの表示など) の正常な動作を保証するために、アプリケーションに以下の権限を有効にしてください。

権限ポイント	使用方法の説明	Feishu 公式権限説明
`tenant:tenant:readonly`	お客様のビジネスに関する基本情報を取得します。含まれる情報：企業名企業番号 (Feishu プラットフォーム内で一意) バージョンタイプ (個人版/チーム版) 企業 ID 企業アバター主な目的：アプリケーション内でお客様の企業 ID を正しく表示するため	リンク
`application:application:self_manage`	アプリケーション情報を取得します。主な目的：アプリケーションの基本情報を取得し、お客様のアプリケーションが正しく設定されているかを確認するため	リンク
`im:message:send_as_bot`	アプリの Bot がユーザーにメッセージを送信することを許可します。主な目的：Web アプリケーションで「@メンション」があった場合に、ロボットが個人チャットを通じて通知を送信し、重要な情報を見逃さないようにするため	リンク
`cardkit:card:write`	アプリがメッセージカードを作成および更新することを許可します。主な目的：より美しくインタラクティブなカード形式で通知を送信することで、読書体験を向上させるため	リンク

方法 1：一括インポート

[権限とスコープ] に移動し、[スコープの一括インポート/エクスポート] をクリックします

以下の JSON をインポートボックスにコピーし、[追加] をクリックします

{
 "scopes": {
 "tenant": [
 "application:application:self_manage",
 "cardkit:card:write",
 "im:message:send_as_bot",
 "tenant:tenant:readonly"
 ],
 "user": []
 }
}

方法 2：手動でのインポート

[権限とスコープ] で [アプリに権限スコープを追加] をクリックし、以下の 4 つの権限ポイントを 1 つずつ検索して追加し、有効にすることもできます。

権限ポイント：
application:application:self_manage
tenant:tenant:readonly
im:message:send_as_bot
cardkit:card:write

手順 6：セキュリティ設定

アプリケーションが正常に動作するように、Feishu 開発者ページで以下のセキュリティ設定を完了してください。

1. リダイレクト URL の設定

リダイレクト URL に、以下のアドレスを追加してください。

注：上記 URL の '{appId}' は、[手順 1] で取得した実際の APP ID に置き換えてください。これは Feishu アプリケーションの詳細ページで確認できます。

https://ailink.gts.work/feishu/{appId}
https://ailink.gts.work/feishu/{appId}/workbench
https://ailink.gts.work/thirdparty/feishu/{appId}/login
https://ailink.gts.work/thirdparty/feishu/{appId}/oauth2/callback
https://ailink.gts.work/feishu/{appId}/person/inviteToGroup

2. H5 信頼ドメインの設定

H5 信頼ドメイン に、以下のドメイン名を追加してください。

https://ailink.gts.work

手順 7：バージョン管理とリリース

初回およびその後のアプリケーション変更時には、[バージョン管理とリリース] でバージョン番号と更新内容を記入し、保存してリリースしてください。

注：必要に応じて、アプリケーションの利用可能範囲 を組織の全メンバーまたは一部のメンバーに設定できます。

完了！TAM に連絡してグループに参加

すべての設定が完了しました。お客様のテクニカルサービスマネージャー (TAM) に連絡して、グループ参加用のリンクを入手してください。アプリケーション内で TAM とリアルタイムでコミュニケーションをとり、チケット通知の受信、サービス進捗の追跡を行い、シームレスな連携による特別なサポート体験をお楽しみいただけます。

特記事項とよくある質問

[ネットワーク設定] IP ホワイトリスト (該当する場合)

お客様の企業のネットワーク環境で厳格な IP またはドメイン名のアクセスホワイトリストが設定されている場合は、必ず当社のアプリケーションウェブサイトをホワイトリストに追加してください。追加しない場合、Feishu 内でアプリケーションが正常に開けません。

[費用に関する注意事項] Feishu のバージョンと API 呼び出しの制限
- Feishu の無料版 をご利用の場合、カスタムアプリの API 呼び出しの上限は 月間 10,000 回 です。
- Feishu の有料版 をご利用の場合、この制限はありません。
- 注：当社のアプリケーションの主な API 呼び出しシナリオは、ロボットを介して @ メッセージリマインダーを送信することです。メッセージリマインダーは頻度をコントロールし、各ユーザーは最大でも 10 分に 1 回しか受信しません。お客様のチームのコミュニケーション頻度に基づいて、この量を評価してください。上記の月間 10,000 回は、すべての API の合計呼び出し回数です。無料版をご利用の場合は、他の呼び出しも考慮する必要があります。有料 API のリファレンス：https://open.feishu.cn/document/server-docs/api-call-guide/server-api-list?charge=all