Ringfluss
Ringflow REST API · v2

Eine API für Aufrufe, SMS und KI – für moderne Teams entwickelt.

Mit der REST-API von Ringflow erhalten Sie programmatische Kontrolle über jeden Teil Ihres Kommunikationsstapels – ausgehende Anrufe, Massen-SMS, Dual-Channel-Aufzeichnungen, AI Receptionist-Agenten und Echtzeit-Event-Webhooks – alles hinter einem einzigen authentifizierten Endpunkt.

Kostenlose permanente Sandbox5 Minuten bis zum ersten Live-AnrufService-Level-Agreement-gestützte API-Schicht
Service-Level-Agreement-gestützte API·Unternehmenssicherheit·BAA verfügbar·Schwärzung der Anrufaufzeichnung·HMAC-Ereignisunterzeichnung·Datenresidenz in der EU und den USA
API-Referenz

Alles, was Sie brauchen, nichts, was Sie nicht brauchen.

Sechs Ressourcengruppen, eine Basis-URL, ein Authentifizierungsschema. Jeder Endpunkt ist versioniert, gibt konsistentes JSON zurück und wird mit Anforderungs-/Antwortbeispielen im ausgeliefert vollständige Referenz.

Sprachanrufe
  • POST/v2/callsAusgehenden Anruf an eine beliebige Nummer tätigen
  • ERHALTEN/v2/calls/:idLive-Status, Dauer und Aufzeichnung abrufen
  • POST/v2/calls/:id/transferWarm- oder Kaltweiterleitung während des Anrufs
  • LÖSCHEN/v2/calls/:idBeenden Sie einen aktiven Anruf sofort
SMS & MMS
  • POST/v2/messagesSenden Sie SMS oder MMS an einen einzelnen Empfänger
  • POST/v2/messages/bulkStapeln Sie bis zu 1.000 Nachrichten pro Anfrage
  • ERHALTEN/v2/messages/:idLieferstatus und Spediteurbeleg abfragen
Aufnahmen
  • POST/v2/calls/:id/recordStarten Sie die Zweikanal-Anrufaufzeichnung
  • LÖSCHEN/v2/calls/:id/recordAufzeichnung stoppen und Speicherung auslösen
  • POST/v2/recordings/:id/trancribeFordern Sie eine asynchrone KI-Transkription an
KI-Rezeptionistin
  • POST/v2/ai/agentsStellen Sie eine neue KI-Rezeptionistin bereit
  • SETZEN/v2/ai/agents/:id/knowledgePush-FAQs, Dokumente und Eskalationsregeln
  • ERHALTEN/v2/ai/sessions/:id/summaryRufen Sie die KI-Zusammenfassung nach dem Anruf ab
Veranstaltungen
  • POST/v2/events/subscriptionsAbonnieren Sie ein beliebiges Plattform-Event
  • ERHALTEN/v2/events/subscriptionsListen Sie Ihre Abonnements auf und filtern Sie sie
  • LÖSCHEN/v2/events/subscriptions/:idEntfernen Sie ein Veranstaltungsabonnement
Authentifizierung und Schlüssel
  • POST/v2/auth/tokensGeben Sie ein kurzlebiges Inhaber-Token aus
  • POST/v2/auth/keysErstellen Sie einen bereichsbezogenen Arbeitsbereichs-API-Schlüssel
  • SETZEN/v2/auth/keys/:id/rotateSchlüsselrotation ohne Ausfallzeiten
Client-SDKs

Idiomatische Clients für Ihren Stack.

Jedes Ringflow SDK wird zuerst im Code erstellt und nicht anhand einer Spezifikation generiert. Wiederholungsversuche, Paginierungscursor und Webhook-Überprüfung sind erstklassig und keine nachträglichen Einfälle.

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
Intelligente Wiederholungsversuche mit Jitter
Cursorbasierte Paginierung
Integrierte Signaturüberprüfung
100 % TypeScript-Abdeckung
Tarifbegrenzungen

Vorhersehbare Grenzen auf jeder Stufe.

Beschränkungen werden pro Arbeitsbereich und nicht pro IP erzwungen. Jede Antwort trägt X-RateLimit-Remaining, X-RateLimit-Reset, und a Wiederholen-Nachdem Kopfzeile an 429s damit Sie sich in Würde zurückziehen können.

PlanenNachhaltigBerstkappeGleichzeitige Anrufe
Sandkasten5 Anforderungen/s15 Anforderungen/s2 Anrufe
Anlasser40 Anforderungen/s80 Anforderungen/s25 Anrufe
Geschäft150 Anforderungen/s300 Anforderungen/s150 Anrufe
UnternehmenBrauchBrauchBrauchUnbegrenzt
Warum Ringflow

Anders gebaut. Preislich fair.

Am meisten Telefonie-APIs KI nachträglich einbauen. Ringflow hat KI, Sprache und Messaging von Grund auf als eine einzige kohärente API entwickelt – Sie müssen also nicht drei Anbieter zusammenkleben.

FähigkeitRingflussTypische Alternative
Einheitlicher Anruf + SMS + KI in einer API
Permanente Sandbox – kein Ablaufdatum, keine Karte
Zweikanalige Aufnahme sofort einsatzbereit
KI-Rezeptionist über REST-Endpunkt
HMAC-signierte Webhook-Lieferungen
API-Schlüsselrotation ohne Ausfallzeiten
Unternehmenssicherheitsaudit + BAA verfügbar

Unser Engagement

Eine REST-API, die nach Produktionsstandards erstellt wurde.

