시작하기

비즈뿌리오 는 SMS · LMS · MMS · 카카오 알림톡 · 카카오 브랜드메시지 · RCS · 네이버 톡톡 · FAX · PHONE 을 하나의 인터페이스로 발송할 수 있는 통합 메시징 플랫폼입니다. 본 문서는 발송 API 와 자원 관리 API 의 공식 레퍼런스입니다.

발송 방식

두 가지 방식 중 환경에 맞는 것을 선택하세요. 두 방식을 혼용해도 됩니다.

결과 수신: 메시지 API 는 Webhook(URL Push) 또는 Polling, BIZCLIENT 는 biz_msg.STATUS / CALL_STATUS 컬럼 확인.

자원 관리 API

템플릿 · 발신프로필 · 이미지 · 챗봇 · 메시지베이스 등 발송에 사용되는 자원을 프로그래매틱하게 관리합니다. 비즈뿌리오 사이트(GUI)에서 한 번씩 등록하는 대신 자동화하고 싶을 때 사용.

연동 규격 (공통)

메시지 API 도메인: 운영 api.bizppurio.com / 검수 dev-api.bizppurio.com. Rate Limit 초과 시 HTTP 429 + code: 5002 응답 — 백오프 후 재시도.

다음 단계

처음 연동하시면 사이드바 시작 › 시작하기 에서 연동 방식 비교 / 사전 준비 / 5분 Quickstart 를 확인하세요. 구체적인 엔드포인트·페이로드는 메시지 발송 / 관리 API 그룹 안의 각 페이지로 들어가면 됩니다.

비즈뿌리오 첫 발송까지 — 비교, 선택, 사전 준비, Quickstart

비즈뿌리오를 처음 연동하신다면 아래 순서대로 진행하세요.

1. 연동 방식 비교 — API vs BIZCLIENT 차이 파악
2. 연동 방식 선택 — 트래픽·보안·운영 환경 기준
3. 사전 준비 — 계정·발신번호·채널·브랜드 등록
4. Quickstart — cURL 또는 SQL 한 번으로 SMS 발송

---

1. 연동 방식 비교 (API vs BIZCLIENT)

2. 연동 방식 선택 가이드

3. 사전 준비 체크리스트

공통 (모든 사용자)

채널별 추가 등록

자원을 코드로 관리하고 싶다면

자원 등록을 GUI 대신 API 로 — 좌측 사이드바 관리 API 그룹 참고:

• KAPI — 카카오 알림톡 템플릿·이미지·발신프로필·브랜드메시지
• RAPI — RCS 브랜드·챗봇·파일·메시지베이스
• NAPI — 네이버 톡톡 파트너·그룹·이미지·템플릿

4. Quickstart

4-A. 메시지 API (cURL, 5분)

      # 환경 변수
export BP_HOST="dev-api.bizppurio.com"   # 운영: api.bizppurio.com
export BP_ACCOUNT="bizUserId001"
export BP_PASSWORD="mypassword"
export BP_FROM="07000000000"             # 등록된 발신번호
export BP_TO="01012345678"               # 수신 테스트 번호


# 1) 토큰 발급
AUTH=$(printf '%s' "$BP_ACCOUNT:$BP_PASSWORD" | base64)
ACCESS_TOKEN=$(curl -s -X POST "https://$BP_HOST/v1/token" \
  -H "Authorization: Basic $AUTH" \
  -H "Content-type: application/json; charset=utf-8" \
  | python -c "import sys, json; print(json.load(sys.stdin)['accesstoken'])")


# 2) SMS 발송
curl -X POST "https://$BP_HOST/v3/message" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "account": "'"$BP_ACCOUNT"'",
    "refkey": "test-'"$(date +%s)"'",
    "type": "sms",
    "from": "'"$BP_FROM"'",
    "to": "'"$BP_TO"'",
    "content": { "sms": { "message": "비즈뿌리오 Quickstart 테스트" } }
  }'

ℹ️ 토큰은 24시간 유효. 매 요청마다 발급하지 말고 캐싱해서 사용.

4-B. BIZCLIENT (SQL, 5분)

INSERT INTO biz_msg (
  MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME,
  DEST_PHONE, SEND_PHONE, MSG_BODY
) VALUES (
  0,                                         -- SMS
  CONCAT('TEST', UNIX_TIMESTAMP()),          -- 데이터 ID
  NOW(), NOW(),
  '01012345678',                             -- 수신번호
  '07000000000',                             -- 발신번호 (사전 등록)
  '비즈뿌리오 BIZCLIENT Quickstart 테스트'
);

BIZCLIENT 모듈이 큐를 폴링하여 자동 발송. 결과는 biz_msg.STATUS / CALL_STATUS 로 확인.

---

다음 단계

• POST /v3/message — 메시지 API 전체 페이로드 (모든 채널)
• BIZCLIENT 사이드바 그룹 — 채널별 INSERT 가이드
• 관리 API 사이드바 그룹 — 자원 등록·관리

연동 방식 비교에서 두 방식의 차이를 확인하셨다면, 아래 의사결정 트리로 빠르게 결정할 수 있습니다.

의사결정 트리

시나리오별 권장

결정 후 다음 단계

NOTE: 선택 후 사전 준비 단계는 두 방식 공통입니다. 사전 준비에서 비즈뿌리오 계정·발신번호·채널 등록을 먼저 마쳐야 발송이 가능합니다.

• API 선택 → Quickstart (API)
• BIZCLIENT 선택 → Quickstart (BIZCLIENT)

비즈뿌리오는 두 가지 연동 방식을 제공합니다.

한눈에 비교

발송 흐름 차이

API 연동

BIZCLIENT 연동

어떤 방식을 골라야 할까?

자세한 결정 흐름은 연동 방식 선택 가이드를 참고하세요.

채널 지원 매트릭스

발송 전에 비즈뿌리오 사이트에서 사용할 채널별로 다음 항목을 등록해야 합니다.

모든 사용자 공통

1. 비즈뿌리오 서비스 계정

2. 발신번호 등록

이동통신 메시지(SMS/LMS/MMS)·RCS·BIZCLIENT FAX/PHONE 모두 발신번호 사전 등록이 필수입니다.

비즈뿌리오 사이트에서 직접 등록.

3. (API 사용 시) 전송 결과 수신 URL 등록

Webhook(URL Push) 방식 사용 시 결과 수신용 URL(IP/PORT)을 비즈뿌리오에 등록 요청.

WARNING: 443·80 외 포트를 사용하려면 별도로 방화벽 접근 허용 요청이 필요합니다.

채널별 추가 등록

카카오 비즈메시지 (AT / BT)

RCS

네이버 톡톡 (NTALK, API 전용)

사용 채널별 체크리스트

자원을 코드로 관리하고 싶다면

비즈뿌리오 사이트(GUI)에서 한 번씩 등록할 수도 있지만, 자원을 프로그래매틱하게 관리하려면 다음 관리 API를 사용하세요.

• KAPI — 카카오 알림톡 템플릿·이미지·발신프로필·브랜드메시지 자원 CRUD
• RAPI — RCS 브랜드·챗봇·파일·메시지베이스 CRUD

다음 단계

준비가 끝나면 Quickstart로 진행하세요.

• Quickstart (API)
• Quickstart (BIZCLIENT)