開発ガイドよくある質問
チャット管理
グループ URL に有効期限はありますか？失効した場合はどうすればよいですか？
回答：グループ URL には有効期限があり、デフォルトの有効期限は 365 日です。グループ作成者やグループ名などが変更されると、グループ URL の有効期限切れが発生します。グループ作成時の UUID は何のために使用しますか？
回答：UUID は主にグループ作成リクエストの冪等性を制御し、操作ミスや再試行時にグループチャットが誤って重複作成されることを防ぐために使用されます。グループチャットのメンバーまたはグループチャット名情報を取得する方法
回答：グループチャットが社内グループの場合、グループ情報を取得する インターフェースで取得できます。メンバーが退職した際、一般グループから該当メンバーを自動的に削除する方法はありますか？
回答：一般グループには対応する方法はありません。一般グループ内のメンバーには他の関連関係が存在しないためです。現在、退職時に当該企業の内部グループから自動的に退出できるのは社内グループのみです。メッセージ通知
業務通知で OA メッセージを送信する際、受信者は 5 人を超えることができないと表示されるのはなぜですか？
回答：OA メッセージを送信する際、メッセージステータスバーが設定されている場合、システムは今後のメッセージステータスバーの更新に備える必要があるため、システム処理時間が長くなります。そのため、1 回のリクエストで最大 5 人にしか送信できません。詳細は メッセージ通知タイプ - OA メッセージ を参照してください。業務通知の送信に失敗した原因を取得するにはどうすればよいですか？
回答：業務通知クエリインターフェースを使用して業務通知の送信結果を照会できます。送信結果には、なぜ受信されなかったかが表示されます。例えば、userId が無効、送信頻度が高すぎるなどです。詳細は 業務通知メッセージの送信結果を取得する インターフェースを参照してください。業務通知の送信結果の照会と業務通知の更新が、ときどき失敗するのはなぜですか？
回答：よくある失敗原因は、業務通知の結果照会と更新時間が業務通知送信の期限（24 時間）を超えていることです。照会および更新時間が送信の有効期限内であるかを確認することをお勧めします。リンクを DingTalk 内で開くか、ブラウザで開くかを制御するにはどうすればよいですか？
回答：pc_slide 属性により、DingTalk 内のブラウザでリンクを開くかどうかを制御できます。- ブラウザで開く：
dingtalk://dingtalkclient/page/link?url=https%3A%2F%2Fwww.baidu.com&pc_slide=false&title=title - DingTalk 内で開く：
dingtalk://dingtalkclient/page/link?url=https%3A%2F%2Fwww.baidu.com&pc_slide=true&title=title
説明
- url：アクセスするアドレス。urlEncode によるエンコードが必要
- pc_slide：ブラウザで開くか DingTalk 内で開くかを制御
- title：DingTalk 内で開いた際に左上に表示される文字。デフォルトは「詳細」
業務通知メッセージインターフェースの呼び出しに失敗
業務通知メッセージインターフェースの呼び出しでエラーが発生した場合は、以下の情報を参考にトラブルシューティングを行ってください。-
まず、業務メッセージインターフェースの呼び出し制限によるものかを確認します。
- 同一アプリの同一メッセージ内容は、同一ユーザーに対して 1 日 1 回しか受信できません。
- 同一マイクロアプリから同一ユーザーへのメッセージ送信は、社内アプリ開発方式では 1 日 500 回を超えてはなりません。
- to_all_user パラメータを設定した全員へのプッシュメッセージは、1 日最大 3 回です。
- 同一マイクロアプリから同一ユーザーへのメッセージ送信は、サードパーティ社内アプリでは 1 日 100 回を超えてはなりません。
- 業務通知メッセージの送信進捗を取得する インターフェースを呼び出し、当該業務メッセージの送信が完了しているかを確認します。
- 業務通知メッセージの送信結果を取得する インターフェースを呼び出し、受信者が forbidden_user_id_list 内にある場合は業務メッセージ送信回数制限を超えていることを示し、failed_user_id_list 内にある場合は受信者の受信に失敗していることを示すため、再送信してください。
- 「メッセージリンクを PC のワークスペースで開く」というリダイレクト方式は、業務メッセージタイプが OA メッセージの場合のみ、モバイル端末からアプリへのリダイレクトをサポートします。
業務通知の送信とボットでのメッセージ送信で画像タイプを選択する際のフォーマット標準はそれぞれどのようなものですか？
回答：下表のとおりです。業務通知の送信時にエラーが出ないが、受信者が業務通知を受信していない
回答：業務通知を送信する において受信者が業務通知を受信できない場合、考えられる原因には以下が含まれますが、これらに限定されません。- 社内アプリのメッセージ送信は、1 回あたり最大 5000 人までです。
- 同一社員に対して、同一内容のメッセージ通知は 1 日 1 通しか送信できません。
- 社内アプリでは、各社員に対して 1 日最大 500 件のメッセージ通知を送信できます。
- 社内アプリでメッセージを送信する際、1 分あたり最大 5000 人がメッセージを受信できます。
業務通知を送信する際の注意事項は何ですか？
回答：業務通知の送信には以下の点に注意してください。- 同一アプリの同一メッセージ内容は、同一ユーザーに対して 1 日 1 回しか受信できません。
- 同一マイクロアプリから同一ユーザーへのメッセージ送信は、社内アプリ開発方式では 1 日 500 回を超えてはなりません。
- to_all_user パラメータを設定した全員へのプッシュメッセージは、1 日最大 3 回です。
- 同一マイクロアプリから同一ユーザーへのメッセージ送信は、サードパーティ社内アプリでは 1 日 100 回を超えてはなりません。
- 業務通知メッセージの送信進捗を取得するインターフェースを呼び出し、当該業務メッセージの送信が完了しているかを確認します。
- 業務通知メッセージの送信結果を取得するインターフェースを呼び出し、受信者が forbidden_user_id_list 内にある場合は業務メッセージ送信回数制限を超えていることを示し、failed_user_id_list 内にある場合は受信者の受信に失敗していることを示すため、再送信してください。
- 「メッセージリンクを PC のワークスペースで開く」というリダイレクト方式は、業務メッセージタイプが OA メッセージの場合のみ、モバイル端末からアプリへのリダイレクトをサポートします。
PC 側でメッセージリンクをサイドバーで開くにはどうすればよいですか？
回答：PC クライアントでメッセージ内の URL リンクをクリックした際、ブラウザに外部遷移せず PC クライアントで開きたい場合は、メッセージリンクの説明 を参照してください。 例：dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fwww.dingtalk.io&pc_slide=true
パラメータ説明：渡す URL は必ず urlEncode（エンコード処理）してください。pc_slide が true の場合は PC クライアントのサイドバーで開き、false または未指定の場合はブラウザで開きます。
ボット
グループプラグインの編集または削除方法
回答：グループプラグインは現在、編集および削除機能をサポートしていません。ボット名の変更を反映するには
回答：ボット名の変更を反映する方法は以下のとおりです。- ボット名を変更した後、正式なグループチャットに追加したボット名が反映されます。
- デバッグをクリックして入ったテストグループ「xxxxxxxx-TEST」の場合、ボット名を変更した後、再度デバッグをクリックする必要があり、そうしないと名前の変更が反映されません。
ボットにアップロードしたプロフィール写真が Windows 側で鮮明に表示されない
回答：PC 側でボットのプロフィール写真が鮮明に表示されない原因は以下のとおりです。 これは PC 側デバイスの画面解像度に起因するもので、画面解像度の違いにより表示効果が異なります。ボットを呼び出して markdown メッセージを送信する際、スペースと改行はどのように実装しますか？
回答：スペースと改行の実装方法は以下のとおりです。- スペース形式：  または   または  
- 改行形式：\n
重要
\n の前後に半角スペース 2 つ。社内アプリのボットの robotCode を取得するにはどうすればよいですか？
回答：開発者バックエンド にログインし、ボットの保存・公開が完了した後、ボットの robotCode を確認できます。社内アプリのボットをグループに追加するにはどうすればよいですか？
説明
- 社内ボットの保存・公開が完了していること。詳細は 社内ボットを設定する を参照してください。
- 社内アプリの公開が完了していること。そうでないと、社内の他のユーザーが当該ボットを確認できません。詳細はアプリの公開を参照してください。
社内アプリのボットの Webhook の access_token を取得するにはどうすればよいですか？
ボットをグループに追加した後にのみ、ボットの Webhook の access_token 値を確認できます。
DingTalk クライアントで手動で社内グループを作成するにはどうすればよいですか？
ボットが所属する企業で、社内グループを作成します。当該企業の社内グループが既に存在する場合、この手順はスキップできます。例えば「ボット」が所属する企業が「テスト組織デモ」の場合、作成する社内グループは「テスト組織デモ[内部グループ]」である必要があります。