sendgo-rails 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96f0416d41e80b4e8769d96d6bdd07978f0d0ff85541226500a5f0625b01d536
-  data.tar.gz: 5c54d373690e8cef8ccf156ac7d999a846b4949267f602c188a5e40271cb922a
+  metadata.gz: 95e1374d1b5f84fa58732630066ebabf4d29bd75cee705cef5e6398b1a3c8ab1
+  data.tar.gz: f4f36a5d8a21c9da987fb19f53cf3eb5ce8a521bcc22c45c6183a12aeeca5cce
 SHA512:
-  metadata.gz: fb1be21e7e857a437c268133e5d1d1350ab9d2575acad49af25380b87cbbe7522f190aeffd198ac5f73bba45d670e87d9e7824316c43b46401455a22296c5551
-  data.tar.gz: 4d9fd443c69917a6cc7aa3e97825b57daee20662792095e6193c1f2bac757dfde0fb6cafcc462ba6bf94b8d2964054cc178afd413e4fb99c1732954ac07cc493
+  metadata.gz: 448c5b0dedf51f6570ae14f02ba3f13d04aa97872f58e2616bbdc62bb93bb0818e244597cd11fcfa7dd90fb36b88fdf3e0f58cfdf580822373865bb53f590557
+  data.tar.gz: c0796b9defc6863f42ff8fc4a391d07c5337eb48834ad57a45f1dc7a570002b4e5002101b0a5a18ef368693a8856303a4b9a8acf00f9021957eb429d95ee87d0

data/README.md

