이 문서는 카카오톡 채널 메시지에 대해 자주 묻는 질문과 답변을 제공합니다.

카카오 API 사용에 필요한 설정, 도구, 문서를 제공하는 개발자 웹사이트입니다. 카카오디벨로퍼스를 참고합니다.

알파(Alpha), 샌드박스(Sandbox), 베타(Beta), 릴리즈(Release)를 지원합니다. 페이즈를 참고합니다.

네. 카카오디벨로퍼스에서 사용할 카카오계정은 사내 계정의 이메일 주소로 가입해야 합니다. 앱 기본 정보에서 회사명을 입력하고, 앱 타입 설정 시, 앱 소유자(Owner)의 카카오계정 이메일 주소를 확인합니다. 개발자 계정 등록을 참고합니다.

앱은 사용자가 카카오 API를 적용할 서비스의 구성 요소(웹사이트, 프로그램, 모바일 앱 등)를 의미합니다. 앱이 제공하는 기능은 앱을 참고합니다.

네. 카카오디벨로퍼스에 앱을 등록해야 채널 메시지를 비롯한 카카오 API를 사용할 수 있습니다. 채널 메시지 관련 기능은 권한을 보유한 앱으로만 사용할 수 있습니다. 사용 방법을 참고합니다.

아니요. 카카오디벨로퍼스 앱은 페이즈별로 등록해야 합니다. 앱 생성을 참고합니다.

네. 앱에 등록된 채널로만 채널 메시지 발송이 가능합니다. 카카오톡 채널 > FAQ를 참고합니다.

네. 앱에 여러 개의 채널을 등록하고, 채널 메시지 발송 시 어느 채널로 발송할 것인지 선택할 수 있습니다. 사용 권한 신청 시 이용할 채널 목록을 전달합니다.

네. 채널 메시지 API는 위임 방식을 지원합니다. 예를 들어, 비즈 알림 시스템에서 카카오모먼트, 카카오 키워드광고 등 서비스의 채널 메시지를 대신 발송합니다. 위임 방식 사용 시, 플랫폼과 서비스 모두 각각 앱, 채널 메시지 사용 권한을 보유해야 합니다. 채널 메시지를 발송할 채널은 서비스의 앱에 등록되어 있어야 합니다. 위임 방식: 플랫폼 앱을 참고합니다.

네. [버튼] > [링크 설정]에서 서비스 페이지 바로가기를 걸 수 있습니다. [DOMAIN]에 서비스 도메인, [PATH]에 원하는 페이지 경로를 입력합니다. 컴포넌트 링크 관리를 참고합니다.

네. [버튼] > [링크 설정]에서 서비스 앱의 커스텀 URL 스킴을 설정할 수 있습니다. 예를 들어, kakaotalk://settings/laboratory와 같은 커스텀 URL 스킴 설정이 가능합니다. 커스텀 URL 스킴을 설정하려면 [앱] > [제품 링크 관리]에 Android, iOS 앱 정보가 설정되어 있어야 합니다. 제품 링크 관리, 커스텀 URL 스킴을 참고합니다.

네. 단, 전화번호로 채널 메시지를 발송하려면 별도 권한이 필요합니다. [서비스] API플랫폼 아지트에서 요청합니다. 정책적으로 전화번호를 사용한 채널 메시지 발송을 지양하고 있으므로, 불가피한 경우에만 권한을 신청해야 합니다.

1. 말풍선 공장 아지트에서 말풍선 로그 조회 권한 신청
2. Turnilo 접속
3. 필터 설정으로 앱별, 메시지 템플릿별 지표 확인
   • Service2: 앱 ID(예: 977071)
   • Extra 1: 메시지 템플릿 ID(예: 101991), 채널 메시지 발송기 사용 시 메시지 템플릿 ID와 task_id 조합으로도 조회 가능(예: 101991_510), task_id는 [보낸 메시지] > [결과 다운로드]에서 제공하는 csv 파일로 확인 가능

카카오 API 플랫폼의 Kibana에서 확인 가능합니다. 조회 가능 기간은 최대 2주입니다. 아래 바로가기로 접속할 수 있습니다.

• 샌드박스 페이즈
• 릴리즈 페이즈

특정 앱의 로그만 확인하려면 [+Add filter]로 record.appId 필드 추가 후 앱 ID를 지정합니다.

[서비스] API플랫폼 아지트에서 신청합니다. 채널 메시지 사용 권한은 인하우스 앱만 신청 가능합니다. 사용 방법을 참고합니다.

아니요. 앱에 채널 메시지 사용 권한을 받으면 채널 메시지 발송기, 채널 메시지 API 모두 사용 가능합니다.

아니요. 채널 메시지는 카카오(CIC 포함)가 소유한 서비스만 이용할 수 있습니다. 공동체 및 계열사의 서비스는 채널 메시지를 이용할 수 없습니다. 공동체 및 계약사 소유의 서비스를 카카오에서 운영하는 경우에도 채널 메시지를 이용할 수 없습니다.

네. 카카오 서비스지만 공동체나 계열사 등 타사가 개발 및 운영하는 경우에도 채널 메시지를 이용할 수 있습니다. 단, 사용 목적에 따라 채널 메시지 이용이 불가능할 수 있습니다. 예를 들어, 서비스 운영 외의 목적으로는 채널 메시지를 이용할 수 없습니다.

네. 단, 정보성 메시지에 한해 카카오 인증 마크를 사용할 수 있습니다. 메시지 템플릿을 참고합니다.

아니요. 광고성 메시지는 카카오 인증 마크를 사용할 수 없습니다. 메시지 템플릿을 참고합니다.

아니요. 정보성 메시지는 광고 성격의 내용을 포함해서는 안 됩니다. 서비스 홍보나 프로모션 등 광고 성격의 내용을 일부라도 포함할 경우, 광고성 메시지로 간주되며 법적 문제가 발생할 수 있습니다. 판단이 어려울 경우, [법무팀] 법률자문 아지트로 검토 요청합니다. 메시지 유형을 참고합니다.

[도구] > [메시지 템플릿]에서 등록합니다. 채널 메시지용 메시지 템플릿은 [메시지 타입]을 [채널로 보내기(채널 메시지)]로 설정해야 합니다. [채널로 보내기(채널 메시지)]는 인하우스 앱만 설정 가능합니다. 메시지 템플릿을 참고합니다.

메시지 템플릿은 카카오디벨로퍼스 앱에 등록됩니다. 등록한 메시지 템플릿은 앱 관리 페이지의 [앱] > [웹훅] > [카카오톡 메시지] > [메시지 템플릿] 또는 [도구] > [메시지 템플릿]에서 확인할 수 있습니다.

아니요. 앱의 채널과 메시지 템플릿 설정은 별개입니다. 앱에 등록된 채널이 변경되어도, 기존에 등록한 메시지 템플릿을 사용할 수 있습니다.

사용하려는 메시지 템플릿이 [도구] > [메시지 템플릿]에서 [카카오톡 채널 메시지] 하위에 등록되어 있는지 확인합니다. 메시지 템플릿을 참고합니다.

아니요. 카카오톡 공유, 카카오톡 메시지에 사용하던 메시지 템플릿은 채널 메시지용으로 사용할 수 없습니다. 채널 메시지용 메시지 템플릿을 새로 등록해야 합니다. 메시지 템플릿을 참고합니다.

인하우스 앱의 메시지 템플릿은 자동으로 심사 완료 처리되어, 별도 심사 과정 없이 사용 가능합니다.

원하는 형태와 가장 가까운 템플릿 양식을 선택한 후, 필요하지 않은 구성 요소를 삭제할 수 있습니다. 미리보기에서 필요하지 않은 구성 요소를 클릭해 [ON] 또는 [OFF]로 사용 여부를 설정할 수 있습니다. 단, 일부 템플릿 양식은 필수 구성 요소가 정해져 있고, 필수 구성 요소는 사용 여부 설정이 불가능합니다. 각 구성 요소 설명은 메시지 템플릿을 참고합니다.

