DMS は DingTalk、DingTalk Enterprise、Feishu と統合して通知チャネルとして機能します。モバイルデバイスやクライアントで通知を表示できます。承認者はモバイルデバイスでチケットを承認することもできます。
前提条件
DingTalk または Feishu で組織を作成済みであること。
この組織は社内企業組織です。Alibaba Cloud Service Support などのパブリックな Alibaba Cloud 組織ではありません。
注意事項
チケットの承認はモバイルデバイスでのみサポートされています。
Alibaba Group の内部ユーザーの場合は、DMS テクニカルサポート (DingTalk グループ番号: 87370028482) にお問い合わせください。
米国サイトではメッセージ通知はサポートされていません。
準備
メッセージを受信するためのアプリケーションを構成します。
DingTalk/DingTalk Enterprise
アプリケーションの作成。
DingTalk 組織にログインして参加します。
DingTalk Open Platform にログインします。
自社の組織を選択します。たとえば、「XXX Test Organization」などです。
DingTalk コンソールに移動して DingTalk アプリケーションを作成します。
ページの右上隅にある [マイコンソール] をクリックします。
[アプリケーション開発] タブをクリックします。左側のナビゲーションウィンドウで、 を選択します。
[アプリケーションの作成] をクリックします。
[アプリケーション名] と [アプリケーションの説明] を入力し、[保存] をクリックします。
メッセージを受信するように DingTalk ロボットを構成します。
作成したアプリケーションの名前をクリックして、アプリケーション編集ページに移動します。
左側のナビゲーションウィンドウで、 を選択し、ロボットを追加します。
[ロボットの紹介]、[ロボットの説明]、[メッセージ受信モード] を構成し、[公開] をクリックします。
説明[メッセージ受信モード] を HTTP モードに設定します。
Web アプリケーション情報を構成します。
Web アプリケーションを追加した後、[アプリケーション機能] メニューで [Web アプリケーション] をクリックします。
アプリケーションのホームページ URL を設定し、[保存] をクリックします。
ホームページ URL は、現在の DMS データ処理リージョンによって異なります。たとえば、データ処理リージョンがシンガポールの場合、アプリケーションのホームページ URL は
https://dms-ap-southeast-1.alibabacloud.comです。説明データ処理リージョンを表示するには、「DMS デプロイメントリージョンを切り替える」をご参照ください。
中国 (杭州):
https://dms-cn-hangzhou.alibabacloud.com。日本 (東京):
https://dms-ap-northeast-1.alibabacloud.com。シンガポール:
https://dms-ap-southeast-1.alibabacloud.com。マレーシア (クアラルンプール):
https://dms-ap-southeast-3.alibabacloud.com。インドネシア (ジャカルタ):
https://dms-ap-southeast-5.alibabacloud.com。SAU (リヤド - パートナーリージョン):
https://dms-me-central-1.alibabacloud.com。中国 (香港):
<a href="https://dms-cn-hongkong.alibabacloud.com" id="0c5ce72573cfn" uuid="ba897e6a-66d7-4d24-b1cd-c1cc256337fc">https://dms-cn-hongkong.alibabacloud.com</a>。韓国 (ソウル):
<a href="https://dms-ap-northeast-2.alibabacloud.com" id="95873e62e290c" uuid="3ed56fc3-194d-4618-b7eb-70ae2871deeb">https://dms-ap-northeast-2.alibabacloud.com</a>。
権限を構成します。
左側のナビゲーションウィンドウで、 を選択し、次の権限をリクエストします。
Simple Notification Service (SNS) API を呼び出すために必要な基本権限
メンバー情報の読み取り権限
携帯電話番号に基づいて基本メンバー情報を取得する権限
エンタープライズ API を呼び出すための基本権限
DingTalk オープンインターフェイスのユーザーアクセス資格情報を取得するための基本権限
DingTalk グループの基本情報を管理する権限
社内エンタープライズロボットがメッセージを送信する権限
インタラクティブカードインスタンスの書き込み権限
新しいバージョンを作成して公開します。
企業の他のユーザーが使用する前に、カスタムエンタープライズアプリケーションのバージョンを公開する必要があります。
左側のナビゲーションウィンドウで、[バージョン管理と公開] を選択します。[新しいバージョンの作成] をクリックし、構成情報を入力して、[保存] をクリックします。
カードの作成。
テンプレートを作成します。
カードプラットフォーム に移動し、[テンプレートの作成] をクリックします。
[テンプレート名] を入力し、[カードタイプ] と [カードテンプレートシナリオ] を選択して、[作成] をクリックします。
カードテンプレートシナリオには、通常カードを選択します。関連アプリケーションには、作成したアプリケーションを選択します。
カードテンプレートをインポートします。
を選択します。メッセージ通知カードテンプレートをインポートして保存します。サンプルテンプレートについては、「DingTalkTemplate.json」をご参照ください。
メッセージ通知カードテンプレートを公開します。
Feishu/Lark (国際)
Feishu Open Platform または Lark Open Platform にログインし、開発者コンソールに移動します。
Feishu Open Platform または Lark Open Platform に移動します。
[ログイン] をクリックします。
ログインアカウントは、ターゲットの企業組織に属している必要があります。たとえば、組織名は「XXX Test Organization」です。
ログインして [開発者コンソール] に移動します。
[カスタムエンタープライズアプリケーションの作成] をクリックします。[名前] や [アプリケーションの説明] などのパラメーターを構成し、[作成] をクリックします。詳細については、「カスタムエンタープライズアプリケーションの開発プロセス」をご参照ください。
Feishu ロボットを追加します。
(オプション) アプリケーション名をクリックして、アプリケーション編集ページに移動します。
説明アプリケーションを作成したばかりの場合は、このステップをスキップできます。
左側のナビゲーションウィンドウで、 を選択します。
[機能別に追加] タブの [ロボット] カードで、[追加] をクリックします。
[ロボット] ページで、ロボット名を入力して [保存] をクリックします。
Web アプリケーションを追加します。
左側のナビゲーションウィンドウで、 を選択します。
[機能別に追加] タブの [Web アプリ] カードで、[追加] をクリックします。
[Web アプリ] ページで、[モバイルホームページ] の URL を入力し、[保存] をクリックします。
ホームページ URL は、現在の DMS データ処理リージョンによって異なります。たとえば、データ処理リージョンがシンガポールの場合、アプリケーションのホームページ URL は
https://dms-ap-southeast-1.alibabacloud.comです。説明データ処理リージョンを表示するには、「DMS デプロイメントリージョンを切り替える」をご参照ください。
中国 (杭州):
https://dms-cn-hangzhou.alibabacloud.com。日本 (東京):
https://dms-ap-northeast-1.alibabacloud.com。シンガポール:
https://dms-ap-southeast-1.alibabacloud.com。マレーシア (クアラルンプール):
https://dms-ap-southeast-3.alibabacloud.com。インドネシア (ジャカルタ):
https://dms-ap-southeast-5.alibabacloud.com。SAU (リヤド - パートナーリージョン):
https://dms-me-central-1.alibabacloud.com。
リダイレクト URL と信頼できる H5 ドメイン名を追加します。
左側のナビゲーションウィンドウで、 を選択します。
[リダイレクト URL] タブで、[リダイレクト URL] と [信頼できる H5 ドメイン名] を構成できます。
リダイレクト URL と信頼できる H5 ドメイン名は、DMS データ処理リージョンによって異なります。たとえば、DMS データ処理リージョンがシンガポールの場合、リダイレクト URL は
https://dms-ap-southeast-1.alibabacloud.com/console/mobile/index/で、信頼できる H5 ドメイン名はhttps://dms-ap-southeast-1.alibabacloud.comです。各エントリに対して [追加] をクリックします。
アプリケーションの権限を構成します。
左側のナビゲーションウィンドウで、 を選択します。
[権限管理] タブで、[権限を有効にする] をクリックします。
[アプリ ID 権限 (tenant_access_token)] タブで、次の権限をリクエストします。権限のリクエストとその説明の詳細については、「権限のリクエスト」および「権限の説明」をご参照ください。
ユーザー ID の取得
携帯電話番号またはメールでユーザー ID を取得
クラウドドキュメントへの画像と添付ファイルのアップロード
説明Lark はこの権限をサポートしていません。
プライベートメッセージとグループメッセージの取得と送信
アプリケーションとしてメッセージを送信
複数のユーザーにバッチでメッセージを送信
画像またはファイルリソースの取得とアップロード
アプリケーションのバージョンを公開します。
企業の他のユーザーが使用する前に、カスタムエンタープライズアプリケーションのバージョンを公開する必要があります。
左側のナビゲーションウィンドウで、 を選択します。
[バージョンの作成] をクリックします。
[アプリのバージョン] を入力し、[デフォルトのモバイル機能] を選択し、他の設定を構成して、[保存] をクリックします。
[可用性] を [すべてのメンバー] に設定します。
DingTalk、DingTalk Enterprise、または Feishu からキー情報を取得します。この情報は、DMS で通知チャネルを構成するために使用されます。
DingTalk
AppId、AgentId、AppKey、AppSecret を取得する
アプリケーションの AppId、AgentId、AppKey、および AppSecret は、DingTalk Open Platform の [認証情報と基本情報] ページから取得できます。
RobotCode を取得する
DingTalk 開発者プラットフォームでは、 ページから RobotCode を取得できます。
カードテンプレート ID を取得する
カードプラットフォーム の ページから ID を取得できます。
CorpId を取得する (オプション)
DingTalk 開発者コンソール に移動し、プロファイル画像をクリックして CorpId を取得します。
説明DMS 通知チャネルで CorpId パラメーターを構成すると、DingTalk 組織をカスタムエンタープライズアプリケーションがある組織に切り替えることなく、メッセージの受信とチケットの承認ができます。
DingTalk Enterprise
AppKey と AppSecret を取得する
DingTalk Open Platform の [基本情報] ページからアプリケーションの AppKey と AppSecret を取得します。
RobotCode を取得する
DingTalk Open Platform の [ロボット] ページで、資格情報から RobotCode を取得できます。
カードテンプレート ID を取得する
カードプラットフォーム の ページで ID を取得できます。
CorpId を取得する (オプション)
DingTalk 開発者コンソール に移動し、プロファイル画像をクリックして CorpId を取得します。
説明DMS 通知チャネルで CorpId パラメーターを構成すると、DingTalk 組織をカスタムエンタープライズアプリケーションがある組織に切り替えることなく、メッセージの受信とチケットの承認ができます。
Feishu/Lark
Feishu Open Platform または Lark Open Platform の ページで AppId と AppSecret を取得できます。
ステップ 1: DMS で通知チャネルを有効にして構成する
DMS のチャネル管理機能を使用すると、テナントレベルの通知チャネルを有効または無効にしたり、Feishu や DingTalk Enterprise などのアプリケーションの構成情報を維持したりできます。
ターゲットチャネルを有効にすると、DMS で構成した通知設定が有効になります。その後、DMS はそのチャネルを通じて通知を送信します。
管理者または DBA のみが通知チャネルを構成できます。
- DMS コンソール V5.0 にログインします。
コンソールの左上隅にある
アイコンをクリックし、 を選択します。説明コンソールを通常モードで使用している場合は、上部のメニューバーから を選択します。
ページの左上隅にある [チャネル管理] をクリックします。
ターゲットの通知チャネルを選択します。
Feishu、Lark、DingTalk、または DingTalk Enterprise に必要な情報を構成します。
次の例は、Feishu のチャネル情報を構成する方法を示しています。他のチャネルの手順も同様です。
Feishu チャネルセクションで、[編集] をクリックします。
[AppId] と [AppSecret] を入力し、[保存] をクリックします。
ステップ 2: メッセージ通知を受信するユーザーを設定する
次の例は、承認待ちのデータエクスポートチケットの通知を構成する方法を示しています。
管理者は、メッセージを受信するユーザーを DMS に追加します。詳細については、「ユーザー管理」をご参照ください。
管理者または DBA は、DMS の [通知管理] ページに移動します。
通知管理ページで、メッセージ通知を更新する DMS 機能モジュールを選択します。
[モジュール/ビジネスタイプ] フィルターボックスで、 を選択します。
ビジネスステータスが [承認待ち] のチケットを見つけ、右側の列にある [変更] をクリックします。
[追加通知ユーザー] セクションで、目的のユーザーを選択し、[OK] をクリックします。
メッセージ通知を有効にします。
承認待ちの後続のデータエクスポートチケットの通知は、DingTalk、DingTalk Enterprise、または Feishu を通じて指定されたユーザーに直接送信されます。
参考資料
DMS を使用すると、モバイルデバイスでチケットを迅速に処理できるため、開発効率が大幅に向上します。詳細については、「モバイルデバイスでチケットを承認する」をご参照ください。
よくある質問
Q: 個人の通知設定で Feishu、DingTalk、DingTalk Enterprise、または Lark のチャネル情報を構成しましたが、Feishu、DingTalk、またはその他のチャネル経由で DMS メッセージ通知を受信できないのはなぜですか？
A: Feishu、DingTalk、DingTalk Enterprise、または Lark 通知チャネルを有効にしているかどうかを確認してください。構成した情報は、対応するチャネルを有効にした後にのみ有効になります。その後、DMS はそのチャネルを通じてメッセージ通知を送信できます。チャネルを有効にする方法の詳細については、「ステップ 1: DMS で通知チャネルを有効にして構成する」をご参照ください。
Q: 通知チャネル情報を構成し、メッセージを受信するユーザーを指定した後でも、DingTalk または Feishu のメッセージを受信できないのはなぜですか？
A: この問題を解決するには、次の手順に従ってください。
管理者または DBA が DMS で対応するチャネルを有効にしているかどうかは、 を選択して確認できます。詳細については、「ステップ 1: DMS で通知チャネルを有効にして構成する」をご参照ください。
DMS プロファイル画像をクリックし、通知方法で対応する通知チャネルが有効になっていることを確認します。
Q: 通知設定を変更していないのに、突然 DingTalk や Feishu のメッセージが届かなくなりました。原因は何でしょうか？
A: カスタムエンタープライズアプリケーションの API 呼び出し回数が上限を超えたため、メッセージを受信できなくなった可能性があります。API 呼び出し量は、DingTalk または Feishu の開発者コンソールで確認できます。API 呼び出し回数を調整する方法の詳細については、DingTalk および Feishu のドキュメントをご参照ください。