(급) 카카오 모먼트 400 INVALID_TEMPLATE 오류 문의

adAccountId : 727794

ㅁ creativeId: 30403323

messageSerialNumber: 20260402-30403323-d772dk86ngis73btpr70

안녕하세요, 아래와 같이 당사 백엔드에서 카카오 모먼트 API 호출하였습니다.

http dump POST /openapi/v4/messages/creatives/30403323/sendPersonalMessages HTTP/1.1\r\nHost: apis.moment.kakao.com\r\nAdaccountid: 727794\r\nAuthorization: Bearer pWdlG0WabkQY8iQnQWpGCpNKXgM-vvcWAAAAAwoqJREAAAGTQxM8ceZNgpjs3oAL\r\nContent-Type: application/json\r\n\r\n{\"requestId\":\"20260402-30403323-d772dk86ngis73btpr8g\",\"receivers\":[{\"messageSerialNumber\":\"20260402-30403323-d772dk86ngis73btpr70\",\"receiverType\":\"PHONE_NUMBER\",\"receiverKey\":\"+821020719261\",\"variables\":{\"image_url1\":\"http://t1.daumcdn.net/b2/personalMessage/727794/28f864430d7452d5a8b77ee4c6899804.png\",\"mobile_url1\":\"https://callback.api.qgraph.io/track/click/6c0d72886c177a062251/?p=rlWho3EcMzywLKEco25WMPV6ZmN2ZmR0ZwNjZQNfVzSjpRyxVwbvAzZjMQplBQt2LmR3A2RjAwVlAGRvYPWiplV6VaqyLvVfVaImMKWWMPV6ZmplBQRjZwLmZmNmAQD5AFjvqKWfVwbvnUE0pUZ6Yl93q3phMaWcp2WyMJgipzIuYzAioF9mnT9jGJ8ip3IvY3AuoTHhMT8_qKEgK21yMTy1oG1GGyZzqKEgK3AiqKWwMG1YDHgOG1EOGRfvsD\",\"pc_url1\":\"https://callback.api.qgraph.io/track/click/6c0d72886c177a062251/?p=rlWho3EcMzywLKEco25WMPV6ZmN2ZmR0ZwNjZQNfVzSjpRyxVwbvAzZjMQplBQt2LmR3A2RjAwVlAGRvYPWiplV6VaqyLvVfVaImMKWWMPV6ZmplBQRjZwLmZmNmAQD5AFjvqKWfVwbvnUE0pUZ6Yl93q3phMaWcp2WyMJgipzIuYzAioF9mnT9jY3A1Lv9mLJkyYzEiC3I0oI9gMJEcqJ09H05GWaI0oI9mo3IlL2H9F0SYDH9HDHkYVa0\",\"user_name1\":\"김태완\"}},{\"messageSerialNumber\":\"20260402-30403323-d772dk86ngis73btpr7g\",\"receiverType\":\"PHONE_NUMBER\",\"receiverKey\":\"+821063928830\",\"variables\":{\"image_url1\":\"http://t1.daumcdn.net/b2/personalMessage/727794/28f864430d7452d5a8b77ee4c6899804.png\",\"mobile_url1\":\"https://callback.api.qgraph.io/track/click/6c0d72886c177a062251/?p=rlWho3EcMzywLKEco25WMPV6ZmN2ZmR0ZwNjZQNfVzSjpRyxVwbvAzZjMQplBQt2LmR3A2RjAwVlAGRvYPWiplV6VaqyLvVfVaImMKWWMPV6BQp0AQH4BGN4AwR1BGR1AFjvqKWfVwbvnUE0pUZ6Yl93q3phMaWcp2WyMJgipzIuYzAioF9mnT9jGJ8ip3IvY3AuoTHhMT8_qKEgK21yMTy1oG1GGyZzqKEgK3AiqKWwMG1YDHgOG1EOGRfvsD\",\"pc_url1\":\"https://callback.api.qgraph.io/track/click/6c0d72886c177a062251/?p=rlWho3EcMzywLKEco25WMPV6ZmN2ZmR0ZwNjZQNfVzSjpRyxVwbvAzZjMQplBQt2LmR3A2RjAwVlAGRvYPWiplV6VaqyLvVfVaImMKWWMPV6BQp0AQH4BGN4AwR1BGR1AFjvqKWfVwbvnUE0pUZ6Yl93q3phMaWcp2WyMJgipzIuYzAioF9mnT9jY3A1Lv9mLJkyYzEiC3I0oI9gMJEcqJ09H05GWaI0oI9mo3IlL2H9F0SYDH9HDHkYVa0\",\"user_name1\":\"심별\"}},{\"messageSerialNumber\":\"20260402-30403323-d772dk86ngis73btpr80\",\"receiverType\":\"PHONE_NUMBER\",\"receiverKey\":\"+821057931335\",\"variables\":{\"image_url1\":\"http://t1.daumcdn.net/b2/personalMessage/727794/28f864430d7452d5a8b77ee4c6899804.png\",\"mobile_url1\":\"https://callback.api.qgraph.io/track/click/6c0d72886c177a062251/?p=rlWho3EcMzywLKEco25WMPV6ZmN2ZmR0ZwNjZQNfVzSjpRyxVwbvAzZjMQplBQt2LmR3A2RjAwVlAGRvYPWiplV6VaqyLvVfVaImMKWWMPV6AmtmBQH4AQZlZQR5ZQZ2AljvqKWfVwbvnUE0pUZ6Yl93q3phMaWcp2WyMJgipzIuYzAioF9mnT9jGJ8ip3IvY3AuoTHhMT8_qKEgK21yMTy1oG1GGyZzqKEgK3AiqKWwMG1YDHgOG1EOGRfvsD\",\"pc_url1\":\"https://callback.api.qgraph.io/track/click/6c0d72886c177a062251/?p=rlWho3EcMzywLKEco25WMPV6ZmN2ZmR0ZwNjZQNfVzSjpRyxVwbvAzZjMQplBQt2LmR3A2RjAwVlAGRvYPWiplV6VaqyLvVfVaImMKWWMPV6AmtmBQH4AQZlZQR5ZQZ2AljvqKWfVwbvnUE0pUZ6Yl93q3phMaWcp2WyMJgipzIuYzAioF9mnT9jY3A1Lv9mLJkyYzEiC3I0oI9gMJEcqJ09H05GWaI0oI9mo3IlL2H9F0SYDH9HDHkYVa0\",\"user_name1\":\"백시연\"}}]}

이 호출에 대한 응답이 아래와 같이 왔고 메시지 발송 실패 (수신 X) 하였습니다.

{
“event_name”: “message_error”,
“server_ts”: 1775118033,
“client_ts”: 1775118033,
“event_uuid”: “ef4e5051-8b5e-4339-b280-ccb87e0070bd”,
“parameters”: {
“category”: “vendor”,
“code”: “ESS-MSG-V-005”,
“detail”: “Unknown error”,
“group_id”: “1ea99ec3-563f-44ba-af4a-ca344ba2e8bb”,
“identifier_key”: “phone_no”,
“identifier_value”: “821057931335”,
“product_properties”: {
“appId”: “6c0d72886c177a062251”,
“channel”: “kakao_moment”,
“cid”: 3063142,
“notificationId”: 30631420000,
“os”: “web”,
“userIds”: [
3728102633034495,
8744589086159155,
7838584320190367
]
},
“raw_error”: {
“code”: -813,
“msg”: “KakaoMomentException”,
“extras”: {
“detailCode”: 75711,
“detailMsg”: “개인화메시지 발송 요청이 실패하였습니다.”,
“details”: [
{
“description”: {
“status”: 400,
“detail”: “Template 요청 오류”,
“error”: {
“code”: “4102”,
“detail”: “INVALID_TEMPLATE”,
“location”: “BZM_DIRECT_API”
}
}
}
]
}
},
“receiver_properties”: {
“userId”: 7838584320190367
},
“run_id”: “1ea99ec3-563f-44ba-af4a-ca344ba2e8bb”,
“stage”: “send”
},
“webhook_url”: “”,
“product_code”: “AQ”,
“account_id”: “3207”
}

오류 메세지가 아래와 같은데

{
“description”: {
“status”: 400,
“detail”: “Template 요청 오류”,
“error”: {
“code”: “4102”,
“detail”: “INVALID_TEMPLATE”,
“location”: “BZM_DIRECT_API”
}

어떤 사유로 발송 실패하였는지 구체적으로 가이드 주실 수 있으신가요?

매번 카카오 모먼트 api 호출(요청) 시 실패가 되면 정확한 실패 사유/원인이 나오지 않아 장애 해결에 차질을 겪고 있습니다 ㅜ

실제 캠페인 집행(발송) 이 곧 예정돼 있어서 빠르게 가이드해주시면 감사하겠습니다.

@Appier5197 안녕하세요 카카오모먼트 담당자입니다.

템플릿 등록 요청의 결과를 기다리지 않고 발송 요청을 하신 것으로 추정됩니다.

  • 템플릿 등록 일시: 2026-04-02 17:20:34
  • 발송 요청 일시: 2026-04-02 17:20:33

추가 확인이 필요한 부분이 있다면 말씀해주세요.

감사합니다.