Studio API

// Response
[
  {
    "id": 1,
    "title": "매장A",
    "phoneNumber": "07012345678",
    "channelId": 100,
    "status": "ACTIVE",
    "createdAt": "2024-01-15T09:00:00.000Z"
  }
]

// Request
{
  "groupTitle": "신규 매장",
  "phoneNumber": "07098765432"
}

// Response
{
  "groupId": 123
}

GET /call-history?groupId=1&offset=0&limit=20

// Response
{
  "data": [
    {
      "callHistoryId": "8f3f8fd9-7ab8-4a26-b523-4f8eb7d38b85",
      "fromNumber": "01012345678",
      "toNumber": "07012345678",
      "isInbound": true,
      "status": "ANSWERED",
      "tag": "AI_TO_DIRECT",
      "duration": 96,
      "summary": "예약 변경 요청 후 담당자 연결하여 상담 완료",
      "sttAI": [
        { "role": "agent", "text": "안녕하세요. 제로콜입니다. 무엇을 도와드릴까요?", "timestamp": 1.2 },
        { "role": "customer", "text": "내일 예약 시간을 변경하고 싶은데요.", "timestamp": 4.3 },
        { "role": "agent", "text": "네, 예약 변경 도와드리겠습니다. 원하시는 시간대가 있으신가요?", "timestamp": 7.1 },
        { "role": "customer", "text": "오후 3시로 바꿀 수 있을까요? 그리고 담당자랑 직접 통화하고 싶어요.", "timestamp": 11.5 },
        { "role": "agent", "text": "네, 담당자에게 연결해드리겠습니다. 잠시만 기다려주세요.", "timestamp": 16.2 }
      ],
      "sttDirect": [
        { "role": "agent", "text": "안녕하세요, 담당자 김민수입니다.", "timestamp": 1.2 },
        { "role": "customer", "text": "네, 내일 오후 3시로 예약 변경하고 싶어서요.", "timestamp": 4.5 },
        { "role": "agent", "text": "확인해보겠습니다. 오후 3시 자리 있네요. 변경 도와드릴게요.", "timestamp": 9.0 },
        { "role": "customer", "text": "감사합니다.", "timestamp": 14.3 }
      ],
      "recordingAI": {
        "url": "https://storage.example.com/recording-ai.wav",
        "expiresAt": "2026-03-12T03:40:00.000Z",
        "contentLength": 1234567,
        "contentType": "audio/wav"
      },
      "recordingDirect": {
        "url": "https://storage.example.com/recording-direct.wav",
        "expiresAt": "2026-03-12T03:40:00.000Z",
        "contentLength": 2345678,
        "contentType": "audio/wav"
      },
      "channelId": 100,
      "groupId": 1,
      "createdAt": "2026-03-12T02:40:00.000Z"
    }
  ],
  "total": 231,
  "offset": 0,
  "limit": 20
}

# 그룹 목록 조회
curl -X GET "https://studio-gateway.zerocall.kr/group" \
  -H "x-api-key: zpa.123.your-secret-key"

# 메시지 발송
curl -X POST "https://studio-gateway.zerocall.kr/message/send" \
  -H "x-api-key: zpa.123.your-secret-key" \
  -H "Content-Type: application/json" \
  -d '{
    "toPhoneNumber": "01098765432",
    "content": "안녕하세요. 예약이 확정되었습니다."
  }'

# 통화 기록 조회
curl -X GET "https://studio-gateway.zerocall.kr/call-history?groupId=1&offset=0&limit=20" \
  -H "x-api-key: zpa.123.your-secret-key"

const axios = require('axios');

const client = axios.create({
  baseURL: 'https://studio-gateway.zerocall.kr',
  headers: {
    'x-api-key': 'zpa.123.your-secret-key',
    'Content-Type': 'application/json'
  }
});

// 메시지 발송
async function sendMessage(to, content) {
  const response = await client.post('/message/send', {
    toPhoneNumber: to,
    content: content
  });
  return response.data.result; // "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

// 그룹 목록 조회
async function getGroups() {
  const response = await client.get('/group');
  return response.data;
}

// 통화 기록 조회
async function getCallHistories(groupId) {
  const response = await client.get('/call-history', {
    params: { groupId, offset: 0, limit: 20 }
  });
  return response.data;
}

import requests

BASE_URL = 'https://studio-gateway.zerocall.kr'
API_KEY = 'zpa.123.your-secret-key'

headers = {
    'x-api-key': API_KEY,
    'Content-Type': 'application/json'
}

# 메시지 발송
def send_message(to: str, content: str) -> str:
    response = requests.post(
        f'{BASE_URL}/message/send',
        headers=headers,
        json={
            'toPhoneNumber': to,
            'content': content
        }
    )
    return response.json()['result']  # "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 그룹 목록 조회
def get_groups() -> list:
    response = requests.get(f'{BASE_URL}/group', headers=headers)
    return response.json()

# 통화 기록 조회
def get_call_histories(group_id: int) -> dict:
    response = requests.get(
        f'{BASE_URL}/call-history',
        headers=headers,
        params={'groupId': group_id, 'offset': 0, 'limit': 20}
    )
    return response.json()