@@ -337,8 +337,118 @@ A. `Sendgo::Rails.reset!`을 호출하면 메모이즈된 클라이언트가 초
 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
 [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
 
+## 관리 API — 채널·템플릿·발신번호 등록 (v2 전용)
+
+`Sendgo::Rails.client` 에 코어의 관리 서비스가 그대로 붙어 있습니다.
+콘솔에서만 되던 등록·심사를 컨트롤러나 rake 태스크에서 처리할 수 있습니다.
+
+| 접근 | 하는 일 | 계정 |
+| --- | --- | --- |
+| `.kakao_senders` | 카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청 | 기업 |
+| `.notice_templates` | 알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제 | 기업 |
+| `.brand_templates` | 브랜드메시지 템플릿 CRUD, 동기화, 가져오기 | 기업 |
+| `.sender_registration` | 발신번호 등록 신청, 중복 확인, 유형 안내 | 개인·기업 |
+| `.message_templates` | 문자 상용구 템플릿 CRUD | 개인·기업 |
+| `.kakao_images` | 카카오 이미지 업로드 — 템플릿용 URL 발급 | 기업 |
+| `.rejected_numbers` | 수신거부(080) 번호 조회 | 개인·기업 |
+| `.webhook` | 이벤트 웹훅 구독 — 심사 결과 수신 | 개인·기업 |
+
+> **sendgo.io 콘솔에 들어올 일이 없습니다.** 고객의 채널·발신번호·템플릿을
+> 여러분 화면만으로 끝까지 처리할 수 있습니다. 휴대폰 발신번호는 콘솔의 PASS
+> 본인인증 대신 **신분증 사본(`identityDocument`)을 받아 sendgo 운영자가 대신
+> 심사**합니다.
+>
+> 사람이 개입하는 지점은 **카카오 채널 인증번호 하나**뿐이고, 그마저도
+> 여러분 화면에서 입력받으면 됩니다 — 카카오가 관리자 휴대폰으로 직접 보내는
+> 확인이라 없앨 수 없습니다.
+>
+> 심사가 붙는 것들은 **비동기**입니다. 등록 호출이 성공했다는 건 "접수됐다"는
+> 뜻이지 "쓸 수 있다"는 뜻이 아닙니다 — 웹훅을 구독해 결과를 받으세요.
+
+```ruby
+# app/controllers/onboarding_controller.rb
+class OnboardingController < ApplicationController
+  # 1단계 — 카카오가 관리자 휴대폰으로 인증번호를 SMS 발송한다
+  def request_channel_code
+    Sendgo::Rails.client.kakao_senders.request_token(params[:yellow_id], params[:phone])
+    render json: { message: "인증번호를 발송했습니다." }
+  end
+
+  # 2단계 — 사용자가 입력한 인증번호로 발신프로필 생성
+  def create_channel
+    created = Sendgo::Rails.client.kakao_senders.create(
+      token: params[:code],
+      yellow_id: params[:yellow_id],
+      phone_number: params[:phone],
+      category_code: "001001"
+    )
+
+    render json: created.dig("data", "sender")
+  end
+end
+```
+
+```ruby
+# lib/tasks/sendgo.rake
+namespace :sendgo do
+  desc "표준 알림톡 템플릿을 등록하고 검수를 요청한다"
+  task :provision_templates, [:kakao_sender_key] => :environment do |_t, args|
+    created = Sendgo::Rails.client.notice_templates.create(
+      kakao_sender_key: args[:kakao_sender_key],
+      template_name: "주문 접수 안내",
+      template_content: "\#{name}님, 주문 \#{orderNo}이 접수되었습니다.",
+      template_message_type: "BA",
+      template_emphasize_type: "NONE",
+      category_code: "001001",
+      message_purpose: "order_delivery",
+      legal_basis: "transaction",
+      benefit_origin: "none",
+      expiry_type: "none"
+    )
+
+    code = created.dig("data", "template", "templateCode")
+    Sendgo::Rails.client.notice_templates.request_inspection(code)
+
+    puts "검수 요청 완료: #{code}"
+  end
+
+  desc "검수 결과를 확인한다 — 30분마다 돌린다"
+  task poll_inspections: :environment do
+    PendingTemplate.where(approved_at: nil).find_each do |pending|
+      result = Sendgo::Rails.client.notice_templates.sync(pending.template_code)
+      status = result.dig("data", "template", "inspectionStatus")
+
+      pending.update!(approved_at: Time.current) if status == "APR"
+      pending.update!(rejected_reason: result.dig("data", "template", "comments")) if status == "REJ"
+    end
+  end
+end
+```
+
+검수는 30분~1영업일 걸립니다. 배포 파이프라인 안에서 동기적으로 기다리지 말고
+`solid_queue` 나 cron 으로 폴링하세요.
+
+전체 파라미터는 [sendgo gem README](https://github.com/send-go/ruby) 를 참고하세요.
+
+---
+
 ## 변경 사항
 
+### 1.3.0 (2026-09-11)
+
+- **관리 API 노출** — 코어 1.3.0 의 `kakao_senders` · `notice_templates` ·
+  `brand_templates` · `sender_registration` · `message_templates` 를
+  `Sendgo::Rails.client` 에서 그대로 쓸 수 있습니다. 콘솔에서만 되던 채널 등록,
+  알림톡 템플릿 검수 요청, 발신번호 심사 접수를 컨트롤러나 rake 태스크에서
+  처리합니다.
+- `sendgo` 젬 의존성을 `~> 1.3` 으로 올렸습니다.
+- **이벤트 웹훅** 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단,
+  브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로
+  검증합니다(SDK 에 검증 헬퍼 포함).
+- **카카오 이미지 업로드** 추가 — 브랜드메시지 템플릿의 `imageUrl` 은 카카오가
+  호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다.
+- **수신거부(080) 조회** 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.
+
 ### 1.2.1 (2026-08-14)
 
 - 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.

data/lib/sendgo/rails/version.rb

@@ -1,6 +1,6 @@
 module Sendgo
   module Rails
     # sendgo-rails 젬 버전
-    VERSION = "1.2.1"
+    VERSION = "1.3.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendgo-rails
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Sendgo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-14 00:00:00.000000000 Z
+date: 2026-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sendgo
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement