sendgo-rails 1.2.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96f0416d41e80b4e8769d96d6bdd07978f0d0ff85541226500a5f0625b01d536
-  data.tar.gz: 5c54d373690e8cef8ccf156ac7d999a846b4949267f602c188a5e40271cb922a
+  metadata.gz: db269ad58d31692763ef2272064c76b0d48d96ab4def0b3423b14fee953f64d0
+  data.tar.gz: 2c6a3a6284b5312d717a4903ef4bb945187177d59967d339b119d7dae755ccbc
 SHA512:
-  metadata.gz: fb1be21e7e857a437c268133e5d1d1350ab9d2575acad49af25380b87cbbe7522f190aeffd198ac5f73bba45d670e87d9e7824316c43b46401455a22296c5551
-  data.tar.gz: 4d9fd443c69917a6cc7aa3e97825b57daee20662792095e6193c1f2bac757dfde0fb6cafcc462ba6bf94b8d2964054cc178afd413e4fb99c1732954ac07cc493
+  metadata.gz: fa7a1c12c3465d1ad0013402b6f1e92eea7ae85cefc84ad5e07d8bc132ada65ae156770fe749cc248ce3a823cbd2eadc36dde2cc811d687527ea07afd41afb0f
+  data.tar.gz: 6c5415d26b8f007e5bbf45ee71c4c64c0e0f754cd71de1cd57ca38d02c7dade895118d038b37d9b82825edb5a0e88971d4465c77d9d6dc5610d08337995af40d

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)
 
 - 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.
@@ -366,3 +476,25 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 Rails, 카카오 친구톡 Rails, SMS 발송 Rails, 알림톡 Rails gem, Rails 카카오 API 연동, Rails Railtie, Sendgo Rails SDK*
+
+## 계정 API (1.4.0)
+
+코어 1.4.0의 계정·조직·API 키·허용 IP 관리 12개 API를 사용할 수 있습니다.
+발송용 키 없이 에이전트 토큰만으로 구성할 수 있습니다.
+
+발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
+콘솔에서 발급받은 에이전트 토큰(`SENDGO_AGENT_TOKEN`)으로 `/api/v2/account`를 호출합니다.
+계정 조회에는 `account:read`, 키·허용 IP 변경에는 `keys:write` 권한이 필요합니다.
+토큰 만료나 권한 부족(401/403)은 그대로 예외로 반환하며 자동 갱신·재시도하지 않습니다.
+
+조직 선택은 서버에 저장되는 **사용자 계정의 현재 조직**을 바꿉니다. 같은 사용자로
+여러 조직의 설정을 동시에 변경하지 마세요. 개인 계정으로 돌아가려면 조직 ID에
+`null`(Python `None`, Ruby `nil`, Go `nil`) 또는 `personal`을 전달합니다.
+키 발급 응답의 `data.apiKey.secretKey`는 한 번만 반환되므로 서버의 비밀 저장소에 보관하세요.
+허용 IP가 하나라도 등록되면 목록 밖의 IP는 차단됩니다.
+에이전트 토큰과 키는 브라우저·모바일 앱에 포함하거나 응답·로그에 출력하지 않습니다.
+
+```ruby
+# SENDGO_AGENT_TOKEN 또는 config.sendgo.agent_token을 설정합니다.
+status = Sendgo::Rails.account_client.me
+```

data/lib/sendgo/rails/version.rb

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

data/lib/sendgo/rails.rb

@@ -33,6 +33,14 @@ module Sendgo
         @client ||= build_client
       end
 
+      # 발송용 키 없이 계정 클라이언트를 만듭니다.
+      def account_client
+        Sendgo::AccountClient.new(
+          agent_token: config_value(:agent_token, "SENDGO_AGENT_TOKEN"),
+          base_url: config_value(:url, "SENDGO_URL") || "https://sendgo.io"
+        )
+      end
+
       # 메모이즈된 클라이언트를 초기화한다. (주로 테스트에서 사용)
       #
       # @return [void]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendgo-rails
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Sendgo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-14 00:00:00.000000000 Z
+date: 2026-09-22 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.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement