# 카카오톡 API

비즈니스 채널을 기반으로 기업 마케팅에 최적화된 형태의 메시지 전송이 가능하며 정보성 메시지를 전송하는 알림톡, 광고/마케팅 메시지를 전송하는 브랜드 메시지 유형을 활용할 수 있습니다.

| 구분    | 알림톡            | 브랜드 메시지                                      |
| ----- | -------------- | -------------------------------------------- |
| 전송목적  | 정보성 메시지 전송     | 광고/마케팅 메시지 전송                                |
| 전송대상  | 모든 카카오톡 이용자    | 채널친구+마케팅 수신동의 고객 대상                          |
| 광고메시지 | 전송 불가능         | 전송 가능 (20:50\~익일 08:00 전송 제한)                |
| 전송유형  | 텍스트ㆍ이미지ㆍ강조표기   | 텍스트ㆍ이미지ㆍ와이드ㆍ리스트ㆍ캐러셀                          |
| 준비사항  | 카카오의 승인 받은 템플릿 | 마케팅 수신동의 자료 080수신거부 번호 (선택 사항으로 전송대상에 따라 필요) |

> 전송에 실패하는 경우 문자(SMS/LMS) 메시지로 대체하여 전송하도록 ‘대체문자’ 서비스를 지원합니다.

## API 목록

### 비즈니스 채널 관리

- [1. GetPlusFriendMgtURL - 비즈니스 채널 등록 팝업 URL](https://developers.popbill.com/reference/kakaotalk/php/api/channel#GetPlusFriendMgtURL)
- [2. ListPlusFriendID - 비즈니스 채널 목록 확인](https://developers.popbill.com/reference/kakaotalk/php/api/channel#ListPlusFriendID)

### 알림톡 템플릿

- [1. GetATSTemplateMgtURL - 알림톡 템플릿 등록 팝업 URL](https://developers.popbill.com/reference/kakaotalk/php/api/template#GetATSTemplateMgtURL)
- [2. GetATSTemplate - 알림톡 템플릿 정보 확인](https://developers.popbill.com/reference/kakaotalk/php/api/template#GetATSTemplate)
- [3. ListATSTemplate - 알림톡 템플릿 목록 확인](https://developers.popbill.com/reference/kakaotalk/php/api/template#ListATSTemplate)

### 알림톡 전송

- [1. SendATS - 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send#SendATS)
- [2. CancelReserve - 예약전송 취소 (접수번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send#CancelReserve)
- [3. CancelReservebyRCV - 예약전송 부분 취소 (접수번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send#CancelReservebyRCV)
- [4. CancelReserveRN - 예약전송 전체 취소 (요청번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send#CancelReserveRN)
- [5. CancelReserveRNbyRCV - 예약전송 부분 취소 (요청번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send#CancelReserveRNbyRCV)

### 브랜드 메시지 템플릿

- [1. GetBMSTemplateMgtURL - 브랜드 메시지 템플릿 관리 팝업 URL](https://developers.popbill.com/reference/kakaotalk/php/api/bms-template#GetBMSTemplateMgtURL)
- [2. GetBMSTemplate - 브랜드 메시지 템플릿 정보 확인](https://developers.popbill.com/reference/kakaotalk/php/api/bms-template#GetBMSTemplate)
- [3. ListBMSTemplate - 브랜드 메시지 템플릿 목록 확인](https://developers.popbill.com/reference/kakaotalk/php/api/bms-template#ListBMSTemplate)

### 브랜드 메시지 전송

- [1. SendBMSText - 텍스트 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSText)
- [2-1. SendBMSImage - 이미지 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSImage)
- [2-2. UploadImage - 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadImage)
- [2-3. UploadImageBinary - 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadImageBinary)
- [3-1. SendBMSWideImage - 와이드 이미지 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSWideImage)
- [3-2. UploadWideImage - 와이드 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadWideImage)
- [3-3. UploadWideImageBinary - 와이드 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadWideImageBinary)
- [4-1. SendBMSWideList - 리스트 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSWideList)
- [4-2. UploadWideListMainImage - 리스트 메인 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadWideListMainImage)
- [4-3. UploadWideListMainImageBinary - 리스트 메인 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadWideListMainImageBinary)
- [4-4. UploadWideListImage - 리스트 서브 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadWideListImage)
- [4-5. UploadWideListImageBinary - 리스트 서브 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadWideListImageBinary)
- [5-1. SendBMSCarouselFeed - 캐러셀 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSCarouselFeed)
- [5-2. UploadCarouselFeedImage - 캐러셀 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadCarouselFeedImage)
- [5-3. UploadCarouselFeedImageBinary - 캐러셀 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadCarouselFeedImageBinary)
- [6-1. SendBMSCommerce - 커머스 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSCommerce)
- [6-2. UploadCommerceImage - 커머스 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadCommerceImage)
- [6-3. UploadCommerceImageBinary - 커머스 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadCommerceImageBinary)
- [7-1. SendBMSCarouselCommerce - 캐러셀 커머스 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSCarouselCommerce)
- [7-2. UploadCarouselCommerceImage - 캐러셀 커머스 이미지 업로드](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadCarouselCommerceImage)
- [7-3. UploadCarouselCommerceImageBinary - 캐러셀 커머스 이미지 업로드 (바이너리)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#UploadCarouselCommerceImageBinary)
- [8. SendBMSVariable - 템플릿형 전송](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#SendBMSVariable)
- [9. CancelReserve - 예약전송 취소 (접수번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#CancelReserve)
- [10. CancelReservebyRCV - 예약전송 부분 취소 (접수번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#CancelReservebyRCV)
- [11. CancelReserveRN - 예약전송 전체 취소 (요청번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#CancelReserveRN)
- [12. CancelReserveRNbyRCV - 예약전송 부분 취소 (요청번호)](https://developers.popbill.com/reference/kakaotalk/php/api/send-bms#CancelReserveRNbyRCV)

### 전송결과

- [1. GetMessages - 카카오톡 전송내역 확인](https://developers.popbill.com/reference/kakaotalk/php/api/info#GetMessages)
- [2. GetMessagesRN - 카카오톡 전송내역 확인 (요청번호 할당)](https://developers.popbill.com/reference/kakaotalk/php/api/info#GetMessagesRN)
- [3. Search - 전송내역 목록 조회](https://developers.popbill.com/reference/kakaotalk/php/api/info#Search)
- [4. GetSentListURL - 카카오톡 전송내역 팝업 URL](https://developers.popbill.com/reference/kakaotalk/php/api/info#GetSentListURL)

### 발신번호 관리

- [1. CheckSenderNumber - 발신번호 등록여부 확인](https://developers.popbill.com/reference/kakaotalk/php/api/sendnum#CheckSenderNumber)
- [2. GetSenderNumberMgtURL - 발신번호 등록 팝업 URL](https://developers.popbill.com/reference/kakaotalk/php/api/sendnum#GetSenderNumberMgtURL)
- [3. GetSenderNumberList - 발신번호 목록 확인](https://developers.popbill.com/reference/kakaotalk/php/api/sendnum#GetSenderNumberList)