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.
curl -X POST https://api.ringflow.com/v2/calls \
-H "Authorization: Bearer $RINGFLOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155550199",
"from": "+19172544289",
"recordDualChannel": true,
"aiReceptionistId": "agent_rfw_support"
}'
# 201 Created
{
"id": "call_rfw_2Kj8mNpQ",
"status": "ringing",
"to": "+14155550199",
"recording": true,
"ai": true
}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.
- 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
- 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
- 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
- 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
- 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
- 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
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.
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_2Kj8mNpQFö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.
| Planera | Oavbruten | Sprängd mössa | Samtidiga samtal |
|---|---|---|---|
| Sandlåda | 5 krav/s | 15 krav/s | 2 samtal |
| Starter | 40 krav/s | 80 krav/s | 25 samtal |
| Företag | 150 req/s | 300 req/s | 150 samtal |
| FöretagBeställnings | Beställnings | Beställnings | Obegränsat |
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åga | Ringflow | Typiskt 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.
FAQ
Vanliga frågor
Att proaktivt svara på vanliga frågor ökar användarnas förtroende och minskar antalet supportbiljetter.
Röst, SMS och AI – allt kopplat upp före lunch.
Gratis provperiod · Inget kort · Gratis nummerportering · servicenivåavtalsbackad drifttid
