텔로즈 REST API
무엇이든 음성으로 구현하세요. 텔로즈 API
모든 주요 언어에 대한 SDK가 포함된 깔끔한 REST API를 통해 통화 시작, 웹후크 수신, 스크립트 스트리밍, 모든 기능을 갖춘 다이얼러 내장 등이 모두 가능합니다.
REST API웹훅OpenAPI 사양SDK99.99% 가동 시간
200 OK - 통화 대기 중
OpenAPI 3.0 사양 포함
teloz-api.js
// Initiate an outbound call const response = await teloz.calls.create({ to: "+12025550123", from: "+18005550199", record: true, webhook: "https://your-app.com/events"}); // Response// {// sid: "CA3f9a…"// status: "queued"// duration: null// }99.99%
API 가동 시간 SLA
엔터프라이즈급 신뢰성
< 100ms
평균 응답 시간
미국 전역
50+
REST 엔드포인트
통화, 연락처, 전화번호 등
SDK 4개
공식 언어 라이브러리
노드, Python, PHP, Go
엔드포인트
6개의 리소스 그룹, 50개 이상의 엔드포인트
제품에 음성, SMS, 연락 센터 기능을 구축하는 데 필요한 모든 것입니다.
게시 · 가져오기 · 삭제
통화
아웃바운드 통화를 시작하고, 통화 기록을 검색하고, 녹음에 액세스하고, 실시간 대화 내용을 스트리밍하세요.
우편
/v1/calls얻다
/v1/calls/:sid얻다
/v1/calls/:sid/recording삭제
/v1/calls/:sid게시 · 가져오기 · 넣기 · 삭제
콘택트 렌즈
연락처를 생성하고, 읽고, 업데이트하고, 삭제합니다. CRM과 동기화하거나 자신만의 전화번호부를 만드세요.
우편
/v1/contacts얻다
/v1/contacts놓다
/v1/contacts/:id삭제
/v1/contacts/:id게시 · 가져오기 · 삭제
숫자
사용 가능한 번호를 검색하고, 지역 또는 무료 DID를 제공하고, 번호 구성을 관리하세요.
얻다
/v1/numbers/available우편
/v1/numbers얻다
/v1/numbers/:id삭제
/v1/numbers/:id게시 · 가져오기 · 삭제
웹훅
통화, 음성 메일, 대화 내용 및 SMS에 대한 실시간 이벤트를 수신하려면 엔드포인트를 등록하세요.
우편
/v1/webhooks얻다
/v1/webhooks놓다
/v1/webhooks/:id삭제
/v1/webhooks/:id얻다
해석학
대시보드 및 보고서에 대한 통화량, 기간, 처리 및 대기열 통계를 가져옵니다.
얻다
/v1/analytics/calls얻다
/v1/analytics/queues얻다
/v1/analytics/agents얻다
/v1/analytics/summary자바스크립트 SDK
내장형 다이얼러
JavaScript 몇 줄만 있으면 모든 기능을 갖춘 클릭 투 콜 위젯을 웹 앱에 추가할 수 있습니다.
teloz.dialer.init(config)teloz.dialer.call(number)teloz.dialer.on('event', fn)teloz.dialer.destroy()통화 시작
import Teloz from "@teloz/node"; const client = new Teloz(process.env.TELOZ_API_KEY); const call = await client.calls.create({ to: "+12025550123", from: "+18005550199", record: true, transcribe: true, webhook: "https://your-app.com/events",}); console.log(call.sid); // CA3f9a7b…웹훅
모든 통화 이벤트에 반응 실시간
웹후크 URL을 등록하면 Teloz는 이벤트가 발생하는 순간 서명된 JSON 페이로드를 엔드포인트에 게시합니다. 폴링이 필요하지 않습니다. 웹훅을 우리의 웹훅과 결합하세요 통합 워크플로를 처음부터 끝까지 자동화합니다.
모든 페이로드의 HMAC-SHA256 서명
지수 백오프를 사용한 자동 재시도
대시보드의 전송 로그 및 재생
엔드포인트당 이벤트 유형별로 필터링 가능
이벤트범주
call.initiated아웃바운드 통화가 대기 중일 때 실행됩니다.call.ringing대상 전화가 울리고 있습니다.call.answered전화를 받았습니다. 발신자 메타데이터가 포함되어 있습니다.call.completed통화 종료 — 지속 시간, 처리 포함call.missed수신 전화가 응답되지 않았습니다.recording.ready녹음 파일 URL을 다운로드할 수 있습니다.transcript.ready전체 대본 텍스트 및 화자 라벨 첨부voicemail.new오디오 URL이 포함된 새 음성메일을 받았습니다.sms.inbound프로비저닝된 번호로 수신된 인바운드 SMSAPI FAQ
짧은 답변.
구축을 시작하기 전에 자주 묻는 질문입니다.
Teloz 계정에 가입하고 설정 → 개발자 → API 키로 이동하세요. 범위가 지정된 권한(읽기 전용, 호출 전용, 관리자)을 사용하여 여러 키를 생성하고 언제든지 취소할 수 있습니다.
예. 전체 OpenAPI 3.0 사양은 api.teloz.com/openapi.json에서 제공되며 Postman, Insomnia 또는 호환되는 클라이언트로 직접 가져올 수 있습니다. 모든 릴리스와 동기화가 유지됩니다.
API는 Bearer 토큰 인증을 사용합니다. Authorization 헤더에 API 키를 'Bearer YOUR_API_KEY'로 전달하세요. 서버 간 사용의 경우 범위가 지정된 키를 권장합니다. 브라우저 내장 다이얼러의 경우 OAuth 단기 토큰을 사용합니다.
예. 기본 제한은 API 키당 초당 요청 100개입니다. 최대 10초 동안 최대 500req/s의 버스트가 허용됩니다. Enterprise 요금제는 더 높은 한도를 요청할 수 있습니다. 모든 응답에는 속도 제한 헤더(X-RateLimit-Remaining, X-RateLimit-Reset)가 반환됩니다.
모든 웹훅 POST에는 웹훅 비밀로 서명된 원시 요청 본문의 HMAC-SHA256 해시가 포함된 X-Teloz-Signature 헤더가 포함되어 있습니다. 동일한 해시를 계산하고 비교하여 일치하지 않는 요청을 거부합니다.
예. 테스트 API 키와 함께 기본 URL https://api.sandbox.teloz.com을 사용하세요. 샌드박스 모드에서 이루어진 통화는 PSTN에 연결되지 않습니다. 녹음 및 대화 내용을 포함한 전체 이벤트 수명 주기를 시뮬레이션합니다.
