Ringflow
Ringflow REST API · v2

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

Mit der REST-API von Ringflow haben Sie programmgesteuerte Kontrolle über jeden Teil Ihres Kommunikationsstapels – ausgehende Anrufe, Massen-SMS, Dual-Channel-Aufzeichnungen, AI Receptionist-Agenten und Echtzeit-Ereignis-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/calls— Ausgehenden Anruf an eine beliebige Nummer tätigen
  • GET/v2/calls/:id— Live-Status, Dauer und Aufzeichnung abrufen
  • POST/v2/calls/:id/transfer— Warm- oder Kaltweiterleitung während des Anrufs
  • DELETE/v2/calls/:id— Beenden Sie einen aktiven Anruf sofort
SMS & MMS
  • POST/v2/messages— Senden Sie SMS oder MMS an einen einzelnen Empfänger
  • POST/v2/messages/bulk— Stapeln Sie bis zu 1.000 Nachrichten pro Anfrage
  • GET/v2/messages/:id— Lieferstatus und Spediteurbeleg abfragen
Aufnahmen
  • POST/v2/calls/:id/record— Starten Sie die Zweikanal-Anrufaufzeichnung
  • DELETE/v2/calls/:id/record— Aufzeichnung stoppen und Speicherung auslösen
  • POST/v2/recordings/:id/transcribe— Fordern Sie eine asynchrone KI-Transkription an
AI Receptionist
  • POST/v2/ai/agents— Stellen Sie eine neue KI-Rezeptionistin bereit
  • PUT/v2/ai/agents/:id/knowledge— Push-FAQs, Dokumente und Eskalationsregeln
  • GET/v2/ai/sessions/:id/summary— Rufen Sie die KI-Zusammenfassung nach dem Anruf ab
Veranstaltungen
  • POST/v2/events/subscriptions— Abonnieren Sie ein beliebiges Plattform-Event
  • GET/v2/events/subscriptions— Listen Sie Ihre Abonnements auf und filtern Sie sie
  • DELETE/v2/events/subscriptions/:id— Entfernen Sie ein Veranstaltungsabonnement
Authentifizierung und Schlüssel
  • POST/v2/auth/tokens— Geben Sie ein kurzlebiges Inhaber-Token aus
  • POST/v2/auth/keys— Erstellen Sie einen bereichsbezogenen Arbeitsbereichs-API-Schlüssel
  • PUT/v2/auth/keys/:id/rotate— Schlüsselrotation ohne Ausfallzeiten
Client-SDKs

Idiomatische Clients für Ihren Stack.

Jedes Ringflow SDK wird zuerst im Code erstellt und nicht aus 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 Retry-After 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 mit Klebeband zusammenkleben.

FähigkeitRingflowTypische 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 echter 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 innerhalb von zwei Wochen die Sprachtriage 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 schafft es 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 es 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