메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.hyperx.dev/llms.txt

Use this file to discover all available pages before exploring further.

Support Ticket은 플레이어가 게임 안에서 문의를 만들고, 운영자가 Console에서 답변과 상태 관리를 하는 흐름입니다.

​
문의 생성

var ticket = await player.CreateSupportTicket(
    subject: "결제가 보이지 않아요",
    body: "상점에서 구매했지만 우편함에 보상이 없습니다.",
    category: "purchase"
);

Debug.Log(ticket.Ticket.Id);
category는 게임에서 정한 문자열을 사용합니다. 예를 들어 general, purchase, account, bug처럼 운영 큐를 나누는 값으로 사용할 수 있습니다.

​
내 문의 목록과 상세

var openTickets = await player.ListSupportTickets(
    status: "open",
    limit: 20
);

var detail = await player.GetSupportTicket(openTickets[0].Id);
목록은 현재 로그인한 유저의 문의만 반환합니다. 상세에는 ticket, message, attachment metadata가 포함됩니다.

​
답변 추가

await player.ReplySupportTicket(
    detail.Ticket.Id,
    "영수증 스크린샷을 첨부했습니다."
);
운영자 답변과 유저 답변은 같은 ticket thread에 기록됩니다. 운영자 전용 내부 메모는 Console에서만 작성하고 볼 수 있습니다.

​
첨부 metadata

초기 SDK는 파일 자체를 업로드하지 않고, 게임이 업로드한 파일의 metadata를 ticket에 연결합니다. 파일은 프로젝트의 보안 정책에 맞는 저장소에 업로드한 뒤 storageKey를 전달하세요. 
await player.AddSupportAttachment(
    ticket.Ticket.Id,
    filename: "receipt.png",
    contentType: "image/png",
    sizeBytes: 184320,
    storageKey: "support/user-123/receipt.png"
);

​
Console 처리

운영자는 Console Support 화면에서 문의를 검색하고, 상태와 우선순위를 바꾸며, 답변과 내부 메모를 남길 수 있습니다. 필요한 경우 CSV로 내보내 운영 리포트나 장애 조사에 사용할 수 있습니다.