채팅 API로 문자 보내기: /chat-room과 /chat 사용법

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

curl -s "$BASE/group" -H "x-api-key: $KAT_API_KEY"

{
  "code": "0",
  "message": "Success",
  "result": [
    {
      "id": 1,
      "title": "매장A",
      "phoneNumber": "07012345678",
      "channelId": 100,
      "status": "ACTIVE",
      "recordingEnabled": true,
      "createdAt": "2026-01-15T09:00:00.000Z"
    }
  ]
}

curl -s -X POST "$BASE/chat-room" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channelId": 100, "phoneNumber": "01098765432"}'
# {"code":"0","message":"Success","result":"yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"}

curl -s -X POST "$BASE/chat" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chatRoomId": "yyyyyyyyyyyyyyyyyyyyyyyyyyyyyy", "content": "예약 확인되었습니다.", "externalMessageId": "ext-msg-001"}'

// send-text.js — Node.js 18+
const BASE_URL = 'https://studio-gateway.zerocall.kr';
const API_KEY = process.env.KAT_API_KEY;

async function kat(method, path, body) {
  const res = await fetch(`${BASE_URL}${path}`, {
    method,
    headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
    body: body ? JSON.stringify(body) : undefined,
  });
  const json = await res.json().catch(() => ({}));
  if (!res.ok || json.code !== '0') {
    // 에러 형식: { status, code, message }
    throw new Error(`${method} ${path} 실패: ${res.status} ${json.code} ${json.message}`);
  }
  return json.result;
}

const toDigits = (phone) => String(phone).replace(/\D/g, ''); // 010-9876-5432 → 01098765432

async function sendText({ channelId, to, content, subject, externalMessageId }) {
  const chatRoomId = await kat('POST', '/chat-room', { channelId, phoneNumber: toDigits(to) });
  return kat('POST', '/chat', { chatRoomId, content, subject, externalMessageId });
}

(async () => {
  const [group] = await kat('GET', '/group');

  const sms = await sendText({
    channelId: group.channelId,
    to: '010-9876-5432',
    content: '예약 확인되었습니다.',
  });
  console.log(sms.chatId, sms.chatType, sms.sendStatus); // ... SMS PENDING

  const lms = await sendText({
    channelId: group.channelId,
    to: '010-9876-5432',
    subject: '예약 안내',
    content: '내일 오후 3시 예약이 확정되었습니다. 변경이 필요하면 이 번호로 답장해 주세요.',
    externalMessageId: 'booking-20261030-0001',
  });
  console.log(lms.chatId, lms.chatType); // ... LMS
})();

import os
import re

import requests

BASE_URL = "https://studio-gateway.zerocall.kr"
HEADERS = {"x-api-key": os.environ["KAT_API_KEY"], "Content-Type": "application/json"}


def kat(method: str, path: str, body: dict | None = None):
    r = requests.request(method, f"{BASE_URL}{path}", headers=HEADERS, json=body, timeout=10)
    data = r.json()
    if r.status_code >= 400 or data.get("code") != "0":
        raise RuntimeError(f"{r.status_code} {data.get('code')} {data.get('message')}")
    return data["result"]


def send_text(channel_id: int, to: str, content: str, subject: str | None = None) -> dict:
    room_id = kat("POST", "/chat-room", {"channelId": channel_id, "phoneNumber": re.sub(r"\D", "", to)})
    body = {"chatRoomId": room_id, "content": content}
    if subject:
        body["subject"] = subject
    return kat("POST", "/chat", body)