안녕하세요. (앱 ID 12043)
개인화 메시지 발송용 이미지 URL 형식 및 활용 가능 범위에 대해 문의드립니다.
인사이더에서 고객 행동 데이터를 활용해 발송 대상을 구성하고, API를 통해 고객별 데이터 및 이미지 URL을 연동한 뒤, 샌디 발송 솔루션에서 카카오톡 개인화 메시지를 발송하고자 합니다.
확인 요청 사항은 아래와 같습니다.
-
개인화 메시지 발송 시 mud-kage.kakao.com 형태의 이미지 URL만 사용 가능한지
-
다른 형태의 이미지 URL도 사용 가능하다면, 활용 가능한 URL 형식 또는 예시 안내 가능 여부
-
mud-kage.kakao.com 형태의 URL이 필수인 경우, 해당 URL의 발급 또는 확인 가능 경로
예시: API, 관리자센터, 카카오모먼트 내 확인 가능 여부 등
예시 URL:
https://mud-kage.kakao.com/dn/bC7rye/btsi2RjtLLg/xztSwX7cisBhH4GnDf0PQk/img_l.jpg
확인 부탁드립니다.
감사합니다.
안녕하세요. 문의하신 개인화 메시지 발송용 이미지 URL 기준 안내드립니다.
개인화 메시지 발송 시 사용 가능한 이미지 URL은 도메인 형식 자체가 기준이 아니라, 카카오모먼트 개인화 메시지 이미지 업로드 API를 통해 업로드한 뒤 응답으로 받은 URL인지 여부가 기준입니다.
업로드 API로 등록한 이미지는 카카오 CDN에 저장되므로 결과적으로 mud-kage.kakao.com 형태의 URL로 제공됩니다. 다만 mud-kage.kakao.com 형태의 URL이라도, 해당 광고계정에서 업로드 API를 통해 발급받은 URL이 아니면 사용할 수 없습니다.
따라서 인사이더 또는 자체 CDN 등 외부 이미지 URL은 직접 사용할 수 없으며, 외부 이미지를 사용하려면 아래와 같은 흐름으로 연동해 주셔야 합니다.
- 외부 이미지 URL의 이미지를 다운로드
- 카카오모먼트 개인화 메시지 이미지 업로드 API로 업로드
- 응답으로 받은
downloadUrl을 발송 변수(image_url1 ~ image_url7)에 매핑하여 사용
이미지 URL은 https://, http://, // 형태 모두 사용할 수 있으나, 호스트와 경로는 업로드 API 응답값과 동일해야 합니다. 예를 들어 경로 내 사이즈 값 등을 임의로 변경한 URL은 사용할 수 없습니다.
이미지 URL 발급은 Open API를 통해서만 가능하며, 관리자센터 또는 카카오모먼트 화면에서는 별도 발급/조회 기능을 제공하지 않습니다.
POST https://apis.moment.kakao.com/openapi/v4/messages/personal/images/upload
- Header:
adAccountId: {광고계정ID}
- Body:
multipart/form-data
- Parameter:
files
- 1회 최대 100개 업로드 가능
응답 예시는 아래와 같습니다.
{
"successFiles": [
{
"downloadUrl": "//mud-kage.kakao.com/dn/.../img_l.jpg", "originalFileName": "..."
}
],
"invalidFiles": []
}
응답으로 받은 downloadUrl이 발송 시 사용할 수 있는 이미지 URL이므로,
응답 수신 시점에 별도로 저장 및 관리해 주시기 바랍니다. 현재 업로드된 이미지 URL을 별도로 조회하는 API는 제공되지 않습니다.
또한 이미지를 업로드한 광고계정과 실제 메시지를 발송하는 광고계정은 동일해야 합니다.
관련 공식 문서는 아래에서 확인하실 수 있습니다.
https://developers.kakao.com/docs/ko/kakaomoment/personalized-msg#upload-image
참고로 모든 수신자에게 동일한 이미지를 발송하는 경우라면, 이미지 URL 변수 방식 대신 소재 생성 시 고정 이미지를 직접 첨부하는 방식도 사용할 수 있습니다.
추가로 더 궁금하신 점 있다면 문의 부탁드립니다.
감사합니다.
