sendgo-rails

gem "sendgo-rails", "~> 1.0"

Rails.application.config.sendgo.tap do |config|
  config.access_key       = ENV["SENDGO_ACCESS_KEY"]
  config.secret_key       = ENV["SENDGO_SECRET_KEY"]
  config.kakao_sender_key = ENV["SENDGO_KAKAO_SENDER_KEY"]
  config.sms_sender_key   = ENV["SENDGO_SMS_SENDER_KEY"]
  config.api_version      = ENV.fetch("SENDGO_API_VERSION", "v2")
  config.url              = ENV.fetch("SENDGO_URL", "https://sendgo.io")
end

class OrdersController < ApplicationController
  def confirm
    order = Order.find(params[:id])

    Sendgo::Rails.client.alimtalk.send(
      template_code: "ORDER_CONFIRM_001",
      contacts: [
        { contact: order.user.phone, name: order.user.name,
          var1: order.number, var2: "#{order.total}원" }
      ]
    )

    render json: { success: true }
  end
end

# 다건 발송
Sendgo::Rails.client.alimtalk.send(
  template_code: "ORDER_CONFIRM_001",
  contacts: [
    { contact: "01011111111", name: "홍길동", var1: "ORD-001", var2: "29,000원" },
    { contact: "01022222222", name: "김철수", var1: "ORD-002", var2: "15,000원" },
    { contact: "01033333333", name: "이영희", var1: "ORD-003", var2: "52,000원" }
  ]
)

# 예약 발송
Sendgo::Rails.client.alimtalk.send(
  template_code: "PROMO_SUMMER_2026",
  schedule_type: "SCHEDULED",
  at:            "2026-07-28 09:00:00",
  contacts:      [{ contact: "01012345678", var1: "여름 한정 50% 할인" }]
)

# SMS 자동 대체 발송
Sendgo::Rails.client.alimtalk.send(
  template_code: "DELIVERY_START_001",
  replace_sms:   "Y",
  sms_subject:   "[배송 시작 안내]",
  sms_content:   "주문하신 상품이 출고되었습니다.",
  contacts:      [{ contact: "01012345678", var1: "ORD-001", var2: "1234567890" }]
)

# 텍스트형
Sendgo::Rails.client.friendtalk.send(
  content:  "안녕하세요! 7월 한정 특가 이벤트를 확인해보세요.",
  contacts: [{ contact: "01012345678" }]
)

# 이미지형
Sendgo::Rails.client.friendtalk.send(
  message_type: "FI",
  content:      "이번 주 특가 상품을 확인하세요!",
  image_url:    "https://cdn.example.com/banner.jpg",
  image_link:   "https://example.com/event",
  contacts:     [{ contact: "01012345678" }]
)

# 버튼 포함
Sendgo::Rails.client.friendtalk.send(
  content:  "7월 쿠폰이 도착했습니다! 지금 바로 사용하세요.",
  buttons:  [{ name: "쿠폰 받기", type: "WL", link_mo: "https://example.com/coupon" }],
  contacts: [{ contact: "01012345678" }]
)

# SMS (90자 이하)
Sendgo::Rails.client.sms.send_sms(
  content:  "[Sendgo] 인증번호: 123456 (5분 이내 입력)",
  contacts: [{ contact: "01012345678" }]
)

# LMS (장문, 2,000자 이하)
Sendgo::Rails.client.sms.send_lms(
  subject:  "[중요] 서비스 점검 안내",
  content:  "안녕하세요. 서비스 점검이 예정되어 있습니다.\n■ 일시: 2026-07-25 02:00 ~ 06:00",
  contacts: [{ contact: "01012345678" }]
)

# MMS (이미지 포함)
Sendgo::Rails.client.sms.send_mms(
  subject:  "[이벤트] 7월 특가",
  content:  "이번 달 특가 상품을 확인하세요!",
  contacts: [{ contact: "01011111111" }, { contact: "01022222222" }]
)

# app/jobs/send_alimtalk_job.rb
class SendAlimtalkJob < ApplicationJob
  queue_as :notifications
  retry_on Sendgo::Error, wait: 10.seconds, attempts: 3

  def perform(template_code, contacts)
    Sendgo::Rails.client.alimtalk.send(
      template_code: template_code,
      contacts:      contacts
    )
  end
end

# 디스패치 예시
SendAlimtalkJob.perform_later("ORDER_CONFIRM_001", [
  { contact: "01012345678", var1: "ORD-001" }
])

# app/services/notification_service.rb
class NotificationService
  def initialize(client = Sendgo::Rails.client)
    @client = client
  end

  def send_order_confirm(phone:, order_no:, amount:)
    @client.alimtalk.send(
      template_code: "ORDER_CONFIRM_001",
      contacts:      [{ contact: phone, var1: order_no, var2: amount }]
    )
  end
end

begin
  Sendgo::Rails.client.alimtalk.send(template_code: "ORDER_CONFIRM_001", contacts: [...])
rescue Sendgo::Error => e
  Rails.logger.error "Sendgo 발송 실패: HTTP #{e.status_code} [#{e.error_code}]"

  case e.error_code
  when "INVALID_ACCESS_KEY", "INVALID_SECRET_KEY"
    alert_ops("Sendgo 인증키를 확인하세요.")
  when "INVALID_TEMPLATE_CODE"
    Rails.logger.warn("존재하지 않는 템플릿: #{e.message}")
  when "PAYMENT_REQUIRED"
    alert_ops("Sendgo 크레딧이 부족합니다.")
  when "IP_NOT_ALLOWED"
    alert_ops("허용되지 않은 IP")
  end
end

# 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

# 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

# SENDGO_AGENT_TOKEN 또는 config.sendgo.agent_token을 설정합니다.
status = Sendgo::Rails.account_client.me

Sendgo::Rails.client.template_folders.list(template_type: "notice")