sendgo 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4931577496e9234373f7658f0492d1870cd947ed6d4bc1b554c6408cd509474
-  data.tar.gz: 907c69a850ea3d3f766762b5432ec88aee3235e0749ecf2510c1f6b7c4a7a2df
+  metadata.gz: e838cbd6f30a61b781b74b37eb2a088710b8a6a41594b0fcbd6eb2a874dd2849
+  data.tar.gz: ca411988c2a81bc7957a339690392a8de14b1b0e710332305787be9a65f23302
 SHA512:
-  metadata.gz: d84d2b4543c3ae6a284a50a506e8ff355a89bfa7ec7cea03b2c412980b472687eb28fe09d9c70e8652ec8843cdcda6978b2fcd835c392f9ab0b27171320e59f3
-  data.tar.gz: 491cf6a525fb6423a1a314203af5fa412f3b331d7cfe58c5b13089c465a7083aa6bcd35e99f1c65a79aa270e6c6965d8a11628314b3cf933d477f0e2d03690f2
+  metadata.gz: a1d58de2204cb3471c287a8f4485a54cf53100b8267585e7189632883d2542cc4a5a293cce5a33c9351bfd74fcf84066e27510caba6bb5d61e784f7592c03911
+  data.tar.gz: 90d2b439c9f969a1d13bb302694cdc6b3f0a9b01466f2b7488aa25c286a0bada3b96c3f709cdad680296e2d6e1256a753e217e6ba875fd2f0f39f70e57b42ba7

data/README.md

@@ -360,8 +360,290 @@ sendgo.short_url.deactivate(code)   # 리다이렉트만 중지, 통계는 남
 `stats` 는 일별 추이(`daily`)와 디바이스(`byDevice`)·유입경로(`byReferer`)·국가(`byCountry`)별
 분해를 반환합니다. 일별 추이는 사전 집계 표에서 읽으므로 클릭이 많아도 응답 시간이 일정합니다.
 
