자주 묻는 질문
팝빌 API 상품을 도입·연동하기 전에 확인해야 할 주요 사항과, 연동 과정에서 자주 문의되는 내용을 안내합니다.
공통
-
API 연동에 기본료나 도입비용이 있나요?
없습니다. 테스트 환경은 무료 포인트로 제공되며, 실제 서비스 이용 시에만 요금이 발생합니다.
-
프로그램을 연동하여 고객사에 팝빌 API를 제공할 수 있나요?
네, 가능합니다. 단, 고객사가 팝빌에 파트너의 연동회원으로 가입해야 합니다.
팝빌에서는 프로그램 공급사를 '파트너', 파트너의 프로그램을 이용하는 고객사를 '연동회원'이라고 하며, 파트너가 제공하는 프로그램에서 팝빌 API를 사용하기 위해서는 고객사의 연동회원 가입이 필요합니다. [회원 구조]
-
테스트 환경에서도 사전 준비가 필요한가요?
네, 필요합니다. 팝빌 테스트 환경은 운영 환경과 동일하게 동작하므로, 사전 준비를 완료한 후에 테스트를 진행할 수 있습니다.
또한 팝빌 테스트 환경에 등록된 정보는 운영 환경과 동기화되지 않으며, 서로 독립적으로 관리됩니다. -
테스트 포인트가 부족합니다. 추가로 지원받을 수 있나요?
네, 테스트 포인트가 소진된 경우 추가 신청을 통해 지원받을 수 있습니다. 테스트 환경에서는 팝빌이 제공하는 포인트로 개발을 진행하며, 포인트가 소진되면 팝빌에 테스트 포인트를 신청하여 계속 테스트할 수 있습니다.
단, 원가가 발생하는 일부 서비스는 포인트 지원이 제한될 수 있습니다. [테스트 포인트 신청] -
운영(Production) 환경에서 테스트 환경으로 전환할 수 있나요?
네, 가능합니다. 설정 변경을 통해 테스트 환경과 운영 환경을 자유롭게 전환할 수 있습니다.
* SDK 레퍼런스 - SDK 설정값(IsTest)을 변경합니다. [SDK 환경설정]
* API 레퍼런스 - 도메인 및 ServiceID를 변경합니다. [API 환경설정]
-
“호출한 API 상품에 이용 권한이 부여되지 않아 사용이 제한됩니다.” 오류 메시지가 응답 되었습니다. 어떻게 조치해야 하나요?
네, 해당 오류는 호출한 API 상품이 미등록된 경우 발생합니다.
추가로 API 상품 테스트 또는 사용이 필요한 경우, 연동문의를 통해 상품 추가를 요청해 주시기 바랍니다. [연동 문의] -
팝빌 SDK 외에 기술 문서를 제공받을 수 있나요?
네, 제공받을 수 있습니다.
팝빌 SDK 사용이 어려운 환경에서는 직접 구현하실 수 있도록 API 레퍼런스가 제공됩니다. [API 레퍼런스]
카카오톡
-
알림톡을 전송하고 싶습니다. 사전에 준비해야 하는 준비사항이 있나요?
네, 있습니다. 카카오톡 비즈메시지 이용을 위해 카카오톡 비즈니스 사이트에서 채널 개설 및 비즈니스 채널 전환이 필요합니다.
비즈니스 채널은 누구나 무료로 생성할 수 있는 기업용 채널로, 알림톡 발송에 필수입니다. [카카오톡 연동절차 안내] -
카카오톡을 이용하지 않는 사용자에게 문자로 대신 전송할 수 있나요?
네, 가능합니다. 팝빌은 카카오톡 전송이 실패하는 경우 문자로 자동 전송하는 대체문자 기능을 제공하며, 이를 통해 메시지 수신율을 높일 수 있습니다.
대체문자 전송유형은 두 가지를 지원합니다. [대체문자]
* 카카오톡 내용 전송 : 카카오톡 내용과 동일한 내용을 문자로 전송합니다.
* 대체문자 내용 전송 : 전송할 내용을 별도로 작성하여 문자로 전송합니다. -
카카오톡 웹훅(Webhook) 서비스를 지원하나요?
네, 지원합니다. 팝빌은 카카오톡 전송 결과 및 상태 변경 시점에 고객사 서버로 정보를 실시간 자동 전달하는 웹훅(Outgoing Webhook) 서비스를 무료로 제공합니다.
이를 통해 상태 확인을 위한 반복적인 API 호출을 줄여 리소스를 절감할 수 있으며, 고객사의 개발 소요시간을 낮추고 시스템 운영 효율을 높일 수 있습니다. [<업계유일>팝빌 카카오톡 Webhook] -
알림톡으로 전송하는 경우에 ‘631 - 메시지를 전송할 수 없음’ 결과코드가 반환됩니다.
수신자가 카카오톡 채널을 차단했거나, 카카오톡 앱이 설치되어 있지 않은 경우 해당 결과코드가 반환될 수 있습니다.
전송 결과가 '성공' 상태임에도 메시지를 수신하지 못하는 경우에는, 알림톡이 발송된 연락처가 카카오톡에 인증된 전화번호가 맞는지 확인이 필요합니다.
※ 인증 전화번호 확인방법 : [카카오톡 앱 > 내정보 > 카카오계정 > 전화번호 확인] -
알림톡이 휴면 템플릿 처리가 되었습니다.
알림톡 템플릿은 1년간 사용 이력이 없으면 카카오 정책에 따라 자동으로 휴면 처리되며, 휴면 상태가 1년 동안 지속되면 자동 삭제됩니다. 삭제된 템플릿은 휴면 해제가 불가능하므로, 새 템플릿을 다시 신청하여 사용해야 합니다.
※ 휴면 해제 방법 : 팝빌 사이트(www.popbill.com) 로그인 > 카카오톡 > 관리 > 알림톡 템플릿 관리 > 템플릿 목록 > 보기 > 휴면해제
또한 템플릿이 휴면 상태가 되지 않도록, 연 1회 이상 각 템플릿마다 최소 1건씩 알림톡을 발송하는 것을 권장드립니다. -
대체문자를 사용하면 알림톡 템플릿 버튼의 링크는 어떻게 전송되나요?
알림톡 발송이 실패되어 대체문자로 전송되는 경우에는 부가메시지, 버튼 링크 정보는 전송되지 않습니다.
대체문자에서 링크를 안내하려면, 대체문자 유형(AltSendType)을 “A”로 설정하고 링크 내용을 문자 본문에 직접 작성해야 합니다. -
파트너 계정에 다수의 고객사 발신번호를 등록해 대체문자를 이용할 수 있나요?
가능합니다. 다만 전송내역 분리 및 발신번호 관리를 위해 고객사의 팝빌 회원가입을 권장합니다.
고객사가 가입하지 않은 상태에서 파트너 계정으로 고객사 발신번호를 등록하는 경우, 타사 발신번호(소유자: 타사) 유형으로 접수되며 위임장, 거래관계 입증자료 등이 필요합니다.
또한 신청자는 발신번호 소유 사업자(자사)의 재직자여야 합니다. 재직자가 아닌 타사 담당자 명의로는 등록이 불가하므로, 자사 소속 직원으로 신청자 변경 후 등록하거나 소유 사업자의 계정에서 ‘타사 발신번호’ 유형으로 등록해야 합니다. (신청자 변경은 팝빌 마이페이지에서 담당자 정보 변경으로 진행합니다.) -
발신번호 서류 중 ‘통신사 이용증명원’은 무엇이며 제출이 필수인가요?
통신사 이용증명원은 해당 발신번호의 소유자를 확인하기 위한 증빙서류로, 소유자명 확인을 위해 제출이 필수입니다.
팝빌에서는 발급일 기준 1개월 이내 서류만 접수 가능합니다. -
팝빌에 등록된 발신번호를 변경할 수 있나요?
전기통신사업법에 따라 등록된 발신번호의 변경은 불가합니다. 변경이 필요할 경우 신규 발신번호로 다시 등록 신청해야 합니다.
기존에 등록된 발신번호는 팝빌에서 직접 삭제할 수 있습니다.
기타
-
팝빌 API 사용 시 IP 또는 방화벽 등록이 필요한가요?
기본적으로 팝빌 API 사용에 있어 IP 또는 방화벽 등록은 필수 사항이 아닙니다.
단, 고객사의 보안정책(방화벽 등)으로 고정 IP 설정이 필요한 경우 아래와 같이 설정할 수 있습니다.
· SDK Reference - [UseStaticIP : 통신 IP 고정(방화벽)] 설정
· API Reference - [공통 정의 사항] Base URL을 고정IP 주소로 변경
또한 고객사 Source IP에 대한 [IP Whitelisting] 를 설정하여 보안을 강화할 수 있습니다.
