문서

TicketsX를 더 빠르게 익히세요

설정 안내, 전체 명령어 목록, Premium 기능, REST API를 한곳에 모았습니다.

13.8

웹훅 메시지 보내기

POST/<guild_id>/api/tickets/<ticket_id>/webhook-message

웹훅 형식의 메시지를 티켓 채널로 보냅니다. 자동 알림, 상태 변경, 외부 시스템에서 오는 메시지를 올릴 때 쓸모가 있습니다.

요청 본문

이름형식필수설명
contentstring
선택
일반 텍스트 메시지 내용.
embed_titlestring
선택
임베드를 쓸 경우의 제목.
embed_descriptionstring
선택
임베드 본문 설명.
embed_colorstring
선택
임베드 색. 16진수 문자열이나 Discord 색 이름으로 지정합니다.
usernamestring
선택
웹훅에 표시되는 이름을 바꿉니다.
avatarstring
선택
웹훅의 프로필 사진을 이미지 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"
}