sendgo 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9c4b04d7a030a8e34230298a109a86571e7089878dd0d5bb8d8bd07a519aeba
-  data.tar.gz: 94b0e1785aac53f05b32cd211901cba951564f4139ad6df7a32684dee559a96a
+  metadata.gz: b284db84cf34d157e88508177769ef77a16544aef167a94c24e5760c724dd92a
+  data.tar.gz: 5fe6a34c4feea8876c6ccd87f80100d1072e4a1eec7ddfc16bcd8ebe8a96ab8d
 SHA512:
-  metadata.gz: 5a68d90dc67ee4ef919978e47dae16609431b8f18ce18240eba2427f6ac1023b2aeda677072a571f1006881df9d65fdfa98aec95a96a0f3a813792db8b473b6b
-  data.tar.gz: e6d730f1f9e01db94024083f1f9fb47bbb7954c1809f479f91ec7308bb2df3e2bab56e6291559185a400955f4a066c8bc68fa769b25422cc426b531e0b465b61
+  metadata.gz: f3657ed33b9adfbe67a300afed3ef8550700eb24f4d678e53b5c404612d38fa2b172cefe185d17eed1cb8e60ac314e4041754434ff87f19b9672b4c63eeebd8b
+  data.tar.gz: f2cdbb4f5f441e6b629a6acef33548fa13c63c9a453407c4d42dffdace8f85f92aa39fa4901e29af00662d0c79b21f391d4e0875a9e36d7544585d3fbc84a1b2

data/README.md

@@ -1,6 +1,6 @@
 # sendgo
 
-> **Ruby에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 Ruby SDK**
+> **Ruby에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 공식 Ruby SDK**
 
 [![Gem Version](https://img.shields.io/gem/v/sendgo)](https://rubygems.org/gems/sendgo)
 [![Ruby](https://img.shields.io/badge/Ruby-3.1%2B-CC342D?logo=ruby)](https://ruby-lang.org)
@@ -99,6 +99,19 @@ client.alimtalk.send(
 
 ## 친구톡 사용법
 
+> ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
+> 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
+> 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
+> 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
+>
+> 다음의 경우에는 **브랜드메시지**를 사용하세요.
+> - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
+> - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
+> - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
+>
+> 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
+> `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
+
 ```ruby
 # 텍스트형
 client.friendtalk.send(
@@ -137,7 +150,7 @@ client.friendtalk.send(
 - 수신 동의한 **전체 채널 친구 동보** 발송 (`targeting: F`, 수신자 목록 불필요)
 - 리스트·캐러셀·커머스·동영상 등 **템플릿 기반 리치 메시지**
 
-> v2 전용입니다. `FT`/`FI`/`FW`를 채널 친구에게만 보낼 때는 친구톡 API가 더 간단합니다.
+> v2 전용입니다. 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보낼 때는 여전히 친구톡 API 를 쓰세요 — 이 엔드포인트는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다. 친구톡 요청은 카카오 측에서 브랜드메시지(자유형)로 대체 발송됩니다.
 
 ```ruby
 # 단건 발송 — 채널 친구 대상
@@ -315,6 +328,55 @@ end
 
 ---
 
+## 짧은 URL
+
+짧은 URL 은 메시지 본문의 링크를 줄이고, 그 링크가 실제로 눌렸는지 집계합니다.
+문자는 바이트 수가 요금과 직결되므로 링크를 줄이면 그만큼 본문을 더 쓸 수 있습니다.
+
+같은 원본 URL 을 다시 줄이면 **기존 링크가 그대로 반환**됩니다. 캠페인별로 반응을
+따로 집계하려면 `forceNew` 로 새 코드를 만드세요.
+
+`deactivate` 는 링크를 삭제하지 않고 리다이렉트만 중지합니다. 이미 발송한 메시지의
+링크를 무효화할 때 쓰며, 누적 통계는 남고 이후 접속은 `410 Gone` 이 됩니다.
+
+```ruby
+# 짧은 URL 생성 (v2 전용)
+created = sendgo.short_url.create(
+  target_url: "https://example.com/promotions/summer-sale",
+  title: "여름 세일 랜딩"
+)
+
+code = created.dig("data", "code")
+link = created.dig("data", "shortUrl")
+
+# 반응 통계 — 일별 추이 + 디바이스/유입경로/국가별 분해
+stats = sendgo.short_url.stats(code, from: "2026-08-01")
+
+sendgo.short_url.list(count: 10)
+sendgo.short_url.show(code)
+sendgo.short_url.deactivate(code)   # 리다이렉트만 중지, 통계는 남는다
+```
+
+`stats` 는 일별 추이(`daily`)와 디바이스(`byDevice`)·유입경로(`byReferer`)·국가(`byCountry`)별
+분해를 반환합니다. 일별 추이는 사전 집계 표에서 읽으므로 클릭이 많아도 응답 시간이 일정합니다.
+
+## 변경 사항
+
+### 1.2.0 (2026-08-14)
+
+- **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
+  2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
+  관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
+- 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
+  문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
+- 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
+
+### 1.1.0 (2026-08-11)
+
+- 짧은 URL 추가 — `client.short_url`
+- `HttpClient#delete` 추가
+- **버그 수정** — `request()` 가 Get/Post 만 만들어 `:delete` 가 조용히 POST 로 나가고 있었다. `Net::HTTP::Delete` 분기 추가.
+
 ## 라이선스
 
 MIT License © 2026 [Sendgo](https://sendgo.io)

data/lib/sendgo/client.rb

@@ -11,6 +11,7 @@ module Sendgo
   #   )
   class Client
     # brand_message: 카카오 브랜드메시지 — 친구톡의 후속 채널. v2 전용.
+    # friendtalk: @deprecated 2025-12-31 종료. brand_message 를 사용하세요.
     attr_reader :alimtalk, :friendtalk, :brand_message, :short_url, :sms
 
     def initialize(access_key:, secret_key:, kakao_sender_key: nil, sms_sender_key: nil,

data/lib/sendgo/friendtalk.rb

@@ -1,5 +1,14 @@
 module Sendgo
   # 카카오 친구톡 전송 서비스.
+  #
+  # @deprecated 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.
+  #   2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 브랜드메시지(자유형)로
+  #   자동 대체 발송되므로, 이 서비스를 호출해도 실제로 나가는 것은 브랜드메시지입니다.
+  #   신규 연동은 {BrandMessageService} (+client.brand_message+) 를 사용하세요.
+  #   다만 자유 본문 타입(FT/FI/FW)을 개별 수신자에게 보내는 경로는 아직 이
+  #   서비스뿐입니다 — 브랜드메시지 API 는 그 조합에 NOT_A_BRAND_MESSAGE 를 반환합니다.
+  #   메시지 타입은 1:1 대응됩니다 — FT→BT, FI→BI, FW→BW, FL→BL,
+  #   FC→BC, FM→BM, FP→BP, FA→BA.
   class FriendtalkService
     def initialize(http:, kakao_sender_key:, sms_sender_key:)
       @http            = http
@@ -7,6 +16,7 @@ module Sendgo
       @sms_sender_key  = sms_sender_key
     end
 
+    # @deprecated 2025-12-31 종료. +client.brand_message.send+ 를 사용하세요.
     def send(content:, contacts:, message_type: "FT", schedule_type: "DIRECTLY",
              at: nil, buttons: [], image_url: nil, image_link: nil,
              ad_flag: "Y", wide: "N", adult: "N", header: nil,

data/lib/sendgo/version.rb

@@ -1,3 +1,3 @@
 module Sendgo
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendgo
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Sendgo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies: []
 description: Sendgo API를 Ruby에서 간편하게 사용하기 위한 공식 SDK
 email: