알림톡 치환 발송 a505 에러 확인 요청

문의|Support
1

샌드박스 환경에서 개발 연동 테스트 중인데요

같은 템플릿에 대해, 알림톡 일반 발송 시 text를 설정하는 방식으로 발송하면 성공 응답이 잘 떨어지는데

텍스트 치환 방식으로 발송하면 계속 Invalid or empty templateCode 에러가 발생합니다.

근데 또 같은 payload로 실서버 api로 쏘면 성공 응답이네요…;; 그래서 payload가 틀린 거 같진 않아서..

예시 infobankTrId: M-260711082413900STG61044, msgKey: 20260711172413907SOM206220010000

payload 예시


{    "destinations": [{

"to": "수신번호",

"replaceWords": {

replaceWords목록

      }

    }],

"messageFlow": [{

"alimtalk": {

"senderKey": "[senderKey]",

"templateCode": "[templateCode]",

"sendType": "template”

      }

    }]

  }

응답 예시

{

    "common": {

"authCode": "A000",

"infobankTrId": "M-260711082413900STG61044",

"authResult": "SUCCESS"

    },

"data": {

"code": "A000",

"result": "Success",

"data": {

"destinations": [

                {

"to": "수신번호",

"msgKey": "20260711172413907SOM206220010000",

"code": "A505",

"result": "Invalid or empty 'templateCode'"

                }

            ]

        }

    }

}

여러 템플릿으로 테스트 해봤는데 다 동일 오류로 안되네요

가이드에 있는 curl 그대로 한건데… 뭔가 시스템적 오류인지 확인 부탁드려요

추가로, 템플릿 조회 API (/v1/center/alimtalk/template) 이거도 샌드박스 환경에서만 “code”: “A502”,

"result": "Invalid or empty 'senderKey'" 오류가 나는데 같이 확인 부탁드립니다.
2

안녕하세요, 비즈고를 이용해 주셔서 감사합니다 :blush:

공통 원인

현재 사용 중이신 템플릿 코드와 발신프로필키(senderKey)는 운영(상용) 환경에 등록된 값입니다.
샌드박스에는 해당 템플릿·발신프로필이 등록되어 있지 않아, 이를 조회해야 하는 요청은 대상을 찾지 못해 "값이 비어있다"는 형태의 오류로 응답됩니다.
반면 등록 정보 조회가 필요 없는 요청(text를 직접 설정하는 일반 발송)은 샌드박스에서도 정상 응답됩니다.

1. 텍스트 치환 발송 — A505 (Invalid or empty ‘templateCode’)

치환 발송(sendType: "template" + replaceWords)은 서버가 등록된 템플릿 원문을 불러와 치환하는 방식입니다.
사용하신 템플릿 코드는 운영 환경에만 등록되어 있어, 샌드박스에서는 조회가 되지 않아 A505가 발생합니다.
payload에 templateCode가 정상적으로 담겨 있어도 마찬가지이며, 실서버에서 동일 payload가 정상 응답되는 것도 이 때문입니다. payload 자체에는 문제가 없습니다.

2. 템플릿 조회 API — A502 (Invalid or empty ‘senderKey’)

템플릿 조회 API 역시 등록된 발신프로필키 기준으로 조회하는 API입니다. 해당 발신프로필키가 샌드박스에 등록되어 있지 않아 A502가 발생하며, 동일한 맥락입니다.

안내

  • 텍스트 치환 발송과 템플릿 조회 API는 해당 템플릿·발신프로필키가 실제 등록된 운영(실서버) 환경에서 테스트해 주시기 바랍니다. 이미 실서버에서 동일 payload가 정상 응답되고 있어, 연동 자체는 문제없이 완료된 상태입니다.

  • 샌드박스는 요청/응답 포맷 확인 및 단순 발송 응답 테스트 용도로 활용하시길 권장드립니다.

추가로 궁금하신 점 있으시면 언제든 편하게 문의해 주세요. 감사합니다 :folded_hands:

3

안녕하세요! 답변 감사드립니다.

그러면 일부 기능은 샌드박스 환경에서 이용할 수 없다 - 로 이해하면 될까요?

샌드박스에서 이용할 수 없는 기능 목록을 알 수 있을까요? 개발에 참고하려 합니다.

4

안녕하세요! 다시 문의 주셔서 감사합니다 :blush:

네, 정확히 이해하셨습니다. 말씀하신 대로 일부 기능은 샌드박스 환경에서는 이용이 어렵습니다. 개발에 참고하실 수 있도록 기준과 함께 정리해 드릴게요.

샌드박스에서 이용 가능한 기능

샌드박스는 API 요청/응답 포맷을 검증하기 위한 환경입니다.

  • 요청 파라미터·응답 구조 검증

  • 일반 발송 (text 직접 설정 방식) — 단, 실제 발송이 아닌 시뮬레이션으로 동작하며, 리포트는 모두 성공으로만 반환됩니다.

샌드박스에서 이용이 어려운 기능

샌드박스는 카카오 테스트(CBT) 연동 환경이라, 운영 환경에 등록된 발신프로필키(senderKey)·템플릿을 참조하지 않습니다. 따라서 등록된 발신프로필키·템플릿을 조회하거나 참조해야 하는 기능은 아래와 같이 정상 동작하지 않습니다.

  • 텍스트 치환 발송 (sendType: template + replaceWords) → A505

  • 특정 발신프로필키·템플릿 기준 템플릿 조회 → A502

  • 그 외 운영에 등록된 발신프로필/템플릿 정보를 참조하는 관리성 요청

헷갈리는 항목이 있으시면 편하게 문의 주세요. 감사합니다!

5

답변 감사드립니다! 추가로 질문드릴 게 있습니다

운영 환경에 api로 알림톡 fallback 기능을 테스트하고 있습니다.

  1. messageFlow에 메시지 타입을 sms로 설정하는 경우 sms 제한 글자수가 넘어가면 A328 Length of text exceeded가 떨어지는 것 같은데 맞나요? 제한 글자수가 어떻게 되나요? 넘어가는 경우 mms로 설정하면 되겠죠?
  2. 발신번호 관리 메뉴에서 ‘비즈플러스 번호 불러오기’ 기능으로 기존 사용하던 발신 번호들을 땡겨왔는데요. 해당 발신 번호로 fallback의 from을 설정하면 A327 Not Allowed from 오류가 발생합니다 ㅜ 팀스페이스에 연결이 잘 안된 거 같은데 따로 제가 연결하는 기능은 없는 거 같아서 확인 요청드립니다
6

두 가지 문의 모두 안내드립니다.

1. SMS 글자수 제한과 A328

네, 맞습니다. SMS는 90바이트를 기준으로 하며, 초과 시 A328 Length of text exceeded가 발생합니다. 넘어가시는 경우 MMS 로 설정 부탁드립니다.

  • 영문·숫자: 최대 90자

  • 한글: 한 글자당 2바이트로 계산되어 약 45자

  • 이모지·일부 특수문자(…, — 등)는 3바이트 이상을 차지해 더 적게 들어갑니다.

2. A327 Not Allowed from (발신번호)

A327은 요청하신 from 발신번호가 발송 가능한 상태로 확인되지 않을 때 발생하는 오류입니다. 확인 결과, 현재 테스트 중이신 샌드박스 환경에서 발신번호 정보가 아직 동기화되지 않아 발생하는 것으로 보입니다.

이 경우, 저희 쪽에서 발신번호 확인 절차를 별도로 비활성화 처리해 드리면 정상적으로 테스트가 가능합니다.
번거로우시겠지만, 사용 중이신 로그인 계정 정보를 제 커뮤니티 프로필로 1:1 메시지나 영업담당자 분을 통해 주시면, 확인 후 발신번호 체크 부분을 비활성화 처리해 드리겠습니다.
처리 완료되면 다시 안내드리겠습니다.

추가로 궁금하신 점 있으시면 언제든 편하게 문의해 주세요. 감사합니다 :folded_hands: