이미지 문자(MMS) 보내기: 미디어 업로드부터 발송까지

# resize_for_mms.py — pip install pillow
from io import BytesIO

from PIL import Image

MAX_SIDE = 1280
MAX_BYTES = 300 * 1000  # 여유 있게 300,000바이트


def to_mms_jpeg(src: str, dst: str) -> int:
    img = Image.open(src).convert("RGB")  # PNG 투명도 등을 정리하고 JPG로 저장
    img.thumbnail((MAX_SIDE, MAX_SIDE))
    for quality in (85, 75, 65, 55, 45):
        buf = BytesIO()
        img.save(buf, format="JPEG", quality=quality, optimize=True)
        if buf.tell() <= MAX_BYTES:
            with open(dst, "wb") as f:
                f.write(buf.getvalue())
            return buf.tell()
    raise ValueError(f"{src}: 품질을 낮춰도 300KB를 넘습니다. 크기를 더 줄이세요.")


print(to_mms_jpeg("coupon.png", "coupon.jpg"))

export KAT_API_KEY="콘솔에서 발급받은 키"
BASE="https://studio-gateway.zerocall.kr"

# 1) 이미지 업로드 (-F를 쓰면 curl이 multipart/form-data와 boundary를 자동으로 붙인다)
curl -s -X POST "$BASE/chat/media/upload" \
  -H "x-api-key: $KAT_API_KEY" \
  -F "files=@coupon.jpg;type=image/jpeg"
# {"code":"0","message":"Success","result":{"urls":["chat-media/123456/1713776400000-abcd123.jpg"]}}

# 2) 받은 key를 imageList에 넣어 발송
curl -s -X POST "$BASE/chat" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chatRoomId":"yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy","content":"방문 시 이 쿠폰을 보여 주세요.","subject":"11월 쿠폰","imageList":["chat-media/123456/1713776400000-abcd123.jpg"]}'

// send-mms-chat.js — Node.js 18+
const { readFile } = require('node:fs/promises');
const path = require('node:path');

const BASE_URL = 'https://studio-gateway.zerocall.kr';
const API_KEY = process.env.KAT_API_KEY;
const MIME = { '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png' };

async function readResult(res) {
  const json = await res.json().catch(() => ({}));
  if (!res.ok || json.code !== '0') throw new Error(`${res.status} ${json.code} ${json.message}`);
  return json.result;
}

async function uploadChatMedia(filePaths) {
  if (filePaths.length > 3) throw new Error('한 번에 최대 3개까지 업로드할 수 있습니다');
  const form = new FormData();
  for (const p of filePaths) {
    const type = MIME[path.extname(p).toLowerCase()] || 'application/octet-stream';
    form.append('files', new Blob([await readFile(p)], { type }), path.basename(p));
  }
  const res = await fetch(`${BASE_URL}/chat/media/upload`, {
    method: 'POST',
    headers: { 'x-api-key': API_KEY }, // Content-Type은 fetch가 boundary와 함께 붙인다
    body: form,
  });
  const { urls } = await readResult(res);
  if (urls.length !== filePaths.length) {
    throw new Error(`업로드 일부 실패: ${filePaths.length}개 중 ${urls.length}개 성공`);
  }
  return urls;
}

async function sendMms({ chatRoomId, content, subject, files }) {
  const imageList = await uploadChatMedia(files);
  const res = await fetch(`${BASE_URL}/chat`, {
    method: 'POST',
    headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ chatRoomId, content, subject, imageList }),
  });
  return readResult(res); // { chatId, chatType: 'MMS', sendStatus: 'PENDING', ... }
}

sendMms({
  chatRoomId: 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy',
  subject: '11월 쿠폰',
  content: '방문 시 이 쿠폰을 보여 주세요.',
  files: ['./coupon.jpg'],
})
  .then((chat) => console.log(chat.chatId, chat.chatType, chat.sendStatus))
  .catch((err) => console.error(err));

# 1) 이미지 업로드 (최대 3개)
curl -s -X POST "$BASE/message/media/upload" \
  -H "accept: */*" \
  -H "x-api-key: $KAT_API_KEY" \
  -F "files=@sample1.png;type=image/png" \
  -F "files=@sample2.jpg;type=image/jpg"

# 2) result.urls의 key를 imageList에 넣어 발송
curl -s -X POST "$BASE/message/send" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"toPhoneNumber":"01098765432","content":"11월 방문 쿠폰입니다.","subject":"11월 쿠폰","imageList":["chat-media/123456/1713776400000-abcd123.jpg","chat-media/123456/1713776400001-efgh456.jpg"]}'
# {"code":"0","message":"Success","result":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}

# send_mms_message.py — /message/media/upload → /message/send
import os

import requests

BASE_URL = "https://studio-gateway.zerocall.kr"
API_KEY = os.environ["KAT_API_KEY"]


def check(r: requests.Response):
    body = r.json()
    if r.status_code >= 400 or body.get("code") != "0":
        raise RuntimeError(f"{r.status_code} {body.get('code')} {body.get('message')}")
    return body["result"]


def upload_message_media(paths: list[str]) -> list[str]:
    handles = [open(p, "rb") for p in paths]
    try:
        files = [("files", (os.path.basename(p), fh, "image/jpeg")) for p, fh in zip(paths, handles)]
        r = requests.post(
            f"{BASE_URL}/message/media/upload",
            headers={"x-api-key": API_KEY},
            files=files,
            timeout=30,
        )
    finally:
        for fh in handles:
            fh.close()
    urls = check(r)["urls"]  # 업로드에 실패한 파일은 이 배열에 없다
    if len(urls) != len(paths):
        raise RuntimeError(f"{len(paths)}개 중 {len(urls)}개만 업로드됨")
    return urls


def send_mms(to: str, content: str, paths: list[str], subject: str | None = None) -> str:
    payload = {"toPhoneNumber": to, "content": content, "imageList": upload_message_media(paths)}
    if subject:
        payload["subject"] = subject  # 제목, 최대 64자
    r = requests.post(
        f"{BASE_URL}/message/send",
        headers={"x-api-key": API_KEY, "Content-Type": "application/json"},
        json=payload,
        timeout=10,
    )
    return check(r)  # 32자 chatId


if __name__ == "__main__":
    print(send_mms("01098765432", "11월 방문 쿠폰입니다.", ["coupon.jpg"], subject="11월 쿠폰"))