Die API von Ringflow ist für die Bewältigung realer Produktions-Workloads konzipiert – konsistente JSON-Antworten, starke Authentifizierung, eindeutige Ratenbegrenzungssignalisierung und eine permanente Sandbox für sichere Integrationstests.

JSON-Antworten
OAuth 2.0-Authentifizierung
Rate-Limit-Header
Idempotenzschlüssel
Webhook-Wiederholungsversuche
Versionierte Endpunkte
99-Punkte-Verfügbarkeit
Sandbox-Tests

Geliebt von Ingenieurteams aller Branchen.

Vom Gesundheitswesen bis zum Einzelhandel – die API von Ringflow unterstützt die Produktionskommunikation im großen Maßstab.

A

Arjun Mehta

Leiter Technik, Zenia Health – Mumbai

Mit der API von Ringflow konnten wir die Sprachtriage innerhalb von zwei Wochen in unser Patientenportal einbetten. Allein der AI Receptionist-Endpunkt reduzierte unser Anrufvolumen außerhalb der Geschäftszeiten um 40 %.

Verifizierter Kunde
R

Rachel Torres

Vizepräsident für Produkt, ClearLane Finance – Austin TX

Wir haben in einem Quartal drei Contact-Center-Anbieter auf Ringflow migriert. Die einheitliche REST-Oberfläche machte unsere Integration unkompliziert – ein Authentifizierungsfluss, ein Webhook-Schema, alles.

Verifizierter Kunde
B

Ben Hargreaves

Plattformleiter, StackRoute – London

Die Zweikanal-Aufzeichnung und die asynchronen Transkriptionsendpunkte ersparten uns den Aufbau einer eigenen Sprachpipeline. Ringflow erledigt das einfach und die Latenz ist wirklich beeindruckend.

Verifizierter Kunde
N

Nadia Yusupova

CTO, Orbis Retail – Dubai

Unser SMS-Massenendpunkt sendet täglich 50.000 Bestellbestätigungen ohne Probleme. Lieferbelege landen innerhalb von Sekunden in unserem Webhook – genau das, was der Einzelhandel verlangt.

Verifizierter Kunde
T

Tom Fitzgerald

Leitender Backend-Ingenieur, Lawbridge – Chicago IL

Die Schlüsselrotation ohne Ausfallzeit war die Funktion, die unser Sicherheitsteam überzeugt hat. Das Rollen von API-Schlüsseln ohne Wartungsfenster war für unseren alten Anbieter einfach nicht möglich.

Verifizierter Kunde
S

Soo-Jin-Park

Lösungsarchitekt, Clearview SaaS – Seoul

Das Go SDK ist idiomatisch und wird bei jedem CI-Lauf sauber kompiliert. Kontextstornierung, Wiederholungsversuche und Ratenlimit-Backoff funktionieren genau so, wie Sie es von einem erstklassigen Client erwarten würden.

Verifizierter Kunde

FAQ

Häufig gestellte Fragen

Die proaktive Beantwortung von FAQs stärkt das Vertrauen der Benutzer und reduziert die Anzahl der Support-Tickets.

Melden Sie sich bei Ihrem Ringflow-Dashboard an, navigieren Sie zu Einstellungen → Entwickler → API-Schlüssel und klicken Sie auf Neuer Schlüssel. Jeder Schlüssel ist auf bestimmte Ressourcen (Anrufe, Nachrichten, KI oder alle) beschränkt und an eine einzelne Arbeitsbereichsumgebung gebunden.
Ja. Jedes Ringflow-Konto umfasst eine permanente Sandbox-Umgebung. Sandbox-Anrufe verwenden simuliertes Carrier-Routing, sodass Sie Ihre vollständige Integration – einschließlich Aufzeichnungen, AI Receptionist und Webhooks – ohne Nutzungsgebühren oder eine echte Telefonleitung testen können.
Von der Anmeldung bis zum Live-Anruf vergehen in den meisten Fällen weniger als 5 Minuten. Geben Sie im Dashboard eine Nummer an, kopieren Sie Ihren API-Schlüssel und posten Sie ihn per POST an /v2/calls. Unser Onboarding-Guide führt Sie Schritt für Schritt durch.
Jeder Ereignis-POST enthält einen X-Ringflow-Signature-256-Header – einen HMAC-SHA256-Digest des rohen Anforderungstexts, der mit Ihrem Webhook-Geheimnis verschlüsselt ist. Sowohl das Node.js- als auch das Python-SDK stellen ein Dienstprogramm „VerifySignature()“ bereit, sodass Sie dieses nie selbst implementieren müssen.
Ringflow bietet Datenresidenzregionen in den USA und der EU auf Workspace-Ebene. Business Associate Agreements sind für Business- und Enterprise-Pläne für Anwendungsfälle im Gesundheitswesen verfügbar. Kontaktieren Sie unser Team für das vollständige Sicherheitsdokumentationspaket.
AI Receptionist ist in den Business- und Enterprise-Plänen enthalten. Sandbox- und Starter-Konten haben Lesezugriff auf die KI-Endpunkte für Integrationstests, für die Live-KI-Anrufbearbeitung ist jedoch ein aktives Business- oder Enterprise-Abonnement erforderlich.

Sprache, SMS und KI – alles vor dem Mittagessen verkabelt.

Kostenlose Testversion · Keine Karte · Kostenlose Nummernportierung · Durch Service Level Agreement gesicherte Betriebszeit

REST-API-Referenz für Entwickler · JSON & HTTPS · Ringflow