POPBill Developers
가이드

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

API Reference

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

SDK

다수 개발자에게 검증받은
SDK Example을 제공합니다.

추가 개발언어는 신청주시면
검토 후 지원합니다.
Webhook(웹훅)

팝빌에서 발생한 이벤트 정보를
고객사 서버로 즉시 전송합니다.

가이드
카카오톡
Java
가이드 카카오톡 Java 연동환경 구성

팝빌 연동환경

팝빌은 팝빌 테스트 환경과 팝빌 운영(Production) 환경을 독립적으로 운영하고, 팝빌 운영(Production) 환경과 모든 기능이 동일하게 작동하는 팝빌 테스트 환경을 제공하여 실제 서비스와 동일한 조건에서 연동개발이 가능하도록 지원하고 있습니다.

  • 독립적인 개발환경
  • 동일 API Key (LinkID, SecretKey) 사용
  • 테스트포인트 무료 지원 (일부 제한)

연동절차

  1. 연동신청 : 프로그램 공급사 사업자정보로 연동신청 합니다. [연동신청]

    개발 테스트를 위하여 연동신청에 필요한 입력정보는 아래와 같습니다.

    1. 1) 회사정보 – 사업자번호, 회사명, 대표자, 업태, 종목, 주소
    2. 2) 계정정보 – ID, PW
      • 입력하신 정보로 팝빌 파트너 관리자와 팝빌 테스트 사이트와 팝빌 운영(Prodution) 사이트 계정이 생성됩니다.
      • 승인이 완료된 ID는 변경이 불가하므로 개인이 아닌 회사를 대표하는 계정정보로 신청하여 주시기 바랍니다.
    3. 3) 담당자정보 – 이름, 이메일, 연락처
  2. API Key 설정 : 팝빌에서 발급한 API Key를 수신하여 SDK에 설정합니다. [SDK 환경설정]

    팝빌은 연동신청 접수 후 20분(영업일 기준) 이내에 프로그램 공급사 고유 API Key 를 발급합니다. 팝빌 카카오톡 API 사용을 위해 수신한 API Key 를 SDK에 설정합니다.

    • 링크아이디(LinkID) : 프로그램 공급사를 식별할 수 있는 고유정보로 회원가입 등 고객사 관리에 사용됩니다.
    • 비밀키(SecretKey) : API 통신전문 변조를 방지하기 위해 사용됩니다.

    API Key는 프로그램 공급사를 식별할 수 있는 고유정보로 외부에 유출되지 않도록 주의합니다.

  3. 카카오톡 채널 및 발신번호 사전등록 : 채널과 발신번호를 등록하여 카카오톡을 전송합니다.

    카카오톡 전송 테스트를 위해 팝빌 테스트 계정에 카카오톡 채널과 발신자의 발신번호 등록이 필요합니다. 사전등록은 아래 2가지 방법을 지원합니다.

    • 팝빌 사이트 등록

      1) 카카오톡 채널 : 팝빌 테스트 사이트 로그인 (https://test.popbill.com) > 문자ㆍ팩스 > 카카오톡 > 카카오톡 관리 > 카카오톡 채널 관리
      2) 발신번호 : 팝빌 테스트 사이트 로그인 (https://test.popbill.com)> 문자ㆍ팩스 > 카카오톡 > 발신번호 사전등록

    • API 등록

      1) 카카오톡 채널 : 카카오톡 채널 등록 API를 호출하여 등록
      [GetPlusFriendMgtURL - 카카오톡 채널 관리 팝업 URL]
      2) 발신번호 : 발신번호 사전등록 API를 호출하여 등록
      [GetSenderNumberMgtURL - 발신번호 관리 팝업 URL]

    유의사항
    • 카카오톡 채널은 카카오 비즈니스 사이트에서 생성 가능하며, 사업자 인증을 통해 비즈니스 채널로 전환합니다. [카카오톡 채널 만들기]
    • 알림톡은 카카오의 승인이 완료된 템플릿 내용으로만 메시지 전송이 가능합니다. [알림톡 템플릿 신청]
  4. 개발 테스트 : 개발에 필요한 테스트포인트를 무료 제공합니다.

    API Key 를 설정한 SDK와 연동 문서를 참고하여 모든 API 테스트가 가능합니다. 팝빌은 테스트포인트를 무료(일부 제한)로 제공하며, 포인트를 모두 소진한 경우 추가 요청도 가능합니다. [포인트 요청]

  5. 팝빌 운영(Production) 환경 서비스 전환 : 계약 체결이 완료된 이후 서비스 이용이 가능합니다.
    1. 1) 테스트가 완료된 후 팝빌 운영(Production) 환경으로 서비스 전환을 신청합니다. [운영(PROD) 전환신청]
    2. 2) 팝빌 운영(Production) 환경 전환을 위한 협의사항을 팝빌 담당자와 유선으로 확인합니다.
    3. 3) 팝빌로부터 전환 완료 메일 수신한 후 SDK 환경설정 변수값을 변경합니다.

      - API Key 는 팝빌 테스트 환경와 팝빌 운영(Production) 환경에서 동일하게 적용되어 별도 운영용 API Key 발급이 필요하지 않습니다.

      - 전환 후에도 SDK 환경설정 변수로 팝빌 테스트 환경와 팝빌 운영(Production) 환경을 모두 이용할 수 있습니다.

      SDK 환경설정 변경

      SDK의 서비스 객체를 생성하는 config 의 IsTest값을 "true"(테스트)에서 "false"(운영)로 변경합니다. [SDK 환경설정]

    4. 4) 팝빌 운영(Production) 환경 회원가입 및 서비스 이용을 위한 사전 준비사항(카카오톡 채널/발신번호 등록, 포인트 충전 등)을 처리합니다.