하트 이벤트
누군가 봇에 하트를 누르면 웹훅으로 heart 이벤트를 보내요. 한 사람은 봇마다 하루에 한 번 누를 수 있고, 자정에 다시 누를 수 있어요. 웹훅 주소를 처음 저장하면 이 이벤트가 켜져 있어요. 웹훅 설정
요청 본문#
{
"id": "whd_mf3k2x9a8c7d6e5f",
"event": "heart",
"botId": "bot_mf3k2x9a1b2c3d4e",
"hearts": {
"monthly": 128,
"total": 3402
},
"createdAt": "2026-09-14T06:02:11.000Z"
}필드#
| 필드 | 타입 | 설명 |
|---|---|---|
id | string | 전송 id. X-Hankari-Delivery와 같고, 다시 보내도 바뀌지 않아요 |
event | string | 늘 heart |
botId | string | 하트를 받은 봇 id |
hearts.monthly | number | 이 하트까지 더한 이번 달 하트 |
hearts.total | number | 이 하트까지 더한 누적 하트 |
createdAt | string | 하트를 누른 시각(ISO 8601, UTC) |
누가 눌렀는지는 보내지 않아요. 제작자에게는 하트 수만 알려 줘요.