1. 템플릿 양식을 [FEED]로 선택합니다.
2. 불필요한 구성 요소인 [이미지], [버튼], [프로필], [소셜]을 모두 [OFF]로 설정합니다.
3. [제목/설명]에서 [제목] 또는 [설명]에 텍스트를 입력합니다.

• [제목/설명] > [길이 제한 해제]를 [사용함(true)]으로 설정한 경우
  • [제목]과 [설명] 모두 사용 시 각각 최대 500자 입력 가능, 실제 말풍선에는 각각 최대 50줄씩 노출
  • [제목] 또는 [설명] 중 한 가지만 사용 시 최대 1,000자 입력 가능, 실제 말풍선에는 최대 100줄까지 노출
• [제목/설명] > [길이 제한 해제]를 [사용 안 함(false)]으로 설정한 경우
  • 최대 200자 입력 가능, 실제 말풍선에는 [제목]과 [설명] 각각 2줄씩만 노출

• [제목]과 [설명]을 합해 최대 400자 이하 입력 권장, 실제 말풍선에는 최대 24줄까지 노출

• [제목]과 [설명]을 합해 최대 200자 이하 입력 권장, 실제 말풍선에는 최대 12줄까지 노출

[제목]과 [설명]에 2줄 이상의 텍스트를 노출하려면 [제목/설명] > [길이 제한 해제]를 [사용함(true)]으로 설정합니다.

네. 단, 채널 메시지 발송기 사용 시에는 실제 값이 텍스트 또는 URL인 사용자 인자만 사용 가능합니다. 사용자 인자를 참고합니다.

메시지 템플릿의 [컴포넌트 링크 설정]에는 앱에 등록된 도메인만 입력할 수 있습니다. 앱에 등록된 도메인은 앱 관리 페이지의 [앱] > [제품 링크 관리]에서 확인 가능합니다. 제품 링크 관리을 참고합니다.

[도구] > [채널 메시지 발송기]에서 이용할 수 있습니다. 채널 메시지 발송기를 참고합니다.

알파, 샌드박스, 베타, 릴리즈를 지원합니다. 페이즈를 참고합니다.

아니요. 메시지 내용은 직접 작성할 수 없습니다. [도구] > [메시지 템플릿]에 메시지 내용과 설정을 미리 등록해 놓아야 합니다. 채널 메시지 발송 시 어느 메시지 템플릿을 발송할 것인지 선택할 수 있습니다.

알파, 샌드박스, 베타, 릴리즈를 지원합니다. 호스트별 페이즈를 참고합니다.

카카오 API의 종류, 발송 방식을 참고합니다.

• channel_talk_id
  • 카카오톡 채널의 카카오톡 회원번호
  • 숫자 형식
  • 카카오톡 채널 어드민에서 확인 가능
• channel_public_id
  • 카카오톡 채널 프로필 ID
  • channel_talk_id를 인코딩한 값으로 문자열 형식
  • 카카오톡 채널 파트너센터에서 확인 가능

카카오톡 채널 프로필 ID 확인 방법을 참고합니다.

요청 파라미터 중 receiver_id_type을 phone_number로 지정하고, receiver_ids로 "821012345678" 형식의 전화번호 배열을 전달합니다. 사용자 정의 템플릿으로 메시지 발송을 참고합니다.

[도구] > [채널 메시지 발송기]에서 테스트 발송이 가능합니다. 채널 메시지 사용 권한이 없어도 테스트 발송이 가능합니다. 테스트 발송을 참고합니다.

카카오디벨로퍼스에 로그인된 카카오계정의 전화번호입니다. 테스트 발송을 참고합니다.

네. 알파 또는 샌드박스 페이즈의 사용자 대상으로 채널 메시지를 발송할 수 있습니다.

아래 표의 발송 페이즈별 수신 카카오톡 버전에서 확인합니다.