브랜드 메시지 전송
1. SendBMSTextSingle - 텍스트 단건 전송
- 카카오톡 채널을 추가한 사용자 또는 마케팅 정보 수신에 동의한 사용자에게 텍스트형 광고성 메시지를 전송합니다.
- 비채널 친구에게 브랜드 메시지를 전송하기 위해서는 등록된 비즈니스 채널에 대해 브랜드 메시지 채널 신청이 필요합니다.
- 전송실패시 대체문자를 전송할 수 있고, 이 경우 문자(SMS/LMS) 요금이 과금됩니다.
string SendBMSTextSingle(string corpNum, BMS bms, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| bms | BMS | - | Y | 브랜드 메시지 정보 | |
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 접수번호(receiptNum)
예외
2. SendBMSTextSame - 텍스트 동보 전송
- 카카오톡 채널을 추가한 사용자 또는 마케팅 정보 수신에 동의한 사용자에게 텍스트형 광고성 메시지를 전송합니다. (최대 1,000건)
- 비채널 친구에게 브랜드 메시지를 전송하기 위해서는 등록된 비즈니스 채널에 대해 브랜드 메시지 채널 신청이 필요합니다.
- 전송실패시 대체문자를 전송할 수 있고, 이 경우 문자(SMS/LMS) 요금이 과금됩니다.
string SendBMSTextSame(string corpNum, BMS bms, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| bms | BMS | - | Y | 브랜드 메시지 정보 | |
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 접수번호(receiptNum)
예외
3. SendBMSImageSingle - 이미지 단건 전송
- 카카오톡 채널을 추가한 사용자 또는 마케팅 정보 수신에 동의한 사용자에게 이미지형 광고성 메시지를 전송합니다.
- 비채널 친구에게 브랜드 메시지를 전송하기 위해서는 등록된 비즈니스 채널에 대해 브랜드 메시지 채널 신청이 필요합니다.
- 브랜드 메시지 전송 전에 [UploadImage - 이미지 업로드] API로 이미지 업로드가 필요합니다.
- 전송실패시 대체문자를 전송할 수 있고, 이 경우 문자(SMS/LMS) 요금이 과금됩니다.
string SendBMSImageSingle(string corpNum, Bms bms, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| bms | BMS | - | Y | 브랜드 메시지 정보 | |
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 접수번호(receiptNum)
예외
4. SendBMSImageSame - 이미지 동보 전송
- 카카오톡 채널을 추가한 사용자 또는 마케팅 정보 수신에 동의한 사용자에게 이미지형 광고성 메시지를 전송합니다. (최대 1,000건)
- 비채널 친구에게 브랜드 메시지를 전송하기 위해서는 등록된 비즈니스 채널에 대해 브랜드 메시지 채널 신청이 필요합니다.
- 브랜드 메시지 전송 전에 [UploadImage - 이미지 업로드] API로 이미지 업로드가 필요합니다.
- 전송실패시 대체문자를 전송할 수 있고, 이 경우 문자(SMS/LMS) 요금이 과금됩니다.
string SendBMSImageSame(string corpNum, BMS bms, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| bms | BMS | - | Y | 브랜드 메시지 정보 | |
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 접수번호(receiptNum)
예외
5. SendBMSWideImageSingle - 와이드 단건 전송
- 카카오톡 채널을 추가한 사용자 또는 마케팅 정보 수신에 동의한 사용자에게 와이드 이미지형 광고성 메시지를 전송합니다.
- 비채널 친구에게 브랜드 메시지를 전송하기 위해서는 등록된 비즈니스 채널에 대해 브랜드 메시지 채널 신청이 필요합니다.
- 브랜드 메시지 전송 전에 [UploadWideImage - 와이드형 이미지 업로드] API로 이미지 업로드가 필요합니다.
- 전송실패시 대체문자를 전송할 수 있고, 이 경우 문자(SMS/LMS) 요금이 과금됩니다.
string SendBMSWideImageSingle(string corpNum, BMS bms, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| bms | BMS | - | Y | 브랜드 메시지 정보 | |
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 접수번호(receiptNum)
예외
6. SendBMSWideImageSame - 와이드 동보 전송
- 카카오톡 채널을 추가한 사용자 또는 마케팅 정보 수신에 동의한 사용자에게 와이드 이미지형 광고성 메시지를 전송합니다. (최대 1,000건)
- 비채널 친구에게 브랜드 메시지를 전송하기 위해서는 등록된 비즈니스 채널에 대해 브랜드 메시지 채널 신청이 필요합니다.
- 브랜드 메시지 전송 전에 [UploadWideImage - 와이드형 이미지 업로드] API로 이미지 업로드가 필요합니다.
- 전송실패시 대체문자를 전송할 수 있고, 이 경우 문자(SMS/LMS) 요금이 과금됩니다.
string SendBMSWideImageSame(string corpNum, BMS bms, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| bms | BMS | - | Y | 브랜드 메시지 정보 | |
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 요청에 대한 접수번호(receiptNum)
예외
7. UploadImage - 이미지 업로드
- 브랜드 메시지 전송에 사용할 이미지를 업로드합니다.
string UploadImage(string corpNum, string filePath, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| filePath | string | - | Y |
이미지 파일 경로
가로:세로 비율제한 2:1이상 3:4이하
권장 사이즈 800*400px 가로 500px 이상 파일형식 및 크기 jpg, png / 최대 5MB |
|
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 이미지 URL(imageUrl)
예외
8. UploadImageBinary - 이미지 업로드 (바이너리)
- 브랜드 메시지 전송에 사용할 바이너리 형식의 이미지를 업로드합니다.
string UploadImage(string corpNum, BinaryFile file, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| file | BinaryFile | - | Y |
이미지 파일
가로:세로 비율제한 2:1이상 3:4이하
권장 사이즈 800*400px 가로 500px 이상 파일형식 및 크기 jpg, png / 최대 5MB |
|
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 이미지 URL(imageUrl)
예외
9. UploadWideImage - 와이드 이미지 업로드
- 브랜드 메시지 전송에 사용할 와이드 이미지를 업로드합니다.
string UploadWideImage(string corpNum, string filePath, string userID)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| filePath | string | - | Y |
이미지 파일
가로:세로 비율제한 2:1이상 1:1이하
권장 사이즈 800*600px 가로 500px 이상 파일형식 및 크기 jpg, png / 최대 5MB |
|
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 이미지 URL(imageUrl)
예외
10. UploadWideImageBinary - 와이드 이미지 업로드 (바이너리)
- 브랜드 메시지 전송에 사용할 바이너리 형식의 와이드 이미지를 업로드합니다.
string UploadWideImage(string corpNum, BinaryFile file, string userID) throws PopbillException
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| file | BinaryFile | - | Y |
이미지 파일
가로:세로 비율제한 2:1이상 1:1이하
권장 사이즈 800*600px 가로 500px 이상 파일형식 및 크기 jpg, png / 최대 5MB |
|
| userID | string | 50 | N | 팝빌회원 아이디 |
응답
string - 이미지 URL(imageUrl)
예외
11. CancelReserve - 예약전송 취소 (접수번호)
- 팝빌에서 반환받은 접수번호로 예약된 카카오톡을 전송 취소합니다. (예약시간 10분 전까지 가능)
Response CancelReserve(string CorpNum, string receiptNum, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| receiptNum | string | 18 | Y |
팝빌에서 할당한 접수번호
카카오톡 예약전송 요청의 반환값
|
|
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
12. CancelReservebyRCV - 예약전송 부분 취소 (접수번호)
- 팝빌에서 반환받은 접수번호로 접수 건을 식별하여 수신번호에 예약된 카카오톡을 전송 취소합니다. (예약시간 10분 전까지 가능)
Response CancelReservebyRCV(string CorpNum, string receiptNum, string receiveNum, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| receiptNum | string | 18 | Y |
팝빌에서 할당한 접수번호
카카오톡 예약전송 요청의 반환값
|
|
| receiveNum | string | 20 | Y | 예약전송 수신번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
13. CancelReserveRN - 예약전송 전체 취소 (요청번호)
- 파트너가 할당한 요청번호로 예약된 카카오톡을 전송 취소합니다. (예약시간 10분 전까지 가능)
Response CancelReserveRN(string CorpNum, string requestNum, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| requestNum | string | 36 | Y | 파트너가 할당한 요청번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |
응답
예외
14. CancelReserveRNbyRCV - 예약전송 부분 취소 (요청번호)
- 파트너가 할당한 요청번호로 접수 건을 식별하여 수신번호에 예약된 카카오톡을 전송 취소합니다. (예약시간 10분 전까지 가능)
Response CancelReserveRNbyRCV(string CorpNum, string requestNum, string receiveNum, string UserID = null)
요청
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| requestNum | string | 36 | Y | 파트너가 할당한 요청번호 | |
| receiveNum | string | 20 | Y | 예약전송 수신번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 |












