카카오 또는 공동체 서비스용 메시지 템플릿 기능을 안내합니다. 공통 설명은 오픈 문서를 참고합니다.
메시지 템플릿 도구로 구성할 수 있는 메시지 템플릿은 아래와 같이 구분됩니다.
| 메시지 발송 API | 주요 특징 | 이용 방법 |
|---|---|---|
| 카카오톡 공유 API, 카카오톡 메시지 API | 개인 간 메시지 전송 그룹 채팅방 메시지 전송 앱 가입자/미가입자 대상 메시지 전송 가능 | [메시지 템플릿 추가] > [메시지 발송 API]에서 [카카오톡 공유 / 카카오톡 메시지] 선택 (참고: 카카오톡 공유 / 카카오톡 메시지 설정) |
| 카카오톡 채널 메시지 API | 채널 구독자 대상 메시지 전송 광고성/정보성 메시지 구분 가능 | [메시지 템플릿 추가] > [메시지 발송 API]에서 [카카오톡 채널 메시지] 선택 (참고: 카카오톡 채널 메시지 설정) |
메시지 템플릿 도구에서 이용 가능한 템플릿 종류는 아래와 같습니다. 각 템플릿 종류 대한 자세한 설명은 템플릿 종류에서 확인할 수 있습니다.
| 템플릿 종류 | 피드 | 리스트 | 커머스 | 와이드 피드 | 와이드 리스트 |
|---|---|---|---|---|---|
| 카카오톡 공유 / 카카오톡 메시지 | O | O | O | X | X |
| 카카오톡 채널 메시지 | O | O | O | O | O |
카카오톡 공유나 카카오톡 메시지의 템플릿 구성 시, [도구] > [메시지 템플릿] > [공통 설정]에서 설정할 수 있는 기능입니다.
사용할 API나 앱 타입, 앱에 부여 받은 권한에 따라 이용 가능한 설정이 다르니, 아래 표의 사용 조건을 참고합니다.
일부 설정은 권한이 필요합니다. 권한 필요시, [서비스] API플랫폼 아지트로 요청합니다.
| 항목 | 설명 | 사용 조건 |
|---|---|---|
| 사용 목적 | 메시지 발송 대상 선택, 서비스 앱 가입 여부에 따라 발송 가능 (참고: 사용 목적) | 인하우스 앱, 공동체 앱 기본 제공 |
| 메시지 수신 설정 허용 | 사용자가 메시지를 수신 거부할 수 있도록 메시지 우측 하단에 [설정] 옵션 제공 (참고: 프로필 공개 설정) | 인하우스 앱, 공동체 앱 기본 제공 |
| 전달 허용 | 메시지를 다른 카카오톡 친구나 채팅방에게 전달하는 아이콘 추가 여부 수신자에게만 노출되며, 발신자에게는 보이지 않음 | FORWARDABLE_SUPPORTED 권한이 있는 앱인하우스 앱 기본 제공 권한이 있어도 일부 템플릿은 미지원 |
| 네이티브 앱 스킴 | 메시지의 앱 링크 연결을 허용할 네이티브 앱 스킴 지정 (초기 값: 기본 네이티브 앱 스킴) 중요: 네이티브 앱 스킴 선택 시 주의 사항 | 인하우스 앱, 공동체 앱 기본 제공 |
| 카카오 인증마크 | 카카오가 인증한 메시지라는 인증마크 부착 여부 | KAKAO_VERIFIED_SUPPORTED 권한이 있는 앱 말풍선 공장과 협의 필요 |
| 서비스 이름 | 메시지 말풍선 하단 출처에 표시되는 앱 이름을 직접 정의 (참고: 앱 기본 정보) | CUSTOM_APP_NAME 권한이 있는 앱 |
| 서비스 아이콘 | 메시지 말풍선 하단 출처에 표시되는 앱 이름을 직접 정의 기본 설정: 카카오디벨로퍼스 아이콘 (참고: 앱 기본 정보) | CUSTOM_APP_ICON 권한이 있는 앱 |
| 문서 아이디 | 특정 문서를 지칭하는 값으로 카카오톡 공유의 공유 콘텐츠 통계 산출 용도로 사용 직접한 값을 ${REGI_DID} 형식의 사용자 인자로 전달URL 값을 사용할 것을 권장하며, URL이 없다면 서비스내에서 자체적으로 고유한 ID로 정의 말풍선 별로 아이디를 다르게 사용하거나, 사용자 인자를 사용할 수 있음 | DID_SUPPORTED 권한이 있는 앱 인하우스 앱 기본 제공 |
인하우스 앱과 공동체 앱은 카카오톡 공유 / 카카오톡 메시지 템플릿 선택 시, [사용 목적]을 설정할 수 있습니다.
선택한 사용 목적에 따라 프로필 공개 설정이 다르게 동작합니다. 앱에 가입하지 않은 사용자에게는 설정을 변경하라는 안내 메시지가 표시되며, 앱에 가입된 사용자에게는 프로필 공개 여부 설정 화면이 출력됩니다.
- 가입자에게만 전송: 카카오톡 메시지 API로 앱과 연결된 사용자에게만 전송시 선택
- 미가입자에게만 전송: 카카오톡 메시지 API로 앱과 연결되지 않은 사용자에게만 전송 시 선택
- 가입여부 무관: 카카오톡 공유 API나 그룹 채팅방으로 메시지 전송 시 사용
- 주의: 그룹방에서는 수신거부 설정이 노출되지 않으므로 사용자에게 과도한 메시지를 발송하지 않도록 유의
인하우스 앱과 공동체 앱에서 추가로 설정할 수 있는 옵션은 아래와 같습니다. 일반 앱과 동일한 설정은 사용자 정의 템플릿을 참고합니다.
| 항목 | 설명 | 사용 조건 | 사용 가능한 컴포넌트 |
|---|---|---|---|
| 이미지 URL | 이미지 업로드 시, 이미지 URL이 표시됨 KAGE 서버(Server)에 업로드된 이미지 URL이 아닌 URL 입력 가능 | NONE_KAGE_IMAGE_SUPPORTED 권한이 있는 앱 인하우스 앱 기본 제공 | 이미지, 프로필, 이미지 아이템, 아이템 리스트 |
| 길이 제한 해제 | 메시지의 텍스트 영역에 길이 제한을 해제하기 위한 설정 최대 글자 입력 제한(최대 200 글자) 없이 입력 가능 미선택 시, 최대 200자까지 입력 가능, 제목과 설명 각각 2줄씩만 노출되며 이후 텍스트는 말줄임표(...)로 생략 | FREE_TEXT_SUPPORTED 권한이 있는 앱말풍선 시안을 첨부해 카카오톡팀과 권한 제공에 대한 협의 필요 인하우스 앱 기본 제공 | 메시지 제목/본문 |
| 버튼 개수 | 기본적으로 제공되는 버튼은 최대 2개까지이나, 최대 5개까지 버튼 추가 가능 | MULTI_BUTTON_SUPPORTED 권한이 있는 앱 인하우스 앱 기본 제공 | 버튼 |
| Windows 앱, MacOS 앱 | 링크 설정 시, Windows와 Mac OS용 링크를 개별로 설정 가능 | 인하우스 앱, 공동체 앱 기본 제공 | 컴포넌트 링크 관리 |
| Android 스킴, iOS 스킴 | 일반 앱에서는 기본 앱 실행 커스텀 URL 스킴만 사용 가능하나, 지원하지 않는 스킴도 직접 입력 가능 | CUSTOM_EXECUTE_URL 권한이 있는 앱 인하우스 앱 기본 제공 | 컴포넌트 링크 관리 |
| Android 스토어 iOS 스토어 | 메시지에서 앱 실행 시, 앱이 설치돼 있지 않은 경우, 앱 설치 스토어 링크 기본값이 아니라 직접 입력 가능 | CUSTOM_MARKET_URL 권한이 있는 앱 인하우스 앱 기본 제공 | 컴포넌트 링크 관리 |
| 모바일 웹, PC 웹 | 앱 관리 페이지의 [앱] > [제품 링크 관리] > [웹 도메인]에 등록된 도메인과 일치하지 않는 도메인의 URL 입력 가능 | DOMAIN_CHECK_PASS 권한이 있는 앱 | 컴포넌트 링크 관리 |
| 모바일 웹, PC 웹 | 앱 관리 페이지의 [앱] > [제품 링크 관리] > [웹 도메인]에 등록된 도메인과 일치하지 않는 URL 입력 가능, 단 도메인은 같아야 함 | SUBDOMAIN_SUPPORTED 권한이 있는 앱 | 컴포넌트 링크 관리 |
| 카카오톡 세션 전달 | 메시지의 링크에 사용자의 로그인 세션을 함께 전달 가능 모바일에서는 카카오톡 앱의 로그인 세션을 사용해 로그인 없이 Mobile Web에 설정된 링크로 이동 데스크톱에서는 브라우저에 저장된 카카오계정 로그인 정보를 사용해 Web에 설정된 링크로 이동 | AUTH_SUPPORTED 권한이 있는 앱 | 컴포넌트 링크 관리 |
| External Web | 메시지 링크 랜딩 URL을 외부 브라우저로 설정 가능 | 카카오톡링크 LEW 사용 권한 권한이 있는 앱 | 컴포넌트 링크 관리 |
| 액션 타입 | 외부 브라우저로 링크를 열 수 있도록 설정 가능 [inweb]: 인앱 브라우저 (기본값) [web]: 인앱이 아닌 외부 브라우저 [dialog]: 다이어로그 창 표시, DIALOG_SUPPORTED 추가 권한이 있어야 사용 가능 [page]: PAGE_SUPPORTED 추가 권한이 있어야 사용 가능 | WEB_ACTION_TYPE_SUPPORTED 권한이 있는 앱 | 컴포넌트 링크 관리 |
| 다이얼로그 메시지 | 링크 선택 시 사용자에게 보여줄 메시지 입력 가능 다이얼로그 창을 보여주지만 확인 시 링크 이동하지 않음 | WEB_ACTION_TYPE_SUPPORTED 권한이 있는 앱 | 컴포넌트 링크 관리 |
메시지 템플릿에 따라 설정 가능한 구성 요소가 다릅니다. 아래 표는 권한을 부여받지 않은 앱에서 템플릿 종류별로 설정 가능한 설정을 안내합니다.
기본적으로 제공하는 위 설정 항목 외에 권한 부여 시 사용할 수 있는 기능은 공통 설정을 참고합니다.
일반 앱과 동일한 설정 항목을 이용할 수 있습니다. 템플릿 종류별 구성 요소 지원 여부를 참고합니다.
메시지 템플릿 도구를 활용해 카카오톡 채널 메시지를 구성하는 방법을 설명합니다. 채널 메시지는 인하우스 앱만 이용할 수 있습니다.
자세한 사용 방법은 채널 메시지 템플릿을 참고합니다. 구성한 채널 메시지는 채널 메시지 발송기나 사용자 정의 템플릿으로 메시지 발송 API로 보낼 수 있습니다.
카카오톡 채널 메시지의 템플릿 구성 시, [도구] > [메시지 템플릿] > [공통 설정]에서 설정할 수 있는 기능입니다.
사용할 API나 앱 타입, 앱에 부여 받은 권한에 따라 이용 가능한 설정이 다르니, 아래 표의 사용 조건을 참고합니다.
| 항목 | 설명 | 사용 조건 |
|---|---|---|
| 광고 메시지 여부 | 메시지가 정보성인지 광고성인지 선택 광고 메시지 선택 시, 일부 설정 이용 불가 (참고: 메시지 유형) | 광고성 메시지를 구성하려면 심사 완료 필요 |
| 채널 차단 무시 | 채널을 차단한 사용자에게도 메시지를 발송할 때 사용 중요: 해당 옵션을 활성화하면 사용자가 채널을 차단해도 메시지가 발송되므로 반드시 필요한 경우에만 사용 권장 | 인하우스 앱 기본 제공 |
| 사내 유저 필터링 | 사내 사용자에게만 메시지를 발송할 때 사용 | 인하우스 앱 기본 제공 |
| 푸시알림 텍스트 | 푸시알림과 채팅방 목록에 보이는 미리보기 메시지 설정 자동 생성: 설정한 메시지 제목과 메시지 본문에 따라 자동 생성됨 (참고: 라스트 메시지 정책) 직접 입력: 서비스에서 직접 입력 가능 | 인하우스 앱 기본 제공 |
| 강제 모바일 푸시알림 | PC 버전 카카오톡이 켜져있어도 모바일 푸시 알림을 발송할 때 사용 | 인하우스 앱 기본 제공 |
| 네이티브 앱 스킴 | 메시지의 앱 링크 연결을 허용할 네이티브 앱 스킴 지정 (초기 값: 기본 네이티브 앱 스킴) 중요: 네이티브 앱 스킴 선택 시 주의 사항 | 인하우스 앱, 공동체 앱 기본 제공 |
| 메시지 보안 | OTP 인증 메시지를 위한 설정 본인인증 시 사용된 주 기기에서만 확인 가능, 보조 기기에는 '모바일에서 확인하세요'라는 문구 노출 | 인하우스 앱 기본 제공 피드 타입에서만 사용 가능 |
| 보조 디바이스 본문 노출 | 본인인증에 사용되지 않은 기기에서 메시지의 본문을 표시할 지 여부 | MSG_PC_SUPPORTED 권한이 있는 앱 |
| 전달 허용 | 메시지를 다른 카카오톡 친구나 채팅방에게 전달하는 아이콘 추가 여부 수신자에게만 노출되며, 발신자에게는 보이지 않음 | FORWARDABLE_SUPPORTED 권한이 있는 앱인하우스 앱 기본 제공 권한이 있어도 일부 템플릿은 미지원 |
| 카카오 인증마크 | 카카오가 인증한 메시지라는 인증마크 부착 여부 | KAKAO_VERIFIED_SUPPORTED 권한이 있는 앱 말풍선 공장과 협의 필요 |
| 문서 아이디 | 특정 문서를 지칭하는 값으로 카카오톡 공유의 공유 콘텐츠 통계 산출 용도로 사용 직접한 값을 ${REGI_DID} 형식의 사용자 인자로 전달URL 값을 사용할 것을 권장하며, URL이 없다면 서비스내에서 자체적으로 고유한 ID로 정의 말풍선 별로 아이디를 다르게 사용하거나, 사용자 인자를 사용할 수 있음 | DID_SUPPORTED 권한이 있는 앱인하우스 앱 기본 제공 |
| Android 버전 | Android의 최소 버전을 명시할 수 있는 설정 | KAKAO_TALK_VERSION_SUPPORTED 권한이 있는 앱 |
| iOS 버전 | iOS의 최소 버전을 명시할 수 있는 설정 | KAKAO_TALK_VERSION_SUPPORTED 권한이 있는 앱 |
| Windows 버전 | Windows의 최소 버전을 명시할 수 있는 설정 | KAKAO_TALK_VERSION_SUPPORTED 권한이 있는 앱 |
| Mac 버전 | Mac의 최소 버전을 명시할 수 있는 설정 | KAKAO_TALK_VERSION_SUPPORTED 권한이 있는 앱 |
카카오톡 공유 / 카카오톡 메시지의 템플릿과 동일합니다.
| 템플릿 종류 | 피드 A | 피드 B | 리스트 | 커머스 | 와이드 피드 | 와이드 리스트 |
|---|---|---|---|---|---|---|
| 광고 메시지 여부 | O | O | O | O | O | O |
| 채널 차단 무시 | O* | O* | O* | O* | O* | O* |
| 사내 유저 필터링 | O | O | O | O | O | O |
| 푸시알림 텍스트 | O | O | O | O | O | O |
| 강제 모바일 푸시알림 | O* | O* | O* | O* | O* | O* |
| 메시지 보안 | O* | O* | X | X | X | X |
| 전달 허용 | O | O | O | O | X | X |
기본적으로 제공하는 위 설정 항목 외에 권한 부여 시 사용할 수 있는 기능은 공통 설정을 참고합니다.
메시지 템플릿에 따라 설정 가능한 구성 요소가 다릅니다. 아래 표는 권한을 부여받지 않은 앱에서 메시지 타입별로 설정 가능한 설정을 안내합니다.
| 템플릿 종류 | 피드 A | 피드 B | 리스트 | 커머스 | 와이드 피드 | 와이드 리스트 |
|---|---|---|---|---|---|---|
| 이미지 | O | O | O | X | O | X |
| 프로필 | O | O | O | X | X | X |
| 헤더 | O | O | O | O | X | O |
| 이미지 아이템 | O | O | O | X | X | X |
| 텍스트 아이템 리스트 | O | O | O | X | X | X |
| 메시지 제목/본문 | O | O | O | X | O | X |
| 소셜 | O | O | O | X | X | X |
| 아이템 리스트 | X | X | X | O | X | O |
| 상품 | X | X | X | X | X | X |
| 상품 설명 | X | X | X | X | X | X |
| 버튼 | O | O | O | O | O | O |
| 공통 링크 | O | O | O | O | O | O |