링플로우 REST API · v2

통화를 위한 하나의 API, SMS 및 AI — 현대적인 팀을 위해 제작되었습니다.

Ringflow의 REST API를 사용하면 인증된 단일 엔드포인트 뒤에서 아웃바운드 통화, 대량 SMS, 이중 채널 녹음, AI Receptionist 에이전트 및 실시간 이벤트 웹후크 등 통신 스택의 모든 부분을 프로그래밍 방식으로 제어할 수 있습니다.

무료 영구 샌드박스첫 번째 실시간 통화까지 5분서비스 수준 계약 지원 API 레이어
서비스 수준 계약 지원 API·엔터프라이즈 보안·BAA 가능·통화 녹음 편집·HMAC 이벤트 서명·EU 및 미국 데이터 상주
API 참조

필요한 모든 것, 필요하지 않은 것은 없습니다.

리소스 그룹 6개, 기본 URL 1개, 인증 체계 1개. 모든 엔드포인트에는 버전이 지정되고 일관된 JSON이 반환되며 요청/응답 예제가 함께 제공됩니다. 전체 참조.

음성 통화
  • 우편/v2/호출원하는 번호로 아웃바운드 전화 걸기
  • 얻다/v2/calls/:id실시간 상태, 기간, 녹화 가져오기
  • 우편/v2/calls/:id/전송통화 중 웜 트랜스퍼 또는 콜드 트랜스퍼
  • 삭제/v2/calls/:id활성 통화를 즉시 종료합니다.
SMS 및 MMS
  • 우편/v2/메시지단일 수신자에게 SMS 또는 MMS 보내기
  • 우편/v2/메시지/대량요청당 최대 1,000개의 메시지를 일괄 처리합니다.
  • 얻다/v2/메시지/:id폴링 배송 상태 및 운송업체 영수증
녹음
  • 우편/v2/calls/:id/레코드듀얼 채널 통화 녹음 시작
  • 삭제/v2/calls/:id/레코드녹음 중지 및 저장 트리거
  • 우편/v2/recordings/:id/transcribe비동기 AI 기록 요청
AI 접수원
  • 우편/v2/ai/에이전트새로운 AI 접수원 프로비저닝
  • 놓다/v2/ai/agents/:id/knowledgeFAQ, 문서 및 에스컬레이션 규칙 푸시
  • 얻다/v2/ai/sessions/:id/summary통화 후 AI 요약 검색
이벤트
  • 우편/v2/이벤트/구독모든 플랫폼 이벤트를 구독하세요
  • 얻다/v2/이벤트/구독구독 목록을 나열하고 필터링하세요.
  • 삭제/v2/이벤트/구독/:id이벤트 구독 제거
인증 및 키
  • 우편/v2/인증/토큰단기 무기명 토큰 발행
  • 우편/v2/인증/키범위가 지정된 작업공간 API 키 만들기
  • 놓다/v2/auth/keys/:id/회전다운타임 없는 키 순환
클라이언트 SDK

스택에 대한 관용적 클라이언트.

모든 Ringflow SDK는 사양에서 생성되지 않고 코드 우선으로 구축됩니다. 재시도, 페이지 매기기 커서 및 웹훅 확인은 나중에 고려하는 것이 아니라 최고 수준입니다.

npm i @ringflow/sdk
import { Ringflow } from "@ringflow/sdk"

const client = new Ringflow({
  apiKey: process.env.RINGFLOW_API_KEY,
  region: "us-east-1",
})

// Place a call and stream status updates
const call = await client.calls.create({
  to:        "+14155550199",
  from:      "+19172544289",
  recordDualChannel: true,
  onStatus: (evt) => console.log(evt.status),
})

console.log(call.id)   // call_rfw_2Kj8mNpQ
지터를 사용한 스마트 재시도
커서 기반 페이지 매김
내장된 서명 확인
100% TypeScript 적용 범위
비율 제한

모든 계층에서 예측 가능한 한도.

제한은 IP가 아닌 작업공간별로 적용됩니다. 모든 응답에는 X-RateLimit-남은, X-RateLimit-재설정, 그리고 재시도 후 헤더 켜기 429초 그러면 우아하게 물러설 수 있습니다.

계획지속됨버스트 캡동시 통화
모래 상자요청 5개/초15 요청/초2 통화
기동기40 요청/초80 요청/초25 통화
사업150 요청/초300 요청/초150 통화
기업관습관습관습제한 없는
왜 링플로우인가?

다르게 만들어졌습니다. 가격이 적당합니다.

최대 전화 통신 API 나중에 AI를 추가하세요. Ringflow는 처음부터 하나의 일관된 API로 AI, 음성 및 메시징을 구축했습니다. 따라서 세 공급업체를 하나로 묶을 필요가 없습니다.

능력링플로우일반적인 대안
하나의 API로 통화+SMS+AI 통합
영구 샌드박스 — 만료 없음, 카드 없음
즉시 사용 가능한 듀얼 채널 녹음
REST 엔드포인트를 통한 AI 접수원
HMAC 서명된 웹훅 전달
다운타임 없는 API 키 순환
기업 보안 감사 + BAA 가능

우리의 약속

프로덕션 표준에 맞춰 구축된 REST API입니다.

Ringflow의 API는 일관된 JSON 응답, 강력한 인증, 명확한 속도 제한 신호 및 안전한 통합 테스트를 위한 영구 샌드박스 등 실제 프로덕션 워크로드를 처리하도록 설계되었습니다.

JSON 응답
OAuth 2.0 인증
비율 제한 헤더
멱등성 키
웹훅 재시도
버전이 지정된 엔드포인트
99포인트 가동 시간
샌드박스 테스트

다양한 산업 분야의 엔지니어링 팀으로부터 사랑을 받고 있습니다.

의료 서비스부터 소매업까지 — Ringflow의 API는 대규모 생산 커뮤니케이션을 지원합니다.

A

아르준 메타

엔지니어링 책임자, Zenia Health — 뭄바이

Ringflow의 API를 사용하면 2주 만에 음성 분류를 환자 포털에 포함할 수 있습니다. AI Receptionist 엔드포인트만으로도 근무 시간 외 통화량이 40% 줄었습니다.

검증된 고객
R

레이첼 토레스

제품 담당 부사장, ClearLane Finance — 오스틴 텍사스

우리는 한 분기에 3개의 컨택 센터 공급업체를 Ringflow로 마이그레이션했습니다. 통합된 REST 표면 덕분에 하나의 인증 흐름, 하나의 웹훅 스키마 등 모든 것이 통합되어 간단해졌습니다.

검증된 고객
B

벤 하그리브스

플랫폼 리드, StackRoute — 런던

듀얼 채널 녹음 및 비동기 전사 엔드포인트 덕분에 자체 음성 파이프라인을 구축할 필요가 없었습니다. Ringflow가 이를 처리하고 대기 시간이 정말 인상적입니다.

검증된 고객
N

나디아 유수포바

CTO, Orbis 소매 — 두바이

당사의 SMS 대량 엔드포인트는 문제 없이 매일 50,000개의 주문 확인을 보냅니다. 배달 영수증은 몇 초 안에 웹훅에 도착합니다. 이는 소매업 운영에서 요구하는 것과 정확히 같습니다.

검증된 고객
T

톰 피츠제럴드

수석 백엔드 엔지니어, Lawbridge — 시카고 일리노이

가동 중지 시간이 없는 키 순환은 우리 보안 팀을 설득한 기능이었습니다. 유지 관리 기간 없이 API 키를 롤링하는 것은 이전 공급자가 할 수 없었던 일입니다.

검증된 고객
S

박수진

솔루션 설계자, Clearview SaaS — 서울

Go SDK는 관용적이며 모든 CI 실행 시 깔끔하게 컴파일됩니다. 컨텍스트 취소, 재시도 및 속도 제한 백오프는 일류 클라이언트의 작동을 기대하는 방식과 정확히 동일하게 작동합니다.

검증된 고객

FAQ

자주 묻는 질문

FAQ에 적극적으로 응답하면 사용자 신뢰도가 높아지고 지원 티켓이 줄어듭니다.

Ringflow 대시보드에 로그인하고 설정 → 개발자 → API 키로 이동한 후 새 키를 클릭하세요. 각 키는 특정 리소스(통화, 메시지, AI 또는 모두)로 범위가 지정되고 단일 작업 공간 환경에 연결됩니다.
예. 모든 Ringflow 계정에는 영구 샌드박스 환경이 포함되어 있습니다. 샌드박스 통화는 시뮬레이션된 통신업체 라우팅을 사용하므로 사용 요금이나 실제 전화선 없이 녹음, AI 접수자, 웹후크를 포함한 전체 통합을 테스트할 수 있습니다.
대부분의 경우 가입부터 실시간 통화까지 5분 이내입니다. 대시보드에서 번호를 프로비저닝하고 API 키를 복사한 후 /v2/calls에 POST합니다. 우리의 온보딩 가이드는 이를 단계별로 안내합니다.
모든 이벤트 POST에는 X-Ringflow-Signature-256 헤더(웹훅 비밀로 입력된 원시 요청 본문의 HMAC-SHA256 다이제스트)가 포함되어 있습니다. Node.js와 Python SDK 모두 verifySignature() 유틸리티를 제공하므로 이를 직접 구현할 필요가 없습니다.
Ringflow는 작업 공간 수준에서 미국 및 EU 데이터 상주 지역을 제공합니다. 비즈니스 제휴 계약은 의료 사용 사례를 위한 Business 및 Enterprise 플랜에서 사용할 수 있습니다. 전체 보안 문서 패키지를 원하시면 저희 팀에 문의하세요.
AI Receptionist는 Business 및 Enterprise 요금제에 포함되어 있습니다. 샌드박스 및 스타터 계정에는 통합 테스트를 위해 AI 엔드포인트에 대한 읽기 액세스 권한이 있지만 실시간 AI 호출을 처리하려면 활성 Business 또는 Enterprise 구독이 필요합니다.

음성, SMS, AI — 점심 식사 전에 모두 연결되었습니다.

무료 평가판 · 카드 없음 · 무료 번호 이전 · 서비스 수준 계약 지원 가동 시간

개발자를 위한 REST API 참조 · JSON 및 HTTPS · Ringflow