13.8
웹훅 메시지 보내기
POST
/<guild_id>/api/tickets/<ticket_id>/webhook-message웹훅 형식의 메시지를 티켓 채널로 보냅니다. 자동 알림, 상태 변경, 외부 시스템에서 오는 메시지를 올릴 때 쓸모가 있습니다.
요청 본문
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| content | string | 선택 | 일반 텍스트 메시지 내용. |
| embed_title | string | 선택 | 임베드를 쓸 경우의 제목. |
| embed_description | string | 선택 | 임베드 본문 설명. |
| embed_color | string | 선택 | 임베드 색. 16진수 문자열이나 Discord 색 이름으로 지정합니다. |
| username | string | 선택 | 웹훅에 표시되는 이름을 바꿉니다. |
| avatar | string | 선택 | 웹훅의 프로필 사진을 이미지 URL로 바꿉니다. |
content, embed_title, embed_description 중 최소 하나는 있어야 합니다. 나머지 항목은 선택이며, 빠지면 기본값이 쓰입니다.
요청 예시
curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"content":"Deployment complete","embed_title":"Status Update","embed_description":"v2.4.1 is now live","embed_color":"#5865F2","username":"Deploy Bot"}' \
https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/webhook-message응답 예시
{
"success": true,
"message_id": "1234567890123456789"
}