생성¶
POST /api/v1/notify_object/create
개요¶
알림 객체를 생성합니다.
Body 요청 파라미터¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| type | string | 예 | 트리거 규칙 유형, 기본값은 trigger빈 값 허용: True 可选值: ['dingTalkRobot', 'HTTPRequest', 'wechatRobot', 'mailGroup', 'feishuRobot', 'sms', 'vms', 'simpleHTTPRequest', 'slackIncomingWebhook', 'teamsWorkflowWebhook', 'googleChatWebhook', 'telegramBot'] |
| name | string | 예 | 알림 객체 이름 빈 값 허용: False |
| optSet | json | 알림 설정 빈 값 허용: False |
|
| openPermissionSet | boolean | 사용자 지정 권한 구성 활성화 여부, (기본값 false: 비활성화), 활성화 시 해당 규칙의 작업 권한은 permissionSet에 따름 빈 값 허용: False |
|
| permissionSet | array | 작업 권한 구성, (소유자 제외) 역할, 멤버 UUID, 팀 UUID 구성 가능 예시: ['wsAdmin', 'acnt_xxxx', 'group_yyyy'] 빈 값 허용: False |
파라미터 추가 설명¶
데이터 설명.
**요청 파라미터 설명: ** | 파라미터명 | type | 설명 | | ---------------- | ---- | ---------------------------------------------------- | | name | string | 알림 객체 이름 | | type | string | 트리거 규칙 유형 | | optSet | dict | 알림 설정 | | openPermissionSet | boolean | 사용자 지정 권한 구성 활성화 여부, 기본값 false | | permissionSet | array | 작업 권한 구성 |
**1. type=dingTalkRobot optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| webhook | String | 필수 | DingTalk 봇 호출 URL |
| secret | String | 필수 | DingTalk 봇 호출 시크릿 (봇 추가 - 보안 설정 - 서명) |
**2. type=HTTPRequest 시, optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| url | String | 필수 | HTTP 호출 URL |
| headersConfig.isOpen | Boolean | 선택 | Header 구성 활성화 여부 |
| headersConfig.items[].key | String | 선택 | Header Key, 앞뒤 공백 제거 후 검증, 대소문자 미구분 중복 제거 |
| headersConfig.items[].value | String | 선택 | Header Value |
| headersConfig.items[].isSensitive | Boolean | 선택 | 민감 값 여부, 민감 값은 저장 시 암호화 |
| bodyTemplate | String | 선택 | 사용자 정의 Body 템플릿, HTTPRequest만 지원 |
**3. type=wechatRobot 시, optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| webhook | String | 필수 | 봇 호출 URL |
**4. type=mailGroup 시, optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| to | Array | 필수 | 멤버 계정 목록 |
**5. type=feishuRobot optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| webhook | String | 필수 | Lark 봇 호출 URL |
| secret | String | 필수 | Lark 봇 호출 시크릿 (봇 추가 - 보안 설정 - 서명) |
**6. type=sms 시, optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| to | Array | 필수 | 멤버 계정 UUID, 팀 UUID 목록 |
**7. type=simpleHTTPRequest 시, optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| url | String | 필수 | HTTP 호출 URL |
| headersConfig.isOpen | Boolean | 선택 | Header 구성 활성화 여부 |
| headersConfig.items[].key | String | 선택 | Header Key, 앞뒤 공백 제거 후 검증, 대소문자 미구분 중복 제거 |
| headersConfig.items[].value | String | 선택 | Header Value |
| headersConfig.items[].isSensitive | Boolean | 선택 | 민감 값 여부, 민감 값은 저장 시 암호화 |
8. type=slackIncomingWebhook 시, optSet 파라미터 (2025-03-26 릴리즈 신규 추가)
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| webhook | String | 필수 | 봇 호출 URL |
9. type=teamsWorkflowWebhook 시, optSet 파라미터 (2025-03-26 릴리즈 신규 추가)
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| webhook | String | 필수 | 봇 호출 URL |
**10. type=vms 전화 시, optSet 파라미터 **
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| to | Array | 필수 | 멤버 계정 UUID, 팀 UUID 목록 |
11. type=googleChatWebhook 시, optSet 파라미터 (2026-01-14 릴리즈 신규 추가)
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| webhook | String | 필수 | 봇 호출 URL |
12. type=telegramBot 시, optSet 파라미터 (2026-04-13 릴리즈 신규 추가)
| key | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| token | String | 필수 | Telegram Bot Token |
| chat_id | String | 필수 | 사용자 / 그룹 / 채널 ID |
| message_thread_id | String | 선택 | Topic / 주제 ID |
**permissionSet, openPermissionSet 필드 설명 (2024-06-26 릴리즈 신규 추가 필드): ** 알림 객체에 openPermissionSet을 활성화하면, 워크스페이스 소유자와 permissionSet에 구성된 역할, 팀, 멤버만 편집/삭제할 수 있습니다. 알림 객체에 openPermissionSet을 비활성화(기본값)하면, 삭제/편집 권한은 기존 인터페이스의 편집/삭제 권한을 따릅니다.
permissionSet 필드에는 역할 UUID(wsAdmin, general, readOnly, role_xxxxx), 팀 UUID(group_yyyy), 멤버 UUID(acnt_xxx)를 구성할 수 있습니다. permissionSet 필드 예시: