070 번호 API: REST API 한 줄로 전화번호 발급받기

070 인터넷전화 번호 개통해본 사람이면 아실 겁니다. 한국의 070 번호는 과학기술정보통신부가 관리하는 인터넷전화 전용 번호 체계입니다. 통신사 웹사이트 들어가서 서류 내고, 사업자등록증 첨부하고, 심사 기다리고... 빠르면 1주, 보통 2~3주 걸립니다.

개발하다가 전화번호 하나 필요해서 찾아봤더니, 개발자가 프로그래매틱하게 070 번호를 발급받을 수 있는 방법이 거의 없었습니다. 해외에는 Twilio가 있지만 한국 070은 미지원이고, 국내 통신사는 전부 수동 신청입니다.

이걸 API 한 줄로 줄여봤습니다.

기존 방식 vs API 방식

기존 방식 (통신사 직접 계약)

1. 통신사 선택 → 신청서 작성
2. 사업자등록증, 신분증 등 서류 제출
3. 심사 대기 (3~10 영업일)
4. 승인 후 SIP 크레덴셜 수동 발급
5. PBX/SIP 서버에 직접 설정

총 소요시간: 2~3주

API 방식 (ClawOps)

1. API 호출 한 번

총 소요시간: 10초

Python

import requests

API_KEY = "your-api-key"
ACCOUNT_ID = "your-account-id"
BASE = f"https://api.claw-ops.com/v1/accounts/{ACCOUNT_ID}"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 070 번호 발급
number = requests.post(f"{BASE}/numbers", headers=headers,
    json={"webhookUrl": "https://your-server.com/voice"}).json()
print(f"발급된 번호: {number['number']}")

이게 전부입니다. SIP 트렁크 계약, SBC 연동, SRTP 설정 — 전부 ClawOps가 처리합니다. 발급된 번호는 바로 사용 가능한 상태로 나옵니다. 통신사 심사 대기 같은 건 없습니다.

curl

curl -X POST \
  https://api.claw-ops.com/v1/accounts/{accountId}/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhookUrl": "https://your-server.com/voice"}'

응답:

{
  "id": "pn_abc123",
  "number": "070-1234-5678",
  "protocol": "SIP/2.0",
  "status": "active"
}

발급받은 번호로 바로 전화 걸기

번호만 발급받으면 끝이 아니라, 바로 전화를 걸 수 있습니다. 에이전트를 따로 만들 필요 없이 번호와 대상만 지정하면 됩니다.

# 전화 발신
call = requests.post(f"{BASE}/calls", headers=headers,
    json={
        "to": "01012345678",
        "from": number["number"],
        "webhookUrl": "https://your-server.com/status"
    }).json()
print(f"통화 ID: {call['callId']}")

ClawOps는 전화 인프라(SIP, 070번호, 통화 연결)를 제공합니다. 음성 처리(STT/TTS/LLM)는 개발자가 직접 선택하여 연동합니다 (예시 SDK에서는 OpenAI Realtime API 사용, 추천). 인프라가 GCP 한국 리전 (서울)에 있어서 레이턴시가 500ms 미만입니다. SRTP 암호화, DTMF 지원까지 기본으로 들어가고, 국내 서버에서 데이터 처리됩니다.

수신 전화도 됩니다

발급받은 070 번호로 누군가 전화를 걸면, 웹훅으로 이벤트가 옵니다:

# 웹훅 이벤트 종류
# call.initiated — 전화 시작
# call.ringing — 벨 울림
# call.answered — 상대가 받음
# call.transcript — 실시간 전사
# call.ended — 통화 종료
# call.recording.ready — 녹음 준비 완료

070 번호에 웹훅을 설정해놓으면 수신 전화를 자동으로 처리할 수 있습니다. 고객센터 자동화 같은 걸 만들 때 유용합니다. 전화 봇 구축 가이드에서 전체 흐름을 확인할 수 있습니다. call.analysis.ready 이벤트도 있어서 통화가 끝나면 자동으로 분석 결과도 받을 수 있습니다.

MCP로도 됩니다

코드 안 짜고 MCP 지원 에이전트(Claude Desktop 등)에서 바로 쓰고 싶으면:

{
  "mcpServers": {
    "call-me": {
      "command": "npx",
      "args": ["-y", "call-me-mcp"]
    }
  }
}

initiate_call, continue_call, speak_to_user, end_call 네 가지 도구가 붙습니다.

가격

무료 Trial로 바로 시작할 수 있습니다. Trial은 전화회선 1개, 발신 10분, SMS 10건이 무료이고 카드등록도 필요 없습니다.

Starter 월 19,900원 (발신 60분, 수신 무제한 무료, 전화회선 1개). 발신 분당 116원, 수신은 무료입니다. 약정 없고 언제든 해지 가능합니다. 종량제는 발신 116원/분, SMS 17원/건.

Growth는 월 49,900원 (발신 300분, 수신 무제한 무료, 전화회선 3개), Business는 월 149,000원 (1000분, 전화회선 10개, 동시통화 10건).

기존에 070 번호 개통하려면 통신사 계약부터 SIP 서버 세팅까지 2~3주였는데, 이제 API 호출 한 번이면 됩니다. 개발자가 070 번호를 코드로 발급받고, 바로 전화를 걸고 받는 것까지 30분이면 됩니다. WebRTC와 SIP 게이트웨이 연동도 함께 참고하면 더 깊이 이해할 수 있습니다.

참고 링크

• ClawOps — AI 전화 에이전트 플랫폼
• Twilio SIP Trunking Docs
• RFC 3261 — SIP 프로토콜 스펙
• Samsung WYZ070 — 070 인터넷전화
• MCP (Model Context Protocol) 문서

https://claw-ops.com