Ringflow
Ringflow REST API · v2

Ett API för samtal, SMS och AI — byggd för moderna team.

Ringflows REST API ger dig programmatisk kontroll över varje del av din kommunikationsstack – utgående samtal, bulk-SMS, dubbelkanalsinspelningar, AI Receptionist-agenter och realtidshändelsewebhooks – allt bakom en enda autentiserad slutpunkt.

Gratis permanent sandlåda5 minuter till första livesamtaletAPI-lager med stöd för servicenivåavtal
Service Level Agreement-Backed API·Företagssäkerhet·BAA tillgänglig·Redaktion av samtalsinspelning·HMAC Event Signering·EU och USA Data Residency
API-referens

Allt du behöver, inget du inte behöver.

Sex resursgrupper, en bas-URL, ett autentiseringsschema. Varje slutpunkt är versionerad, returnerar konsekvent JSON och skickas med exempel på begäran/svar i fullständig referens.

Röstsamtal
  • POST/v2/calls— Ring utgående samtal till valfritt nummer
  • GET/v2/calls/:id— Hämta livestatus, varaktighet och inspelning
  • POST/v2/calls/:id/transfer— Varm eller kall överföring mitt i samtalet
  • DELETE/v2/calls/:id— Avsluta ett aktivt samtal omedelbart
SMS & MMS
  • POST/v2/messages— Skicka SMS eller MMS till en enda mottagare
  • POST/v2/messages/bulk— Gruppera upp till 1 000 meddelanden per begäran
  • GET/v2/messages/:id— Omröstningsleveransstatus och operatörskvitto
Inspelningar
  • POST/v2/calls/:id/record— Starta samtalsinspelning med två kanaler
  • DELETE/v2/calls/:id/record— Stoppa inspelningen och aktivera lagring
  • POST/v2/recordings/:id/transcribe— Begär asynkron AI-transkription
AI Receptionist
  • POST/v2/ai/agents— Tillhandahålla en ny AI-receptionist
  • PUT/v2/ai/agents/:id/knowledge— Push FAQs, docs & eskalation regler
  • GET/v2/ai/sessions/:id/summary— Hämta AI-sammanfattning efter samtal
Händelser
  • POST/v2/events/subscriptions— Prenumerera på vilket plattformsevenemang som helst
  • GET/v2/events/subscriptions— Lista och filtrera dina prenumerationer
  • DELETE/v2/events/subscriptions/:id— Ta bort en händelseprenumeration
Auth & Keys
  • POST/v2/auth/tokens— Ge ut kortlivad bärartoken
  • POST/v2/auth/keys— Skapa API-nyckel för scoped workspace
  • PUT/v2/auth/keys/:id/rotate— Noll-avbrottstid nyckelrotation
Klient-SDK:er

Idiomatiska klienter för din stack.

Varje Ringflow SDK byggs kod-först - inte genererad från en spec. Återförsök, pagineringsmarkörer och webhook-verifiering är förstklassiga, inte eftertanke.

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
Smarta försök igen med jitter
Markörbaserad paginering
Inbyggd signaturverifiering
100 % TypeScript-täckning
Prisgränser

Förutsägbara gränser på varje nivå.

Gränser tillämpas per arbetsyta, inte per IP. Varje svar bär X-RateLimit-Remaining, X-RateLimit-Reset, och en Retry-After header på 429s så att du kan backa graciöst.

PlaneraOavbrutenSprängd mössaSamtidiga samtal
Sandlåda5 krav/s15 krav/s2 samtal
Starter40 krav/s80 krav/s25 samtal
Företag150 req/s300 req/s150 samtal
FöretagBeställningsBeställningsBeställningsObegränsat
Varför Ringflow

Byggd annorlunda. Prissatt rättvist.

Mest telefoni API:er skruva på AI som en eftertanke. Ringflow byggde AI, röst och meddelanden från grunden som ett enda sammanhängande API – så att du inte kan tejpa tre leverantörer tillsammans.

FörmågaRingflowTypiskt alternativ
Unified calling + SMS + AI i ett API✕
Permanent sandlåda — inget utgångsdatum, inget kort✕
Dubbelkanalsinspelning ur kartongen✕
AI-receptionist via REST-slutpunkt✕
HMAC-signerade webhook-leveranser
API-nyckelrotation utan driftstopp✕
Företagssäkerhetsrevision + BAA tillgänglig✕

Vårt engagemang

Ett REST API byggt efter produktionsstandarder.

Ringflows API är designat för att hantera verkliga produktionsbelastningar – konsekventa JSON-svar, stark autentisering, tydlig signalering av hastighetsgränser och en permanent sandlåda för säker integrationstestning.

JSON-svar
OAuth 2.0 auth
Rate limit headers
Idempotensnycklar
Webhook försöker igen
Versionerade slutpunkter
99-punkters drifttid
Sandlådetestning

FAQ

Vanliga frågor

Att proaktivt svara på vanliga frågor ökar användarnas förtroende och minskar antalet supportbiljetter.

Logga in på din Ringflow-instrumentpanel, navigera till Inställningar → Utvecklare → API-nycklar och klicka på Ny nyckel. Varje nyckel är anpassad till specifika resurser (samtal, meddelanden, AI eller alla) och knuten till en enda arbetsmiljö.
Ja. Varje Ringflow-konto inkluderar en permanent Sandbox-miljö. Sandlådesamtal använder simulerad operatörsrouting, så att du kan testa din fullständiga integration – inklusive inspelningar, AI-receptionist och webhooks – utan några användningsavgifter eller en riktig telefonlinje.
Under 5 minuter från registrering till ett livesamtal i de flesta fall. Ange ett nummer i instrumentpanelen, kopiera din API-nyckel och POST till /v2/calls. Vår onboardingguide går igenom det steg för steg.
Varje POST-evenemang inkluderar en X-Ringflow-Signature-256-header — en HMAC-SHA256-sammanfattning av den råa begärandekroppen med din webhook-hemlighet. Både Node.js och Python SDK exponerar ett verifySignature()-verktyg så att du aldrig behöver implementera detta själv.
Ringflow erbjuder datauppehållsregioner i USA och EU på arbetsplatsnivå. Affärspartneravtal finns tillgängliga på affärs- och företagsplaner för sjukvårdsanvändning. Kontakta vårt team för hela säkerhetsdokumentationspaketet.
AI Receptionist ingår i affärs- och företagsplaner. Sandbox- och Starter-konton har läsåtkomst till AI-slutpunkterna för integrationstestning, men hantering av live AI-samtal kräver ett aktivt Business- eller Enterprise-abonnemang.

Röst, SMS och AI – allt kopplat upp före lunch.

Gratis provperiod · Inget kort · Gratis nummerportering · servicenivåavtalsbackad drifttid