DingTalk などのプラットフォームのチャット構成を作成、更新、取得、削除します。
操作説明
リクエストの説明
この API は、DingTalk などのインスタントメッセージ (IM) ツールと統合するためのチャットボット構成を作成、更新、取得、削除します。この API は、さまざまなユーザーまたはユーザーグループに対して詳細な権限コントロールを提供します。また、RAM ロールを指定して操作を実行したり、構成にタグを追加して管理と分類を容易にしたりすることもできます。
この API を呼び出す際は、RegionId、ConversationId、およびリクエストボディ内のすべてのパラメーターが正確であることを確認してください。ClientId や ClientSecret フィールドなどの機密情報は、不正な第三者への漏洩を防ぐために慎重に取り扱う必要があります。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-hangzhou |
| Name |
string |
任意 |
構成名。 |
chatOps-qiwei |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
成功した応答の詳細。 |
||
| RequestId |
string |
リクエスト ID。 |
4DB0****1234 |
| ChatConfiguration |
object |
チャット構成の詳細。これには、名前、タイプ、RAM ロールなどのプロパティが含まれます。 |
{ "Name": "chatops", "Type": "DingTalk", "RamRole": "OOSServiceRole", "Configuration": "{\"DingTalkClientId\": \"dingpxlbxp0rgs7uxmtb\", \"DingTalkClientSecret\": \"******\", \"DingTalkTemplateId\": \"381c5aee-f8af-48a4-94be-cce587e42ea4.schema\"}", "ResourceGroupId": "s", "CreatedDate": "2025-12-26T09:53:02+00:00", "UpdatedDate": "2026-01-07T02:14:55+00:00", "Outputs": "{\"URL\": \"https://1407907063606569.appflow.aliyunnest.com/webhook/\"}", "RequestId": "4DB0****1234" } |
| Name |
string |
チャット構成の名前。 |
chatops |
| Type |
string |
チャット構成のタイプ。有効な値：
TODO：この情報は、最近の API 呼び出しログに基づいて AI によって生成されました。正確性を確認してください。 |
DingTalk |
| RamRole |
string |
操作の実行に使用される RAM ロールの名前。 |
OOSServiceRole |
| Configuration |
string |
チャット構成の具体的な内容。これは、クライアント ID やキーなどの機密情報を含む JSON 文字列です。 |
{"DingTalkClientId": "dingpxlbxp0rgs7uxmtb", "DingTalkClientSecret": "******", "DingTalkTemplateId": "381c5aee-f8af-48a4-94be-cce587e42ea4.schema"} |
| ResourceGroupId |
string |
リソースが属するリソースグループの ID。 |
s |
| CreatedDate |
string |
チャット構成が作成された時間。フォーマットは ISO 8601 です。 |
2025-12-26T09:53:02+00:00 |
| UpdatedDate |
string |
チャット構成が最後に更新された時間。フォーマットは ISO 8601 です。 |
2026-01-07T02:14:55+00:00 |
| Outputs |
string |
チャット構成の出力情報。これは、Webhook URL などのパラメーターを含む JSON 文字列です。 |
{"URL": "https://1407907063606569.appflow.aliyunnest.com/webhook/"} |
例
成功レスポンス
JSONJSON
{
"RequestId": "4DB0****1234",
"ChatConfiguration": {
"Name": "chatops",
"Type": "DingTalk",
"RamRole": "OOSServiceRole",
"Configuration": "{\"DingTalkClientId\": \"dingpxlbxp0rgs7uxmtb\", \"DingTalkClientSecret\": \"******\", \"DingTalkTemplateId\": \"381c5aee-f8af-48a4-94be-cce587e42ea4.schema\"}",
"ResourceGroupId": "s",
"CreatedDate": "2025-12-26T09:53:02+00:00",
"UpdatedDate": "2026-01-07T02:14:55+00:00",
"Outputs": "{\"URL\": \"https://1407907063606569.appflow.aliyunnest.com/webhook/\"}"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。