동시 통화 한도
구독 플랜에 따른 동시 통화 제한과 한도 초과 시 동작, 에러 처리 방법을 안내합니다.
동시 통화 한도
ClawOps는 구독 플랜에 따라 계정당 동시에 진행할 수 있는 통화 수를 제한합니다. 인바운드와 아웃바운드 통화를 합산하여 계산합니다.
플랜별 한도
| 플랜 | 월 요금 | 동시 통화 수 |
|---|---|---|
| Trial | 무료 | 1 |
| Individual | ₩19,000 | 1 |
| Business | ₩99,000 | 10 |
동시 통화 수는 현재 진행 중인(ringing + in-progress) 통화의 합계입니다. 종료된 통화는 포함되지 않습니다.
각 플랜은 통화 분량·메시지 건수 등의 월 포함량을 제공하며, 초과 사용 시 분/건 단위로 사용량 기반 과금됩니다. 최신 포함량과 요금은 대시보드 → 설정 → 결제에서 확인하세요.
한도 초과 시 동작
아웃바운드 통화
calls.create() 호출 시 동시 통화 한도를 초과하면 HTTP 429 응답과 함께 CALL_LIMIT_EXCEEDED 에러 코드가 반환됩니다.
{
"error": "동시 통화 한도(1)를 초과했습니다. 현재 1건 진행 중",
"code": "CALL_LIMIT_EXCEEDED"
}인바운드 통화
동시 통화 한도를 초과한 상태에서 전화가 수신되면, 발신자에게 자동으로 안내 멘트("현재 통화 중입니다. 잠시 후 다시 걸어주세요.")가 재생된 후 통화가 종료됩니다. Webhook은 호출되지 않습니다.
SDK 에러 처리
Python
from clawops import ClawOps, RateLimitError
client = ClawOps()
try:
call = client.calls.create(
to="01012345678",
from_="07052358010",
url="https://my-app.com/twiml",
)
except RateLimitError as e:
print(f"동시 통화 한도 초과: {e.message}")Node.js
import ClawOps, { RateLimitError } from 'clawops';
const client = new ClawOps();
try {
const call = await client.calls.create({
to: '01012345678',
from: '07052358010',
url: 'https://my-app.com/twiml',
});
} catch (e) {
if (e instanceof RateLimitError) {
console.log(`동시 통화 한도 초과: ${e.message}`);
}
}Voice Agent
Voice Agent SDK의 agent.call() 사용 시에도 동일한 한도가 적용됩니다.
from clawops.agent import ClawOpsAgent, AgentError
agent = ClawOpsAgent(...)
try:
call = await agent.call(to="01012345678")
except AgentError as e:
if getattr(e, "status", None) == 429:
print("동시 통화 한도 초과")구독 없음 (403)
활성 구독이 없는 계정에서 통화를 시도하면 HTTP 403 응답과 함께 NO_SUBSCRIPTION 에러 코드가 반환됩니다.
{
"error": "활성 구독이 없습니다",
"code": "NO_SUBSCRIPTION"
}FAQ
한도를 늘리려면 어떻게 하나요?
대시보드에서 상위 플랜으로 업그레이드하면 동시 통화 한도가 자동으로 증가합니다.
인바운드와 아웃바운드를 별도로 제한할 수 있나요?
아닙니다. 동시 통화 한도는 인바운드와 아웃바운드를 합산하여 적용됩니다.
통화가 종료되면 즉시 슬롯이 해제되나요?
네. 통화가 종료(completed/failed)되면 즉시 슬롯이 해제되어 새로운 통화가 가능합니다.