KakaoTalk 채널 푸시
이 문서에서는 AE에서 Infobip을 연결하고 KakaoTalk Brand Message 채널을 생성한 다음, 테스트 발송, 정식 푸시, 결과 확인을 진행하는 방법을 설명합니다.
발송 시간대: KakaoTalk 메시지는 베이징 시간 07:00(포함)부터 19:00(미포함)까지만 발송되며, 이는 한국 시간 08:00(포함)부터 20:00(미포함)에 해당합니다. 작업 트리거 시간을 이 시간대 안으로 설정하십시오.
1. 기능 개요
KakaoTalk 채널은 Infobip을 통해 마케팅 수신 동의 조건을 충족하는 한국 유저에게 Brand Message를 발송합니다. 전체 절차는 Infobip 권한 부여 설정, 채널 생성 및 활성화, 대상 범위 선택, 메시지 편집 및 테스트, 정식 푸시, 전달 및 클릭 결과 확인으로 구성됩니다.
채널은 메시지 미리보기, 테스트 발송, 시스템 도달 퍼널을 지원합니다. 도달 퍼널을 활성화하면 시스템이 예약 푸시, 실제 푸시, 푸시 성공, 실제 도달, 푸시 클릭의 다섯 단계를 자동으로 기록하므로 도달 이벤트를 직접 만들 필요가 없습니다.
2. 연동 전 준비
설정을 시작하기 전에 Infobip 측과 AE 유저 데이터가 준비되었는지 확인하고, 현재 계정에 운영 채널을 조회하고 편집할 수 있는 권한이 있는지 확인하십시오.
| 준비 항목 | 요구 사항 |
|---|---|
| Infobip 계정 | 계정에서 KakaoTalk Brand Message 기능이 활성화되어 있고 발송 권한이 있어야 합니다. |
| 연결 정보 | 유효한 HTTPS API Base URL과 API Key를 준비합니다. API Key는 민감한 자격 증명이므로 앱 권한 부여 팝업에서만 입력합니다. |
| KakaoTalk Sender | Sender가 Infobip에 설정되어 있고 Brand Message에 사용할 수 있어야 합니다. 채널을 생성할 때 이 Sender를 입력해야 합니다. |
| 휴대폰 번호 속성 | AE에 한국 휴대폰 번호를 저장하는 유저 속성이 있어야 하며, 속성 타입은 문자열 또는 숫자입니다. 실제 발송 번호는 +82 뒤에 10자리 번호가 붙은 형식이어야 합니다. 예: +821012345678. |
| 마케팅 수신 동의 | 수신자가 비즈니스에 필요한 마케팅 동의 조건을 충족해야 하며, 채널 친구, 비채널 친구 또는 마케팅 수신에 동의한 모든 사용자 중에서 선택할 수 있습니다. |
Kakao 및 Infobip 측 확인: Brand Message 발송에 사용하는 KakaoTalk 계정은 Business Channel 인증을 완료해야 합니다. 채널 이름, 프로필 이미지 등의 정보는 제출한 기업 정보와 일치해야 하며, KakaoTalk Channel Manager에서 고객센터 연락처를 모두 입력해야 합니다. 또한 Infobip에 해당 채널과 Sender가 연결되어 있는지, API Key에 필요한 KakaoTalk API 권한이 포함되어 있고 만료되지 않았는지 확인해야 합니다. 실제 설정은 KakaoTalk 및 Infobip 콘솔을 기준으로 합니다.
Infobip 대시보드로 이동하여 다음 정보를 수집합니다.
API keys와 base URL
- Infobip 포털에서 Developer Tools > API keys를 선택합니다.
- API keys 페이지에서 API base URL을 복사합니다.
- Create API key를 선택합니다.
- 이름을 입력하고 만료 날짜를 선택한 다음, KakaoTalk에 필요한 API 권한 범위를 선택합니다. 이 권한 범위는 키로 실행할 수 있는 Infobip API 작업을 제어합니다.
- channel에서 KakaoTalk을 선택하고 Sender 신청을 클릭합니다.
3. Infobip 앱 권한 부여 설정
- 운영 > 운영 설정 > 채널 설정 > 서드파티 플랫폼으로 이동합니다.
- KakaoTalk - Brand Message를 펼치고 앱 권한 부여 영역에서 앱 추가를 클릭합니다.
- 인증 이름, API Base URL, API Key를 입력합니다.
- 연결 및 저장을 클릭합니다. 연결에 성공하면 이 권한 부여를 사용하여 KakaoTalk 채널을 생성할 수 있습니다.
- 아래 그림과 같이 앱 권한 부여 팝업에서 Infobip 연결 정보를 설정합니다.
| 필드 | 입력 설명 |
|---|---|
| 인증 이름 | 팀에서 식별하기 쉬운 이름을 입력하며, 비즈니스나 환경 정보를 포함하는 것을 권장합니다. |
| Provider | Infobip으로 고정되어 있으며 수정할 필요가 없습니다. |
| API Base URL | Infobip Portal의 Developer Tools > API Keys 페이지에서 API Base URL을 복사합니다. 전체 HTTPS 서비스 주소를 입력합니다. |
| API Key | Infobip Portal의 Developer Tools > API Keys 페이지에서 키를 생성하거나 복사합니다. 생성할 때 식별하기 쉬운 이름과 적절한 만료 시간을 설정하고, KakaoTalk에 필요한 API 권한을 부여합니다. 기존 권한 부여를 편집할 때 키를 바꾸지 않는다면 원래 키를 유지할 수 있습니다. |
- 저장할 때 시스템이 Infobip에 직접 연결하여 자격 증명을 검증합니다.
- API Key는 암호화되어 저장되며 이후 페이지에 다시 표시되지 않습니다. 기존 권한 부여를 편집할 때 비워 두면 원래 키를 계속 사용합니다.
- 인증 이름은 현재 프로젝트 내에서 중복될 수 없습니다.
- 연결에 실패하면 Base URL이 유효한 HTTPS 주소인지, API Key가 올바르고 만료되지 않았는지, 계정에 KakaoTalk 권한이 있는지, 현재 네트워크에서 Infobip에 접근할 수 있는지를 차례로 확인하십시오. 채널에서 참조 중인 권한 부여는 바로 삭제할 수 없으므로 먼저 연결된 채널을 처리해야 합니다.
4. KakaoTalk 채널 생성 및 활성화
- KakaoTalk - Brand Message 영역에서 채널 생성을 클릭합니다.
- 채널 이름을 입력하고, 연결이 정상인 인증 앱을 선택하고, KakaoTalk Sender를 입력한 다음 휴대폰 번호 속성을 선택합니다.
- 필요에 따라 도달 퍼널 설정을 활성화한 다음 채널 생성을 클릭합니다.
- 채널 목록으로 돌아가 해당 채널을 활성화합니다. 활성화할 때 시스템이 권한 부여, Sender, 휴대폰 번호 속성을 다시 검증합니다.
아래 그림과 같이 채널을 생성할 때 다음 항목을 설정해야 합니다.
| 필드 | 입력 설명 |
|---|---|
| 채널 이름 | 프로젝트 내에서 이 채널을 식별하는 이름입니다. |
| 인증 앱 선택 | 상태가 정상이고 연결에 성공한 Infobip 권한 부여만 선택합니다. |
| KakaoTalk Sender | Infobip Portal의 Channels and Numbers > Channels > Senders에서 활성화된 Sender를 확인하고 입력합니다. 같은 프로젝트에서 같은 권한 부여로 동일한 Sender를 중복 사용하여 여러 채널을 생성할 수 없습니다. |
| 휴대폰 번호 속성 | 한국 휴대폰 번호를 저장하는 문자열 또는 숫자형 유저 속성을 선택합니다. |
| 도달 퍼널 설정 | 활성화하면 시스템이 고정된 다섯 가지 도달 단계를 자동으로 기록합니다. 시스템 단계는 수정할 수 없습니다. |
활성화된 채널은 설정을 바로 수정할 수 없습니다. 권한 부여, Sender, 휴대폰 번호 속성 또는 도달 퍼널을 조정하려면 먼저 채널을 비활성화하고, 수정을 마친 후 다시 활성화하십시오.
5. 메시지 편집 및 테스트 발송
- 채널 목록의 작업 열에서 테스트 발송을 클릭합니다.
- 테스트 휴대폰 번호를 입력하고 대상 범위로 채널 친구, 비채널 친구, 마케팅 수신에 동의한 모든 사용자 중 하나를 선택합니다.
- 메시지 타입을 하나 선택하고 본문, 이미지, 버튼, 상품, 쿠폰, 동영상 등 페이지에서 요구하는 내용을 입력합니다.
- 오른쪽 메시지 미리보기에서 표시 효과를 확인하고, 문제가 없으면 발송 확인을 클릭합니다.
아래 그림과 같이 테스트 발송 페이지에는 대상 범위, 8가지 메시지 타입, 내용 편집 영역, 클라이언트 미리보기가 함께 표시됩니다.
대상 범위 설명
대상 범위는 필수 선택 항목으로, Kakao가 도달을 허용하는 유저 유형을 지정하는 데 사용합니다. AE의 타깃 그룹 필터를 대체하지 않으며, 수신자는 작업의 그룹 조건과 Kakao의 수신 동의 조건을 모두 충족해야 합니다.
| 대상 범위 | 도달 가능한 유저 | 선택 가이드 |
|---|---|---|
| 채널 친구 | 현재 KakaoTalk 채널을 친구로 추가했고 Kakao의 해당 동의 조건을 충족하는 유저. | 기본값. 채널을 이미 추가한 유저에게만 발송할 때 적합합니다. 이 범위에서는 채널 추가 버튼을 지원하지 않습니다. |
| 비채널 친구 | 현재 채널을 친구로 추가하지 않았지만 Kakao를 통해 마케팅 메시지 수신을 구독하거나 동의한 유저. | 아직 채널을 추가하지 않은 적법한 대상에게 도달할 때 적합합니다. 채널 추가 버튼으로 채널 추가를 유도할 수 있습니다. |
| 마케팅 수신에 동의한 모든 사용자 | 조건을 충족하는 채널 친구와 비채널 친구를 모두 포함하는, 해당 마케팅 동의를 갖춘 최대 도달 범위. | 규정을 준수하는 범위에서 도달 범위를 우선할 때 적합합니다. 채널 추가 버튼을 사용할 수 있습니다. |
Kakao는 메시지를 전달할 때 수신자가 선택한 범위에 해당하는지 검증하며, 조건에 맞지 않는 유저는 메시지를 받지 못합니다. 따라서 테스트와 정식 발송 모두 실제 마케팅 동의와 일치하는 범위를 선택해야 합니다.
| 메시지 타입 | 코드 | 주요 내용 제한 | 버튼 및 추가 규칙 |
|---|---|---|---|
| 텍스트형 | FT | 본문 필수, 최대 1300자, 줄바꿈 99회. | 버튼 최대 5개, 쿠폰 사용 시 최대 4개. 버튼 이름 최대 14자. |
| 이미지형 | FI | 이미지와 본문 필수. 본문 최대 1300자, 줄바꿈 99회. | 버튼 및 쿠폰 제한은 텍스트형과 같음. 이미지 링크는 HTTP/HTTPS 주소여야 함. |
| 와이드 이미지형 | FW | 이미지와 본문 필수. 본문 최대 76자, 줄바꿈 5회. | 버튼 최대 2개, 버튼 이름 최대 8자. 채널 추가 버튼은 마지막에 배치. |
| 와이드 리스트형 | FL | 제목 최대 20자, 줄바꿈 불가. 항목 3~4개 포함. | 버튼 최대 2개, 버튼 이름 최대 8자. 채널 추가 버튼은 마지막에 배치. |
| 캐러셀 피드형 | FC | 콘텐츠 카드 2~6개 포함. 각 카드에 이미지와 문구 설정 필요. | 카드당 버튼 1~2개. 전체 최대 쿠폰 1개, 채널 추가 버튼 1개. |
| 커머스형 | FM | 상품과 이미지 필수. 상품 제목 최대 30자, 가격은 0~99999999의 정수. | 버튼 1~2개, 버튼 이름 최대 8자. 채널 추가 버튼은 마지막에 배치. |
| 캐러셀 커머스형 | FA | 상품 카드 최대 6개. 헤더 카드가 없으면 최소 2개, 헤더 카드가 있으면 최소 1개. | 카드당 버튼 1~2개. 전체 최대 쿠폰 1개, 채널 추가 버튼 1개. |
| 프리미엄 동영상형 | FP | 동영상 필수, tv.kakao.com 주소만 지원. 본문 최대 76자, 줄바꿈 5회. | 버튼 최대 1개, 버튼 이름 최대 8자. |
공통 규칙: 현재 URL 버튼과 채널 추가 버튼 두 가지만 지원합니다. URL 버튼에는 모바일 링크를 반드시 입력해야 하며 PC 링크는 선택 사항입니다. 이미지와 링크는 접근 가능한 HTTP/HTTPS 주소를 사용해야 합니다.
채널 추가 버튼은 채널 친구 대상에서 지원하지 않으며, 메시지 타입마다 버튼 위치 요구 사항이 다릅니다. 메시지 타입별 전체 필수 항목과 길이 제한은 페이지의 실시간 검증을 기준으로 합니다. 정식 작업에서는 유저 속성을 삽입하여 수신자별로 내용을 동적으로 바꿀 수 있습니다.
이미지 소재 권장 사항: JPEG 또는 PNG를 우선 사용하고, 너비는 500 px 이상을 권장하며, 선명도에 영향을 주지 않는 범위에서 파일 크기를 줄이십시오. 일반적으로 지원되는 비율은 2:1, 16:10, 3:2, 4:3, 1:1 또는 3:4입니다.
게시하기 전에 URL이 공개적으로 접근 가능하고 로그인이 필요 없으며 만료되지 않는지 확인하고, 테스트 발송으로 최종 크롭 및 표시 효과를 확인해야 합니다.
테스트 휴대폰 번호는 페이지 형식에 따라 입력하십시오. 현재 다음 세 가지 형식의 입력을 지원합니다.
01012345678
010 1234 5678
010-1234-5678
시스템은 발송할 때 한국 E.164 형식에 맞게 자동 변환합니다. 예: +821012345678.
시스템은 Infobip에서 최종 전달 결과를 반환한 후에만 테스트 성공을 표시합니다. 요청이 접수되었지만 30초 내에 전달 결과를 받지 못하면 계속 기다리거나 나중에 확인하라는 메시지를 표시합니다.
6. 정식 푸시 및 결과 확인
운영 작업이나 플로우를 생성할 때 활성화된 KakaoTalk 채널을 선택하고, 타깃 그룹, 대상 범위, 메시지 내용을 설정한 다음 발송이 허용된 시간대에 게시합니다. 시스템은 유저 속성에 따라 동적 내용을 바꾸므로 같은 작업에서도 유저마다 최종 문구가 다를 수 있습니다.
결과 기준: Infobip이 요청을 수락했다는 것은 메시지가 서비스 제공자의 처리 단계에 들어갔다는 뜻일 뿐, 유저가 이미 받았다는 뜻은 아닙니다.
도달 퍼널을 활성화하면 예약 푸시, 실제 푸시, 푸시 성공, 실제 도달, 푸시 클릭별로 결과를 확인할 수 있습니다. 이 중 실제 도달은 Infobip이 반환한 최종 전달을 기준으로 하고, 푸시 클릭은 클릭 콜백을 기준으로 합니다.
| 증상 | 확인 방법 |
|---|---|
| 권한 부여를 선택할 수 없거나 연결 실패 | Base URL이 완전한 HTTPS 주소인지, API Key가 유효한지, 계정에 KakaoTalk 권한이 있는지, 현재 네트워크에서 Infobip에 접근할 수 있는지 확인합니다. 403은 보통 권한 부족, 401은 보통 키가 유효하지 않음을 뜻합니다. |
| 채널을 활성화할 수 없음 | 권한 부여 연결이 정상인지, Sender가 유효하고 같은 권한 부여에서 중복 사용되지 않았는지, 휴대폰 번호 속성이 문자열 또는 숫자 타입인지 확인합니다. |
| 휴대폰 번호 형식 오류 | 최종 번호가 +82 뒤에 10자리 숫자가 붙은 형식인지 확인합니다(예: +821012345678). 공백, 하이픈 및 기타 기호를 제거하며, 국가 코드 다음 첫 자리는 0일 수 없습니다. |
| 메시지가 예약 시간에 발송되지 않음 | 트리거 시간이 베이징 시간 07:00(포함)부터 19:00(미포함) 사이인지 확인합니다. 시스템은 발송을 제출하기 전에 다시 확인하며, 시간대를 벗어나면 Infobip에 요청을 보내지 않습니다. |
| 내용 검증 실패 또는 거부됨 | 페이지 안내에 따라 필수 항목, 글자 수, 이미지 또는 카드 수, 버튼 순서, 링크를 확인합니다. 현재 URL 버튼과 채널 추가 버튼 두 가지만 지원하며, URL 버튼에는 모바일 링크를 반드시 입력해야 합니다. |
| 요청은 접수되었지만 테스트가 성공하지 않음 | 테스트 발송은 최종 전달 결과를 받아야 성공으로 처리됩니다. 시스템은 최대 30초 동안 기다리며, 여전히 처리 중이면 Infobip에서 번호 상태, 내용 심사, 계정 한도, 서비스 상태를 확인하십시오. |
| 전달 실패로 표시됨 | Infobip이 반환한 거부, 전달 불가 또는 만료 사유를 확인하고, 대상 범위, 마케팅 동의, Sender, 번호 상태, 메시지 내용을 중점적으로 확인합니다. |
| 서비스 속도 제한 또는 일시적 오류 | 잠시 후 다시 발송합니다. 시스템은 Infobip 발송 요청을 자동으로 재시도하지 않습니다. 계속 실패하면 반환 정보와 함께 플랫폼 관리자 또는 Infobip 지원팀에 문의하십시오. |
게시 전 확인: 채널이 활성화되어 있는지, 타깃 그룹이 마케팅 동의 조건을 충족하는지, 휴대폰 번호 속성을 사용할 수 있는지, 메시지 미리보기가 올바른지, 링크에 접근할 수 있는지 확인하고, 트리거 시간을 발송이 허용된 시간대 안으로 설정합니다.