> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DingTalk

> 人間の入力ノードのリクエストを、リンク付きのテキストメッセージとして DingTalk に届けます。アプリの作成、Dify との接続、問題の解決方法を説明します

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](https://docs.dify.ai/en/self-host/use-dify/workspace/channels/dingtalk.md) を参照してください。

Dify は、DingTalk の組織に作成した社内アプリを通じて動作します。このアプリは次の役割を担います。

* ボットを通じてメンバーにリクエストを送信します。各リクエストは、Dify のフォームへのリンク付きのテキストメッセージとして届きます。
* Dify がメンバーディレクトリを読み取り、メールアドレスで各メンバーをワークスペースのメンバーと照合できるようにします。

## 始める前に

次の点を確認してください。

* DingTalk 組織の開発者コンソールで、社内アプリを作成できること。
* [`CONSOLE_WEB_URL`](https://docs.dify.ai/ja/self-host/deploy/configuration/environments#console_web_url) が、メンバーがアクセスできるアドレスに設定されていること。すべてのリクエストのリンク先はこのアドレスです。

## アプリの作成

[DingTalk 開発者コンソール](https://open-dev.dingtalk.com/) で **App Development** > **DingTalk App** に移動します。**Create App** をクリックし、アプリの名前と説明を入力して **Save** をクリックします。続いて、次の手順を実行します。

1. アプリで **Add App Capability** を開き、**Bot** カードの **Add** をクリックします。

2. **Bots** ページで **Bot Configuration** をオンにし、必須項目を入力して **Publish** をクリックします。

   * **Bot name** には、「Dify」のようにメンバーが見てわかる名前を付けます。リクエストはこの名前のボットから届きます。

   * **Message receiving mode** は **Stream mode** のままにします。

3. **Manage permissions** を開きます。**Contacts API permission scope** は **All employees** に設定します。続いて、次の権限コードをそれぞれ検索して有効にします。

   * `qyapi_robot_sendmsg`
   * `qyapi_get_department_list`
   * `qyapi_get_department_member`
   * `qyapi_get_member`
   * `fieldEmail`

4. **Version Management and Release** で **Create New Version** をクリックします。**Available scope** を **All employees** に設定し、**Save** をクリックします。

   DingTalk の管理者でない場合は、先に管理者の承認が必要になることがあります。公開が完了してから、Dify での接続に進んでください。

## Dify での接続

1. **設定** > **チャネル** で DingTalk を探し、**接続** をクリックします。

   > [!NOTE]
   >
   > すでに別の IM（インスタントメッセージングアプリ）を接続している場合は、代わりに **交換する** をクリックします。先に [置き換えで消去される内容](https://docs.dify.ai/ja/self-host/use-dify/workspace/channels/overview#im-の置き換えと削除) を確認してください。

2. DingTalk の値を入力します。

   * **企業 ID**：開発者コンソールのホームページにある **CorpId** です。
   * **クライアントID**、**クライアントシークレット**：アプリの **Credentials and Basic Information** にあります。

   > [!NOTE]
   >
   > DingTalk 側でこれらの値を変更した場合は、Dify 側も更新してください。

3. **接続** をクリックします。Dify は保存前に接続を確認します。

## 同期とテスト

1. **チャネル** で **今すぐ同期** をクリックし、メンバーの IM アカウントをバインドします。各結果の意味については、[メンバーの同期](https://docs.dify.ai/ja/self-host/use-dify/workspace/channels/overview#メンバーの同期) を参照してください。

2. 自分の IM アカウントをバインドした状態で、自分宛てにテストリクエストを送信します。

   * メッセージが届くかを手早く確認するには、人間の入力ノードの **メッセージテンプレート** にある **メッセージをテスト** を使います。**テストチャネル** で DingTalk を選択し、**保存してテスト** をクリックします。ワークフローを実行せずに、メッセージが自分宛てに送信されます。
   * フロー全体を確認するには、ノードでデバッグモードをオンにし、DingTalk を選択してワークフローをテスト実行します。ボットとのチャットにメッセージが届いたら、リンクを開いてサインインし、応答して、実行が続行されることを確認します。

   テストが失敗した場合や何も届かない場合は、[トラブルシューティング](#トラブルシューティング) を参照してください。

## メンバー側の表示

各リクエストは、メンバーとボットの 1 対 1 のチャットに届きます。内容はノードの [メッセージテンプレート](https://docs.dify.ai/ja/self-host/use-dify/nodes/human-input.md#write-the-notification) から作成されるテキストメッセージで、件名の後に、リンクを含む本文が続きます。

![DingTalk メッセージとして届いたリクエスト](https://mintcdn.com/dify-6c0370d8/Q8QYd_xcsh-LWaCu/images/use-dify/workspace/channels-dingtalk-request-message.png?fit=max\&auto=format\&n=Q8QYd_xcsh-LWaCu\&q=85\&s=0150b37deb18378db1afa8780c342748)

DingTalk メッセージとして届いたリクエスト

メンバーが最初に目にするのは件名です。「注文 1042 の返金承認」のように、何を判断するのかがわかる件名にしてください。

メンバーはリンクを開き、リクエストの送信先のアカウントでサインインして、Dify で応答します。転送されたリンクはほかの人には機能しないため、応答する必要がある人は全員受信者に追加してください。

## トラブルシューティング

> [accordion] 接続時に「DingTalk could not verify complete member authorization」と表示される
>
> Dify が DingTalk のディレクトリ全体を読み取れません。**Contacts API permission scope** が **All employees** に設定されていないためです。**Manage permissions** で変更してから、もう一度 **接続** をクリックしてください。

> [accordion] 接続が API エラーコード 88 または 60011 で失敗する
>
> アプリに `qyapi_get_department_list` 権限がありません。**Manage permissions** で有効にしてから、もう一度 **接続** をクリックしてください。

> [accordion] 同期時に、DingTalk のディレクトリを読み取れないと表示される
>
> 多くの場合、アプリに `qyapi_get_department_member` 権限がありません。**Manage permissions** で有効にしてから、もう一度同期してください。

> [accordion] 同期後もメンバーが「一致なし」のままになる
>
> Dify が、一致するメールアドレスを見つけられていません。影響を受けている範囲によって、原因が異なります。
>
> * すべてのメンバー：アプリに `fieldEmail` 権限がありません。**Manage permissions** で有効にしてから、もう一度同期してください。
> * 一部のメンバー：Dify が読み取るのは DingTalk プロフィールのメールアドレスで、企業メールボックスではありません。企業メールボックスしかないメンバーは、プロフィールにメールアドレスを追加してもう一度同期するか、[手動でバインド](https://docs.dify.ai/ja/self-host/use-dify/workspace/contacts.md#手動でのバインド) してください。

> [accordion] テストリクエストが失敗する
>
> 何らかの原因で、Dify が送信できていません。**メッセージをテスト** で「テストに失敗しました。チャネル設定を確認して、もう一度お試しください。」と表示されるか、デバッグモードでの実行が「No one can approve this step.」というエラーで失敗します。
>
> 次の点を確認してください。
>
> * アプリで `qyapi_robot_sendmsg` が有効になっていること。
> * ボットが公開済みで、その後にアプリのバージョンを公開していること。
> * 自分の IM アカウントがバインドされていること。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.