+## 관리 API — 채널·템플릿·발신번호 등록 (v2 전용)
+
+발송은 처음부터 API였지만 **등록과 심사는 콘솔에서만** 되던 것들이 있었습니다.
+1.3.0 부터 그 작업도 코드로 처리합니다.
+
+| 서비스 | 하는 일 | 계정 |
+| --- | --- | --- |
+| `client.kakao_senders` | 카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청 | 기업 |
+| `client.notice_templates` | 알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제 | 기업 |
+| `client.brand_templates` | 브랜드메시지(구 친구톡) 템플릿 CRUD, 동기화, 가져오기 | 기업 |
+| `client.sender_registration` | 발신번호 등록 신청, 중복 확인, 유형 안내 | 개인·기업 |
+| `client.message_templates` | 문자 상용구 템플릿 CRUD | 개인·기업 |
+| `client.kakao_images` | 카카오 이미지 업로드 — 템플릿용 URL 발급 | 기업 |
+| `client.rejected_numbers` | 수신거부(080) 번호 조회 | 개인·기업 |
+| `client.webhook` | 이벤트 웹훅 구독 — 심사 결과 수신 | 개인·기업 |
+
+> **sendgo.io 콘솔에 들어올 일이 없습니다.** 고객의 채널·발신번호·템플릿을
+> 여러분 화면만으로 끝까지 처리할 수 있습니다. 휴대폰 발신번호는 콘솔의 PASS
+> 본인인증 대신 **신분증 사본(`identityDocument`)을 받아 sendgo 운영자가 대신
+> 심사**합니다.
+>
+> 사람이 개입하는 지점은 **카카오 채널 인증번호 하나**뿐이고, 그마저도
+> 여러분 화면에서 입력받으면 됩니다 — 카카오가 관리자 휴대폰으로 직접 보내는
+> 확인이라 없앨 수 없습니다.
+>
+> 심사가 붙는 것들은 **비동기**입니다. 등록 호출이 성공했다는 건 "접수됐다"는
+> 뜻이지 "쓸 수 있다"는 뜻이 아닙니다 — 웹훅을 구독해 결과를 받으세요.
+
+인자는 snake_case 로 씁니다 — SDK 가 camelCase 로 변환해 보냅니다.
+
+### 카카오 채널 등록
+
+```ruby
+# 1단계 — 카카오가 관리자 휴대폰으로 인증번호를 SMS 발송한다 (응답에 번호는 없다)
+client.kakao_senders.request_token("@my-channel", "01012345678")
+
+# 2단계 — 사람이 받은 인증번호로 발신프로필 생성
+created = client.kakao_senders.create(
+  token: "123456",
+  yellow_id: "@my-channel",
+  phone_number: "01012345678",
+  category_code: "001001"      # categories 로 조회
+)
+
+kakao_sender_key = created.dig("data", "sender", "kakaoSenderKey")
+
+client.kakao_senders.categories
+client.kakao_senders.list
+client.kakao_senders.sync                    # 전체 상태 동기화 (하루 한 번 권장)
+client.kakao_senders.sync(kakao_sender_key)  # 단건
+```
+
+채널이 카카오 쪽에서 차단되면 발송이 조용히 실패하기 시작합니다. `sync` 를
+주기적으로 돌리고 `block: true` 인 채널을 감시하세요.
+
+### 알림톡 템플릿 등록과 검수
+
+```ruby
+created = client.notice_templates.create(
+  kakao_sender_key: kakao_sender_key,
+  template_name: "주문 접수 안내",
+  template_content: "\#{name}님, 주문 \#{orderNo}이 접수되었습니다.",
+  template_message_type: "BA",       # BA 기본형 / EX 부가정보형 / AD 채널추가형 / MI 복합형
+  template_emphasize_type: "NONE",   # NONE / TEXT / ITEM_LIST / IMAGE
+  category_code: "001001",
+
+  # sendgo 자체 정책 게이트 — 카카오 심사와 별개다
+  message_purpose: "order_delivery",
+  legal_basis: "transaction",
+  benefit_origin: "none",
+  expiry_type: "none",
+
+  # 선택 필드는 그냥 이어서 쓰면 된다 (snake_case → camelCase 자동 변환)
+  buttons: [{ name: "주문 조회", linkType: "WL", linkMo: "https://example.com/orders" }]
+)
+
+template_code = created.dig("data", "template", "templateCode")
+
+# 검수 요청 — 증빙이 필요하면 파일도 붙인다 (첨부가 있으면 comment 필수)
+client.notice_templates.request_inspection(template_code)
+
+File.open("proof.png", "rb") do |f|
+  client.notice_templates.request_inspection(
+    template_code,
+    comment: "주문 확인 화면 첨부",
+    attachments: [["proof.png", f, "image/png"]]
+  )
+end
+
+# 결과는 비동기다. 웹훅이 없으므로 폴링한다
+synced = client.notice_templates.sync(template_code)
+synced.dig("data", "template", "inspectionStatus")   # REG → REQ → APR / REJ
+```
+
+`opt_in_review_confirmed` · `cta_clear_confirmed` · `policy_confirmed` 는 기본값이
+`true` 지만, **내용을 실제로 검토한 뒤에** 그대로 두어야 합니다 — 이 값은 법적
+확인의 기록입니다.
+
+정책 필드 조합이 본문과 어긋나면 저장 단계에서 `POLICY_VALIDATION_FAILED` 로
+막힙니다. 예외의 `errors["reasons"]` 에 사유가 한국어로 담기니 그대로 사용자에게
+보여 주면 됩니다. 여기서 걸리는 문안은 **카카오 심사에서도 거의 반려**되므로,
+며칠 기다렸다 반려당하는 것보다 즉시 아는 편이 낫습니다.
+
+```ruby
+client.notice_templates.list(kakao_sender_key: kakao_sender_key, inspection_status: "APR")
+client.notice_templates.show(template_code)
+client.notice_templates.update(template_code, template_content: "...")  # 본문이 바뀌면 재검수 필요
+client.notice_templates.cancel_inspection(template_code)
+client.notice_templates.cancel_approval(template_code)
+client.notice_templates.release(template_code)   # 휴면 해제
+client.notice_templates.delete(template_code)    # sendgo 목록에서만 삭제된다
+client.notice_templates.categories
+```
+
+이미지 템플릿은 `image:` 로 파일을 넘기면 multipart 로 나갑니다.
+
+```ruby
+File.open("banner.jpg", "rb") do |f|
+  client.notice_templates.create(
+    kakao_sender_key: kakao_sender_key,
+    template_name: "이벤트 안내",
+    template_emphasize_type: "IMAGE",
+    image: ["banner.jpg", f, "image/jpeg"],
+    # ... 나머지 필드 동일
+  )
+end
+```
+
+> **삭제 동작이 채널마다 다릅니다.** 알림톡 템플릿은 카카오에 삭제 API 가 없어
+> sendgo 목록에서만 빠지고 동기화하면 되살아납니다. 브랜드메시지 템플릿은
+> 카카오 쪽에서도 실제로 삭제됩니다.
+
+### 브랜드메시지 템플릿
+
+```ruby
+created = client.brand_templates.create(
+  kakao_sender_key: kakao_sender_key,
+  template_name: "여름 세일 안내",
+  template_type: "FI",              # FT/FI/FW/FL/FC/FM/FP/FA — 서버가 chatBubbleType 으로 변환
+  template_content: "여름 세일이 시작되었습니다.",
+  image_url: "https://mud-kage.kakao.com/....jpg"
+)
+
+# 동보 발송(targeting="F")에는 변수가 없는 템플릿만 쓸 수 있다
+created.dig("data", "template", "containsVariables")
+
+client.brand_templates.list(kakao_sender_key: kakao_sender_key)
+client.brand_templates.sync(template_code)
+client.brand_templates.import(kakao_sender_key)   # 카카오에 있는 템플릿 가져오기
+client.brand_templates.delete(template_code)      # 카카오에서도 삭제된다
+```
+
+### 발신번호 등록 신청
+
+```ruby
+# 계정 종류에 맞는 유형과 유형별 필수 서류
+client.sender_registration.number_types
+
+# 형식·중복 미리 확인
+check = client.sender_registration.validate("02-1234-5678", "team_main")
+
+File.open("csu.pdf", "rb") do |f|
+  created = client.sender_registration.create(
+    sender_alias: "고객센터 대표번호",
+    sender_number_type: "team_main",   # personal_other / team_main / team_other_company
+    phone_e164: "02-1234-5678",
+    files: { csuCertificate: ["csu.pdf", f, "application/pdf"] }
+    # check.dig("data", "duplicationReasonRequired") 가 true 면 필수
+    # duplication_reason: "부서별 분리 운영"
+  )
+
+  created.dig("data", "sender", "status")   # PENDING — 운영자 승인 후 SUCCESS
+end
+
+client.sender_registration.list
+client.sender_registration.update(sender_key, sender_alias: "새 이름")
+client.sender_registration.delete(sender_key)
+```
+
+**휴대폰 유형도 API 로 접수할 수 있습니다.** 콘솔의 PASS 본인인증 대신
+신분증 사본(`identityDocument`)을 첨부하면 sendgo 운영자가 직접 확인합니다.
+이 경로로 접수된 건은 응답의 `identityVerificationMethod` 가 `document` 이고
+**자동 승인되지 않습니다** — 운영자 확인 전까지 `PENDING` 입니다.
+
+유형별 필수 서류는 `numberTypes()` 응답의 `requiredDocuments` 로 확인하세요.
+반려되면 `rejectionReason` 에 사유가 담깁니다.
+
+### 문자 템플릿
+
+```ruby
+client.message_templates.create(
+  message_tran_type: "LMS",
+  message_tran_subject: "주문 안내",   # LMS·MMS 는 필수
+  message_tran_msg: "주문이 접수되었습니다."
+)
+
+client.message_templates.list(message_type: "LMS")
+client.message_templates.update(template_key, message_tran_msg: "...")
+client.message_templates.delete(template_key)
+```
+
+### 이벤트 웹훅 — 심사 결과를 밀어 받기
+
+```ruby
+created = client.webhook.subscribe("https://reseller.example.com/hooks/sendgo")
+
+# 시크릿은 이 응답에서 한 번만 나온다. 즉시 저장한다.
+secret = created.dig("data", "secret")
+
+client.webhook.show          # 구독 설정 + 마지막 전송 결과
+client.webhook.test          # 배선 확인
+client.webhook.unsubscribe
+```
+
+받는 쪽에서는 **원본 바이트**로 서명을 검증합니다.
+
+```ruby
+# Rails 라면 request.raw_post 가 원본이다. params 를 다시 인코딩하면 안 된다.
+raw = request.raw_post
+
+unless Sendgo::WebhookService.verify_signature(raw, request.headers["X-Sendgo-Signature"], secret)
+  head :unauthorized and return
+end
+
+payload = JSON.parse(raw)
+# payload["event"] — sender.status_changed / notice_template.inspection_status_changed / ...
+```
+
+이벤트 목록은 `Sendgo::WebhookService::EVENTS` 로 확인할 수 있습니다.
+
+### 카카오 이미지 업로드
+
+브랜드메시지 템플릿의 `imageUrl` 은 **카카오가 호스팅하는 URL** 이어야 합니다.
+
+```ruby
+uploaded = File.open("banner.jpg", "rb") do |f|
+  client.kakao_images.upload("default", ["banner.jpg", f, "image/jpeg"])
+end
+
+client.brand_templates.create(
+  kakao_sender_key: kakao_sender_key,
+  template_name: "여름 세일 안내",
+  template_type: "FI",
+  image_url: uploaded.dig("data", "imageUrl")
+)
+
+client.kakao_images.upload_many("carousel_feed", slides)
+client.kakao_images.types   # 유형별 필드·최대 개수
+```
+
+### 수신거부(080) 동기화
+
+```ruby
+# 증분만 가져간다. 하루 한 번이면 충분하다.
+client.rejected_numbers.list(since: "2026-09-01", count: 500)
+```
+
+---
+
 ## 변경 사항
 
