TypeScript / JavaScript SDK

View as Markdown

TypeScript / JavaScript SDK

공식 ClawOps TypeScript SDK는 Node.js 애플리케이션에서 통화, 전화번호, 메시지, 녹음과 SIP 리소스를 타입 안전하게 사용할 수 있도록 합니다.

npm

현재 공개 버전은 0.26.0이며 Node.js 18 이상을 지원합니다.

설치

$npm install @teamlearners/clawops

빠른 시작

1import ClawOps from "@teamlearners/clawops";
2
3const client = new ClawOps({
4 apiKey: process.env.CLAWOPS_API_KEY,
5 accountId: process.env.CLAWOPS_ACCOUNT_ID,
6});
7
8// 보유 전화번호 조회
9const numbers = await client.numbers.list();
10
11// 아웃바운드 통화 발신
12const call = await client.calls.create({
13 to: "01012345678",
14 from: "07012341234",
15 url: "https://example.com/voice",
16});
17
18console.log(call.callId);

생성자 옵션을 생략하면 CLAWOPS_API_KEYCLAWOPS_ACCOUNT_ID 환경변수를 자동으로 사용합니다.

AI 음성 에이전트

OpenAI Realtime 기반 Voice Agent를 실행하려면 openai를 함께 설치합니다.

$npm install @teamlearners/clawops openai
1import { ClawOpsAgent, OpenAIRealtime } from "@teamlearners/clawops/agent";
2
3const agent = new ClawOpsAgent({
4 from: "07012341234",
5 session: new OpenAIRealtime({
6 systemPrompt: "친절한 고객 상담원입니다. 한국어로 응대합니다.",
7 language: "ko",
8 }),
9});
10
11await agent.serve();

주요 리소스

  • client.calls — 통화 발신, 조회, 종료, 녹음·전사·요약
  • client.numbers — 전화번호 발급, 조회, 라우팅, 해제
  • client.messages — SMS·LMS·MMS 발송 및 조회
  • client.recordings — 통화 녹음 다운로드 및 삭제
  • client.sipEndpoints, client.sipCredentials — SIP와 WebRTC 연동
  • client.webhookLogs — Webhook 전달 이력 조회

링크