+### 1.3.0 (2026-09-11)
+
+- **관리 API 추가** — 콘솔에서만 되던 등록·심사를 코드로 처리합니다.
+  `client.kakao_senders`(채널 인증·등록·동기화, 브랜드메시지 M/N 신청),
+  `client.notice_templates`(알림톡 템플릿 CRUD·검수 요청·승인 취소·휴면 해제),
+  `client.brand_templates`(브랜드메시지 템플릿 CRUD·동기화·가져오기),
+  `client.sender_registration`(발신번호 등록 신청·중복 확인·유형 안내),
+  `client.message_templates`(문자 상용구 템플릿 CRUD).
+- `HttpClient` 에 `put`·`patch`·`post_multipart` 를 추가했습니다.
+  서류 첨부와 이미지 템플릿은 JSON 으로 보낼 수 없습니다.
+- **`request` 가 PUT/PATCH 를 POST 로 보내던 문제를 함께 고쳤습니다.**
+  `case method` 의 `else` 분기가 전부 `Net::HTTP::Post` 를 만들고 있어,
+  새 메서드를 그냥 얹었다면 405 만 받았을 자리입니다.
+- **휴대폰 발신번호도 API 로 접수됩니다.** 콘솔의 PASS 본인인증 대신
+  `identityDocument`(신분증 사본)를 첨부하면 sendgo 운영자가 확인합니다.
+  이 경로는 자동 승인되지 않고 항상 `PENDING` 으로 시작합니다.
+- **이벤트 웹훅** 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단,
+  브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로
+  검증합니다(SDK 에 검증 헬퍼 포함).
+- **카카오 이미지 업로드** 추가 — 브랜드메시지 템플릿의 `imageUrl` 은 카카오가
+  호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다.
+- **수신거부(080) 조회** 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.
+
 ### 1.2.1 (2026-08-14)
 
 - 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.

data/lib/sendgo/client.rb

@@ -14,6 +14,14 @@ module Sendgo
     # friendtalk: @deprecated 2025-12-31 종료. brand_message 를 사용하세요.
     attr_reader :alimtalk, :friendtalk, :brand_message, :short_url, :sms
 
+    # 관리 API (v2 전용) — 콘솔에서만 되던 등록·심사.
+    # 발송과 달리 대부분 즉시 완료되지 않는다 — 등록 성공은 "접수됨"이지
+    # "사용 가능"이 아니다. 카카오 채널 등록의 인증번호와 휴대폰 발신번호의
+    # 본인인증은 사람이 개입해야 하므로 API 로 대체되지 않는다.
+    attr_reader :kakao_senders, :notice_templates, :brand_templates,
+                :sender_registration, :message_templates,
+                :kakao_images, :rejected_numbers, :webhook
+
     def initialize(access_key:, secret_key:, kakao_sender_key: nil, sms_sender_key: nil,
                    api_version: "v1", base_url: "https://sendgo.io")
       raise ArgumentError, "access_key와 secret_key는 필수입니다" if access_key.nil? || secret_key.nil?
@@ -28,6 +36,15 @@ module Sendgo
       # 짧은 URL — 링크 단축과 클릭 반응 분석. v2 전용.
       @short_url  = ShortUrlService.new(http: http)
       @sms        = SmsService.new(http: http, sms_sender_key: sms_sender_key)
+
+      @kakao_senders       = KakaoSenderService.new(http: http)
+      @notice_templates    = NoticeTemplateService.new(http: http)
+      @brand_templates     = BrandTemplateService.new(http: http)
+      @sender_registration = SenderRegistrationService.new(http: http)
+      @message_templates   = MessageTemplateService.new(http: http)
+      @kakao_images        = KakaoImageService.new(http: http)
+      @rejected_numbers    = RejectedNumberService.new(http: http)
+      @webhook             = WebhookService.new(http: http)
     end
   end
 end

data/lib/sendgo/http_client.rb

@@ -1,6 +1,7 @@
 require "net/http"
 require "json"
 require "base64"
+require "securerandom"
 
 module Sendgo
   # Sendgo API HTTP 클라이언트.
@@ -21,11 +22,31 @@ module Sendgo
       request(:get, path, params: params, is_retry: false)
     end
 
+    def put(path, body)
+      request(:put, path, body: body, is_retry: false)
+    end
+
+    def patch(path, body)
+      request(:patch, path, body: body, is_retry: false)
+    end
+
     # DELETE 요청. 짧은 URL 리다이렉트 중지에서 사용한다.
     def delete(path)
       request(:delete, path, is_retry: false)
     end
 
+    # multipart/form-data POST — 서류·이미지 첨부가 있는 관리 API 전용.
+    #
+    # 발신번호 등록과 이미지 템플릿은 JSON 으로 보낼 수 없다. multipart 에는
+    # 배열도 불리언도 없으므로, Array/Hash 값은 JSON 문자열로 눌러 보낸다 —
+    # 서버가 그렇게 받아 읽는다.
+    #
+    # files 는 { 필드명 => [파일명, IO 또는 문자열, content_type] } 형태다.
+    # 같은 필드에 여러 파일을 붙이려면 배열로 넘긴다.
+    def post_multipart(path, fields = {}, files = {})
+      multipart_request(path, fields, files, is_retry: false)
+    end
+
     private
 
     def request(method, path, body: nil, params: nil, is_retry: false)
@@ -46,7 +67,16 @@ module Sendgo
           # 바디 없는 DELETE. Post 분기로 흘러가면 조용히 POST 로 나간다.
           Net::HTTP::Delete.new(uri)
         else
-          Net::HTTP::Post.new(uri).tap do |r|
+          # PUT/PATCH 도 여기서 잡는다. 클래스를 고르지 않고 else 로 흘리면
+          # 전부 POST 로 나가서, 서버는 라우트를 못 찾고 405 를 준다.
+          klass =
+            case method
+            when :put   then Net::HTTP::Put
+            when :patch then Net::HTTP::Patch
+            else Net::HTTP::Post
+            end
+
+          klass.new(uri).tap do |r|
             r["Content-Type"] = "application/json"
             r.body = body.to_json
           end
@@ -71,6 +101,123 @@ module Sendgo
       resp_body
     end
 
+    # 파일 내용을 미리 읽어 둔다. IO 는 한 번 소진되면 되감을 수 없어,
+    # 그러지 않으면 토큰 갱신 후 재시도가 빈 파일을 올린다.
+    def multipart_request(path, fields, files, is_retry:)
+      parts = []
+
+      fields.each do |name, value|
+        next if value.nil?
+
+        encoded =
+          case value
+          when true  then "1"
+          when false then "0"
+          when Array, Hash then JSON.generate(value)
+          else value.to_s
+          end
+
+        parts << [:field, name.to_s, encoded]
+      end
+
+      files.each do |name, file|
+        next if file.nil?
+
+        # 파일 하나는 IO 이거나 [filename, io, content_type] 튜플이고,
+        # 여러 개는 그 튜플들의 배열이다. 이 둘을 구분하지 않으면 튜플
+        # 하나를 원소 세 개로 잘못 훑는다.
+        entries = multiple_files?(file) ? file : [file]
+
+        entries.each_with_index do |entry, index|
+          # 여러 개면 서버가 attachments[0] 형태를 기대한다.
+          field_name = entries.length > 1 || multiple_files?(file) ? "#{name}[#{index}]" : name.to_s
+          filename, io, content_type = normalize_file(entry)
+          parts << [:file, field_name, filename, read_all(io), content_type]
+        end
+      end
+
+      send_multipart(path, parts, is_retry: is_retry)
+    end
+
+    # 파일 목록인지 단일 파일 튜플인지 판별한다.
+    def multiple_files?(file)
+      file.is_a?(Array) && (file.first.is_a?(Array) || file.first.respond_to?(:read))
+    end
+
+    def normalize_file(entry)
+      case entry
+      when Array
+        filename, io, content_type = entry
+        [filename, io, content_type || "application/octet-stream"]
+      else
+        filename = entry.respond_to?(:path) ? File.basename(entry.path) : "upload"
+        [filename, entry, "application/octet-stream"]
+      end
+    end
+
+    def read_all(io)
+      io.respond_to?(:read) ? io.read : io.to_s
+    end
+
+    def send_multipart(path, parts, is_retry:)
+      token    = @token_manager.get_token
+      boundary = "----SendgoBoundary#{SecureRandom.hex(12)}"
+      body     = build_multipart_body(parts, boundary)
+      uri      = URI("#{@base_url}/api/#{@api_version}/#{path}")
+
+      req = Net::HTTP::Post.new(uri)
+      req["Content-Type"]  = "multipart/form-data; boundary=#{boundary}"
+      req["Accept"]        = "application/json"
+      req["Authorization"] = bearer_auth(token)
+      req.body = body
+
+      # 파일 업로드는 JSON 요청보다 오래 걸린다.
+      resp = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
+                             read_timeout: 60, open_timeout: 10) { |h| h.request(req) }
+
+      resp_body = JSON.parse(resp.body) rescue {}
+
+      unless resp.is_a?(Net::HTTPSuccess)
+        error_code = resp_body["code"]
+        endpoint   = path.split("/").last
+        if !is_retry && @token_manager.should_refresh?(resp.code.to_i, error_code)
+          @token_manager.invalidate
+          return send_multipart(path, parts, is_retry: true)
+        end
+        raise SendgoError.from_response(resp.code.to_i, resp_body, endpoint, @api_version)
+      end
+
+      resp_body
+    end
+
+    # 버퍼를 처음부터 BINARY 로 만들고 붙이는 조각마다 `.b` 를 건다.
+    #
+    # UTF-8 버퍼에 파일 바이트(ASCII-8BIT)를 붙이면, 앞서 넣은 필드 값에
+    # 한글이 하나라도 있는 순간 Encoding::CompatibilityError 로 죽는다.
+    # 발신번호 등록은 별칭이 한글이고 서류는 PDF 라 항상 그 조합이다.
+    def build_multipart_body(parts, boundary)
+      body = +"".b
+
+      parts.each do |part|
+        body << "--#{boundary}\r\n".b
+
+        if part[0] == :field
+          _, name, value = part
+          body << %(Content-Disposition: form-data; name="#{name}"\r\n\r\n).b
+          body << "#{value}\r\n".b
+        else
+          _, name, filename, content, content_type = part
+          body << %(Content-Disposition: form-data; name="#{name}"; filename="#{filename}"\r\n).b
+          body << "Content-Type: #{content_type}\r\n\r\n".b
+          body << content.to_s.b
+          body << "\r\n".b
+        end
+      end
+
+      body << "--#{boundary}--\r\n".b
+      body
+    end
+
     def bearer_auth(token)
       return "Bearer #{token}" if @api_version == "v2"
       "Bearer #{Base64.strict_encode64(token)}"

data/lib/sendgo/management.rb

@@ -0,0 +1,596 @@
+# frozen_string_literal: true
+
+require "cgi"
+require "openssl"
+
+module Sendgo
+  # 카카오 발신프로필(채널) 관리 — 등록 · 동기화 · 브랜드메시지 타겟팅 신청.
+  #
+  # v2 전용이며 **기업(Team) 소유 애플리케이션**만 사용할 수 있다.
+  #
+  # 채널 등록은 두 단계다. 카카오가 인증번호를 채널 관리자 **휴대폰으로 SMS
+  # 발송**하므로 완전 무인 자동화는 불가능하다 — 사람이 문자를 받아
+  # +create+ 에 넣어야 한다.
+  #
+  # @example
+  #   # 1단계 — 관리자 휴대폰으로 인증번호 발송 (응답에 번호는 없다)
+  #   client.kakao_senders.request_token("@my-channel", "01012345678")
+  #
+  #   # 2단계 — 사람이 받은 인증번호로 발신프로필 생성
+  #   created = client.kakao_senders.create(
+  #     token: "123456",
+  #     yellow_id: "@my-channel",
+  #     phone_number: "01012345678",
+  #     category_code: "001001"
+  #   )
+  #
+  #   kakao_sender_key = created.dig("data", "sender", "kakaoSenderKey")
+  class KakaoSenderService
+    RESOURCE = "kakao-senders"
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 1단계 — 채널 인증번호 발송.
+    #
+    # 응답에 인증번호는 들어있지 않다. 카카오가 +phone_number+ 로 SMS 를 보낸다.
+    def request_token(yellow_id, phone_number)
+      @http.post("#{RESOURCE}/token", { yellowId: yellow_id, phoneNumber: phone_number })
+    end
+
+    # 2단계 — 발신프로필 등록.
+    #
+    # 이미 등록된 채널을 다시 등록해도 오류가 아니다. 카카오가 같은 senderKey 를
+    # 돌려주고 서버가 기존 행을 갱신한다.
+    def create(token:, yellow_id:, phone_number:, category_code:)
+      @http.post(RESOURCE, {
+                   token: token,
+                   yellowId: yellow_id,
+                   phoneNumber: phone_number,
+                   categoryCode: category_code
+                 })
+    end
+
+    # 목록 조회.
+    def list
+      @http.get(RESOURCE)
+    end
+
+    # 상세 조회.
+    def show(kakao_sender_key)
+      @http.get("#{RESOURCE}/#{CGI.escape(kakao_sender_key)}")
+    end
+
+    # 카테고리 조회. 등록 시 +category_code+ 로 넣을 값이다.
+    def categories(category_code = nil)
+      @http.get("#{RESOURCE}/categories", { categoryCode: category_code })
+    end
+
+    # 상태 동기화. 키를 주면 단건, 없으면 팀 전체.
+    #
+    # 채널이 카카오 쪽에서 차단·휴면되면 발송이 조용히 실패하기 시작한다.
+    # 그 사실을 먼저 알 방법은 이 호출뿐이므로 하루 한 번 정도 돌리는 게 좋다.
+    def sync(kakao_sender_key = nil)
+      path = kakao_sender_key ? "#{RESOURCE}/#{CGI.escape(kakao_sender_key)}/sync" : "#{RESOURCE}/sync"
+      @http.post(path, {})
+    end
+
+    # 브랜드메시지 M 신청에 필요한 광고성 정보 수신동의 증적자료 업로드.
+    # jpg/png, 5MB 이하.
+    #
+    # @param evidence [Array, IO] +["proof.png", io, "image/png"]+ 또는 열린 파일
+    def upload_brand_message_evidence(kakao_sender_key, evidence)
+      @http.post_multipart(
+        "#{RESOURCE}/#{CGI.escape(kakao_sender_key)}/brand-message/evidence",
+        {},
+        { evidence: evidence }
+      )
+    end
+
+    # 브랜드메시지 +M+(마케팅) / +N+(정보성) 사용 신청.
+    #
+    # 결과는 즉시 확정되지 않는다. 발신프로필의 +brandMessageStatus+ 로 확인한다.
+    def apply_brand_message_targeting(kakao_sender_key, target_type)
+      @http.post(
+        "#{RESOURCE}/#{CGI.escape(kakao_sender_key)}/brand-message/apply",
+        { targetType: target_type }
+      )
+    end
+  end
+
+  # 알림톡 템플릿 관리 — 등록 · 수정 · 검수 요청.
+  #
+  # v2 전용이며 **기업(Team) 소유 애플리케이션**만 사용할 수 있다.
+  #
+  # 템플릿은 만든 즉시 쓸 수 없다. 카카오 검수를 통과해야 한다.
+  #
+  #   등록      inspectionStatus=REG   ← 발송 불가
+  #   검수 요청  inspectionStatus=REQ   ← 카카오 심사 중
+  #   승인      inspectionStatus=APR   ← 여기부터 발송 가능
+  #   반려      inspectionStatus=REJ   ← comments 에 사유
+  #
+  # 검수 결과는 비동기다. 웹훅이 없으므로 +sync+ 로 폴링한다.
+  class NoticeTemplateService
+    RESOURCE = "notice-templates"
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 목록 조회.
+    def list(kakao_sender_key: nil, inspection_status: nil, search: nil, count: nil)
+      @http.get(RESOURCE, {
+                  kakaoSenderKey: kakao_sender_key,
+                  inspectionStatus: inspection_status,
+                  search: search,
+                  count: count
+                })
+    end
+
+    # 상세 조회. 응답의 +data.template.policy+ 에 정책 검토 상태가 들어 있다.
+    def show(template_code)
+      @http.get(path(template_code))
+    end
+
+    # 템플릿 등록.
+    #
+    # 정책 인자 일곱 개는 sendgo 자체 게이트다. 카카오 심사와 별개이며 조합이
+    # 본문과 어긋나면 +POLICY_VALIDATION_FAILED+ 로 거절된다. 확인 플래그 셋은
+    # 기본값이 +true+ 지만, **내용을 실제로 검토한 뒤에** 그대로 두어야 한다 —
+    # 이 값은 법적 확인의 기록이다.
+    #
+    # 선택 필드(+templateTitle+, +buttons+ 등)는 +extra+ 로 넘긴다.
+    # +image+ 를 주면 이미지 템플릿으로 multipart 전송한다.
+    def create(kakao_sender_key:, template_name:, template_content:,
+               template_message_type:, template_emphasize_type:, category_code:,
+               message_purpose:, legal_basis:, benefit_origin:, expiry_type:,
+               opt_in_review_confirmed: true, cta_clear_confirmed: true,
+               policy_confirmed: true, image: nil, **extra)
+      body = {
+        kakaoSenderKey: kakao_sender_key,
+        templateName: template_name,
+        templateContent: template_content,
+        templateMessageType: template_message_type,
+        templateEmphasizeType: template_emphasize_type,
+        categoryCode: category_code,
+        messagePurpose: message_purpose,
+        legalBasis: legal_basis,
+        benefitOrigin: benefit_origin,
+        expiryType: expiry_type,
+        optInReviewConfirmed: opt_in_review_confirmed,
+        ctaClearConfirmed: cta_clear_confirmed,
+        policyConfirmed: policy_confirmed
+      }.merge(camelize_keys(extra))
+
+      return @http.post_multipart(RESOURCE, body, { image: image }) if image
+
+      @http.post(RESOURCE, body)
+    end
+
+    # 템플릿 수정.
+    #
+    # 발신프로필과 템플릿 코드는 바꿀 수 없다. 본문·버튼처럼 카카오에 등록된
+    # 내용이 바뀌면 검수 상태가 되돌아가므로 재검수를 요청해야 한다.
+    def update(template_code, **fields)
+      @http.put(path(template_code), camelize_keys(fields))
+    end
+
+    # 템플릿 삭제.
+    #
+    # **카카오는 템플릿 삭제 API 를 제공하지 않는다.** sendgo 목록에서만
+    # 지워지고 비즈니스 채널 쪽 템플릿은 남는다. 동기화하면 다시 나타난다.
+    def delete(template_code)
+      @http.delete(path(template_code))
+    end
+
+    # 카카오에서 검수 상태와 반려 사유를 다시 읽어 온다.
+    def sync(template_code)
+      @http.post("#{path(template_code)}/sync", {})
+    end
+
+    # 검수 요청.
+    #
+    # 첨부가 있으면 +comment+ 는 필수다. 정책 검토를 통과하지 못한 템플릿은
+    # +POLICY_REVIEW_REQUIRED+ 로 거절되고 +errors.reasons+ 에 사유가 담긴다.
+    def request_inspection(template_code, comment: nil, attachments: nil)
+      endpoint = "#{path(template_code)}/inspection"
+
+      if attachments.nil? || attachments.empty?
+        body = comment ? { comment: comment } : {}
+        return @http.post(endpoint, body)
+      end
+
+      @http.post_multipart(endpoint, { comment: comment }, { attachments: attachments })
+    end
+
+    # 검수 요청 취소. 아직 심사 중(+REQ+)일 때만 통한다.
+    def cancel_inspection(template_code)
+      @http.delete("#{path(template_code)}/inspection")
+    end
+
+    # 승인 취소. 승인(+APR+)된 템플릿을 되돌린다. 이후에는 발송할 수 없다.
+    def cancel_approval(template_code)
+      @http.delete("#{path(template_code)}/approval")
+    end
+
+    # 휴면 해제. 오래 안 쓴 템플릿이 dormant 로 잠기면 이걸로 깨운다.
+    def release(template_code)
+      @http.post("#{path(template_code)}/release", {})
+    end
+
+    # 템플릿 카테고리 코드 조회.
+    def categories(category_code = nil)
+      @http.get("#{RESOURCE}/categories", { categoryCode: category_code })
+    end
+
+    private
+
+    def path(template_code)
+      "#{RESOURCE}/#{CGI.escape(template_code)}"
+    end
+
+    def camelize_keys(hash)
+      Sendgo.camelize_keys(hash)
+    end
+  end
+
+  # 브랜드메시지(구 친구톡) 템플릿 관리.
+  #
+  # v2 전용이며 **기업(Team) 소유 애플리케이션**만 사용할 수 있다.
+  # 알림톡 템플릿과 달리 **검수 요청 단계가 없다.**
+  #
+  # +template_type+ 은 친구톡 표기(FT/FI/FW/FL/FC/FM/FP/FA)를 그대로 쓴다 —
+  # 서버가 chatBubbleType 으로 변환한다.
+  class BrandTemplateService
+    RESOURCE = "brand-templates"
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 목록 조회.
+    def list(kakao_sender_key: nil, search: nil, count: nil)
+      @http.get(RESOURCE, { kakaoSenderKey: kakao_sender_key, search: search, count: count })
+    end
+
+    # 상세 조회. sendgo 코드(+KFT-...+)와 카카오 브랜드 템플릿 코드 둘 다 받는다.
+    def show(template_code)
+      @http.get(path(template_code))
+    end
+
+    # 템플릿 등록. 선택 필드는 +extra+ 로 넘긴다 (snake_case 자동 변환).
+    def create(kakao_sender_key:, template_name:, template_type:, **extra)
+      @http.post(RESOURCE, {
+                   kakaoSenderKey: kakao_sender_key,
+                   templateName: template_name,
+                   templateType: template_type
+                 }.merge(Sendgo.camelize_keys(extra)))
+    end
+
+    # 템플릿 수정. 발신프로필은 바꿀 수 없다.
+    def update(template_code, **fields)
+      @http.put(path(template_code), Sendgo.camelize_keys(fields))
+    end
+
+    # 템플릿 삭제. 알림톡과 달리 카카오 쪽에서도 실제로 삭제된다.
+    def delete(template_code)
+      @http.delete(path(template_code))
+    end
+
+    # 동기화. 카카오 쪽에서 이미 삭제됐으면 로컬에서도 제거하고
+    # +data.deleted: true+ 를 반환한다.
+    def sync(template_code)
+      @http.post("#{path(template_code)}/sync", {})
+    end
+
+    # 발신프로필 단위 가져오기 — 카카오 쪽에 이미 있는 템플릿을 들여온다.
+    def import(kakao_sender_key)
+      @http.post("#{RESOURCE}/import", { kakaoSenderKey: kakao_sender_key })
+    end
+
+    private
+
+    def path(template_code)
+      "#{RESOURCE}/#{CGI.escape(template_code)}"
+    end
+  end
+
+  # 발신번호(문자) 등록 · 심사 접수.
+  #
+  # v2 전용. 카카오와 달리 **개인 계정 애플리케이션도** 쓸 수 있다.
+  #
+  # 등록하면 곧바로 쓸 수 있는 게 아니라 +PENDING+ 으로 **접수**되고, 운영자
+  # 승인 후 +SUCCESS+ 가 된다.
+  class SenderRegistrationService
+    RESOURCE = "senders"
+
+    # API 로 접수할 수 있는 발신번호 유형 — 전부다.
+    REGISTRABLE_TYPES = %w[
+      personal_mobile
+      personal_other
+      team_main
+      team_representative_mobile
+      team_emp_mobile
+      team_other_company
+    ].freeze
+
+    # 신분증 사본(+identityDocument+)이 필요한 유형.
+    #
+    # 콘솔은 PASS 본인인증을 쓰지만 API 는 신분증 사본을 받아 sendgo 운영자가
+    # 직접 확인한다. 이 경로로 접수된 건은 자동 승인되지 않는다.
+    IDENTITY_DOCUMENT_TYPES = %w[personal_mobile team_representative_mobile team_emp_mobile].freeze
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 목록 조회. 심사 상태(+status+)를 여기서 확인한다.
+    def list
+      @http.get(RESOURCE)
+    end
+
+    # 상세 조회.
+    def show(sender_key)
+      @http.get("#{RESOURCE}/#{CGI.escape(sender_key)}")
+    end
+
+    # 계정 종류에 맞는 발신번호 유형과 유형별 필수 서류.
+    #
+    # 유형별 +identityVerification+(+none+/+document+)과 필요한 서류 목록을 준다.
+    def number_types
+      @http.get("#{RESOURCE}/number-types")
+    end
+
+    # 등록 전 형식·중복 확인.
+    #
+    # 응답의 +duplicationReasonRequired+ 가 true 면 +create+ 에
+    # +duplication_reason+ 을 함께 넣어야 한다.
+    def validate(phone_e164, sender_number_type)
+      @http.post("#{RESOURCE}/validate", { phoneE164: phone_e164, senderNumberType: sender_number_type })
+    end
+
+    # 등록 신청. 서류가 붙으므로 multipart 로 나간다.
+    #
+    # +files+ 에는 최소한 +csuCertificate+(통신서비스 이용증명원)가 있어야 한다.
+    # 휴대폰 계열은 +identityDocument+(신분증 사본)가, +team_other_company+ 는
+    # 수임·위임 서류가 더 필요하다 — {#number_types} 로 확인한다.
+    def create(sender_alias:, sender_number_type:, phone_e164:, files:, **extra)
+      fields = {
+        senderAlias: sender_alias,
+        senderNumberType: sender_number_type,
+        phoneE164: phone_e164
+      }.merge(Sendgo.camelize_keys(extra))
+
+      @http.post_multipart(RESOURCE, fields, files)
+    end
+
+    # 별칭 변경 / 기본 발신 지정. 번호와 심사 상태는 바꿀 수 없다.
+    def update(sender_key, sender_alias:, primary_type: nil)
+      body = { senderAlias: sender_alias }
+      body[:primaryType] = primary_type unless primary_type.nil?
+
+      @http.patch("#{RESOURCE}/#{CGI.escape(sender_key)}", body)
+    end
+
+    # 삭제. 기본 발신번호를 지우면 남은 번호 중 하나가 기본으로 승계된다.
+    def delete(sender_key)
+      @http.delete("#{RESOURCE}/#{CGI.escape(sender_key)}")
+    end
+  end
+
+  # 문자(SMS/LMS/MMS) 상용구 템플릿.
+  #
+  # v2 전용. 카카오 템플릿과 달리 **검수가 없어** 만들면 바로 쓸 수 있고,
+  # 기업 계정이 아니어도 된다.
+  class MessageTemplateService
+    RESOURCE = "message-templates"
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 목록 조회.
+    def list(message_type: nil, search: nil, count: nil)
+      @http.get(RESOURCE, { messageType: message_type, search: search, count: count })
+    end
+
+    # 상세 조회.
+    def show(template_key)
+      @http.get("#{RESOURCE}/#{CGI.escape(template_key)}")
+    end
+
+    # 등록. LMS·MMS 는 +message_tran_subject+ 가 필수다.
+    def create(message_tran_type:, message_tran_msg:, message_tran_subject: nil, is_favorite: false)
+      body = {
+        messageTranType: message_tran_type,
+        messageTranMsg: message_tran_msg,
+        isFavorite: is_favorite
+      }
+      body[:messageTranSubject] = message_tran_subject unless message_tran_subject.nil?
+
+      @http.post(RESOURCE, body)
+    end
+
+    # 수정.
+    def update(template_key, **fields)
+      @http.put("#{RESOURCE}/#{CGI.escape(template_key)}", Sendgo.camelize_keys(fields))
+    end
+
+    # 삭제 (소프트 삭제 — 목록에서만 사라진다).
+    def delete(template_key)
+      @http.delete("#{RESOURCE}/#{CGI.escape(template_key)}")
+    end
+  end
+
+  # Ruby 쪽 인자는 snake_case, Sendgo API 는 camelCase 다. 서비스마다 매핑을
+  # 손으로 적으면 필드가 늘 때마다 빠뜨리는 곳이 생기므로 한 곳에서 변환한다.
+  #
+  # +additional_content+ 는 서버가 그대로 받으므로 예외로 둔다.
+  KEEP_AS_IS_KEYS = %w[additional_content].freeze
+
+  def self.camelize_keys(hash)
+    hash.each_with_object({}) do |(key, value), result|
+      name = key.to_s
+      camel =
+        if KEEP_AS_IS_KEYS.include?(name) || !name.include?("_")
+          name
+        else
+          head, *rest = name.split("_")
+          head + rest.map(&:capitalize).join
+        end
+
+      result[camel.to_sym] = value
+    end
+  end
+end
+
+module Sendgo
+  # 이벤트 웹훅 구독 — 등록·심사 결과를 밀어 받는다. v2 전용.
+  #
+  # 심사는 비동기라 폴링 말고는 방법이 없었다. 구독해 두면 상태가 바뀔 때마다
+  # 도착한다.
+  #
+  # @example
+  #   created = client.webhook.subscribe("https://reseller.example.com/hooks/sendgo")
+  #
+  #   # 시크릿은 이 응답에서 한 번만 나온다. 즉시 저장한다.
+  #   secret = created.dig("data", "secret")
+  class WebhookService
+    RESOURCE = "webhook"
+
+    # 구독할 수 있는 이벤트.
+    EVENTS = %w[
+      sender.status_changed
+      notice_template.inspection_status_changed
+      kakao_sender.status_changed
+      kakao_sender.brand_message_status_changed
+    ].freeze
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 현재 구독 설정. 마지막 전송 결과(+lastStatus+)도 함께 온다.
+    def show
+      @http.get(RESOURCE)
+    end
+
+    # 구독 생성·수정.
+    #
+    # +secret+ 을 생략하면 서버가 만들어 **이 응답에서 한 번만** 돌려준다.
+    # 이미 시크릿이 있는 상태에서 생략하면 기존 값을 유지한다 — URL 만 바꾸는
+    # 호출이 서명 키를 날리지 않는다.
+    #
+    # +events+ 가 nil 이면 전체 구독이다.
+    def subscribe(url, secret: nil, events: nil, enabled: true)
+      body = { url: url, enabled: enabled }
+      body[:secret] = secret unless secret.nil?
+      body[:events] = events unless events.nil?
+
+      @http.put(RESOURCE, body)
+    end
+
+    # 테스트 이벤트 발송. 구독 목록과 무관하게 도착한다.
+    def test
+      @http.post("#{RESOURCE}/test", {})
+    end
+
+    # 구독 해지.
+    def unsubscribe
+      @http.delete(RESOURCE)
+    end
+
+    # 수신한 웹훅의 서명을 검증한다.
+    #
+    # +raw_body+ 는 **받은 바이트 그대로**여야 한다. 파싱한 뒤 다시 인코딩한
+    # 값으로 계산하면 키 순서나 이스케이프 차이로 검증이 깨진다.
+    # Rails 라면 +request.raw_post+ 다.
+    def self.verify_signature(raw_body, signature, secret)
+      expected = OpenSSL::HMAC.hexdigest("SHA256", secret, raw_body)
+
+      ActiveSupport::SecurityUtils.secure_compare(expected, signature.to_s)
+    rescue NameError
+      # ActiveSupport 가 없는 순수 Ruby 환경 폴백.
+      # 길이가 다르면 fixed_length_secure_compare 가 던지므로 먼저 막는다.
+      return false unless expected.bytesize == signature.to_s.bytesize
+
+      OpenSSL.fixed_length_secure_compare(expected, signature.to_s)
+    end
+  end
+
+  # 카카오 이미지 업로드 — 브랜드메시지 템플릿에 넣을 URL 발급.
+  #
+  # v2 전용, 기업 계정 전용. 브랜드메시지 템플릿의 +imageUrl+ 은 아무 URL 이나
+  # 되는 게 아니라 **카카오가 호스팅하는 URL** 이어야 하고, 그 URL 을 얻는
+  # 방법이 이 업로드뿐이다.
+  #
+  # @example
+  #   uploaded = File.open("banner.jpg", "rb") do |f|
+  #     client.kakao_images.upload("default", ["banner.jpg", f, "image/jpeg"])
+  #   end
+  #
+  #   client.brand_templates.create(
+  #     kakao_sender_key: kakao_sender_key,
+  #     template_name: "여름 세일 안내",
+  #     template_type: "FI",
+  #     image_url: uploaded.dig("data", "imageUrl")
+  #   )
+  class KakaoImageService
+    RESOURCE = "kakao-images"
+
+    # 파일 하나를 올리고 URL 하나를 받는 유형.
+    SINGLE_TYPES = %w[alimtalk alimtalk_highlight default wide wide_item_list_first].freeze
+
+    # 파일 여러 개를 올리는 유형과 최대 개수.
+    MULTI_TYPES = {
+      "wide_item_list" => 4,
+      "carousel_feed" => 10,
+      "carousel_commerce" => 11
+    }.freeze
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 업로드 가능한 유형과 제약.
+    def types
+      @http.get("#{RESOURCE}/types")
+    end
+
+    # 단일 이미지 업로드. jpg/png, 2MB 이하. +data.imageUrl+ 을 받는다.
+    def upload(image_type, image)
+      @http.post_multipart(path(image_type), {}, { image: image })
+    end
+
+    # 다중 이미지 업로드. 유형별 최대 개수가 다르다.
+    def upload_many(image_type, images)
+      @http.post_multipart(path(image_type), {}, { images: images })
+    end
+
+    private
+
+    def path(image_type)
+      "#{RESOURCE}/#{CGI.escape(image_type)}"
+    end
+  end
+
+  # 수신거부(080) 번호 조회. v2 전용, 조회 전용.
+  #
+  # 발송 API 가 알아서 제외하지만 **자기 DB 의 수신 상태도 맞춰야** 한다 —
+  # 그러지 않으면 매번 보내고 매번 걸러지는 것을 반복하고, 자기 화면에서는
+  # 여전히 "수신 동의" 로 보인다.
+  class RejectedNumberService
+    RESOURCE = "rejected-numbers"
+
+    def initialize(http:)
+      @http = http
+    end
+
+    # 증분만 가져가려면 +since+ 를 쓴다. 전체를 매번 받으면 번호가 쌓일수록
+    # 무거워진다.
+    def list(since: nil, search: nil, count: nil)
+      @http.get(RESOURCE, { since: since, search: search, count: count })
+    end
+  end
+end

data/lib/sendgo/version.rb

@@ -1,3 +1,3 @@
 module Sendgo
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

data/lib/sendgo.rb

@@ -7,6 +7,7 @@ require_relative "sendgo/friendtalk"
 require_relative "sendgo/brand_message"
 require_relative "sendgo/short_url"
 require_relative "sendgo/sms"
+require_relative "sendgo/management"
 require_relative "sendgo/client"
 
 # Sendgo Ruby SDK — 카카오 알림톡/친구톡, SMS/LMS/MMS

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendgo
 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: []
 description: Sendgo API를 Ruby에서 간편하게 사용하기 위한 공식 SDK
 email:
@@ -25,6 +25,7 @@ files:
 - lib/sendgo/error.rb
 - lib/sendgo/friendtalk.rb
 - lib/sendgo/http_client.rb
+- lib/sendgo/management.rb
 - lib/sendgo/short_url.rb
 - lib/sendgo/sms.rb
 - lib/sendgo/token_manager.rb