Flusso ad anello
API REST Ringflow · v2

Una API per le chiamate, SMS e intelligenza artificiale — pensato per i team moderni.

L'API REST di Ringflow ti offre il controllo programmatico su ogni parte del tuo stack di comunicazione: chiamate in uscita, SMS in blocco, registrazioni a doppio canale, agenti AI Receptionist e webhook di eventi in tempo reale, il tutto dietro un singolo endpoint autenticato.

Sandbox permanente gratuito5 minuti alla prima chiamata dal vivoLivello API supportato dal contratto di servizio
API supportata dal contratto di servizio·Sicurezza aziendale·BAA disponibile·Redazione della registrazione delle chiamate·Firma degli eventi HMAC·Residenza dei dati nell'UE e negli Stati Uniti
Riferimento API

Tutto ciò di cui hai bisogno, niente di superfluo.

Sei gruppi di risorse, un URL di base, uno schema di autenticazione. Ogni endpoint ha una versione, restituisce JSON coerente e viene fornito con esempi di richiesta/risposta nel file riferimento completo.

Chiamate vocali
  • INVIARE/v2/chiamateEffettua chiamate in uscita a qualsiasi numero
  • OTTENERE/v2/chiamate/:idRecupera stato in tempo reale, durata e registrazione
  • INVIARE/v2/calls/:id/transferTrasferimento caldo o freddo durante la chiamata
  • ELIMINARE/v2/chiamate/:idTermina immediatamente una chiamata attiva
SMS e MMS
  • INVIARE/v2/messaggiInvia SMS o MMS a un singolo destinatario
  • INVIARE/v2/messaggi/bulkRaggruppa fino a 1 000 messaggi per richiesta
  • OTTENERE/v2/messaggi/:idVerifica lo stato di consegna e la ricevuta del corriere
Registrazioni
  • INVIARE/v2/chiamate/:id/recordAvvia la registrazione delle chiamate a doppio canale
  • ELIMINARE/v2/chiamate/:id/recordInterrompe la registrazione e attiva l'archiviazione
  • INVIARE/v2/registrazioni/:id/transcribeRichiedi la trascrizione AI asincrona
Receptionist dell'AI
  • INVIARE/v2/ai/agentiFornire un nuovo receptionist AI
  • METTERE/v2/ai/agents/:id/conoscenzaInvia domande frequenti, documenti e regole di escalation
  • OTTENERE/v2/ai/sessions/:id/summaryRecupera il riepilogo AI post-chiamata
Eventi
  • INVIARE/v2/eventi/abbonamentiIscriviti a qualsiasi evento della piattaforma
  • OTTENERE/v2/eventi/abbonamentiElenca e filtra i tuoi abbonamenti
  • ELIMINARE/v2/events/subscriptions/:idRimuovere un abbonamento a un evento
Autenticazione e chiavi
  • INVIARE/v2/autenticazione/tokenEmettere token al portatore di breve durata
  • INVIARE/v2/auth/keysCrea la chiave API dell'area di lavoro con ambito
  • METTERE/v2/auth/keys/:id/rotateRotazione della chiave senza tempi di inattività
SDK del cliente

Client idiomatici per il tuo stack.

Ogni SDK Ringflow è costruito prima del codice, non generato da una specifica. I nuovi tentativi, i cursori di impaginazione e la verifica del webhook sono di prima classe, non ripensamenti.

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
Nuovi tentativi intelligenti con jitter
Impaginazione basata sul cursore
Verifica della firma integrata
Copertura TypeScript al 100%.
Limiti di tariffa

Limiti prevedibili a ogni livello.

I limiti vengono applicati per area di lavoro, non per IP. Ogni risposta porta con sé X-RateLimit-Remaining, Reimpostazione del limite di frequenza X, e a Riprova dopo intestazione attiva 429 così puoi fare marcia indietro con grazia.

PianoSostenutoTappo scoppiatoChiamate simultanee
Sabbiera5 richieste/s15 richieste/s2 chiamate
Antipasto40 richieste/s80 richieste/s25 chiamate
Attività commerciale150 richieste/s300 richieste/s150 chiamate
ImpresaCostumeCostumeCostumeIllimitato
Perché Ringflow

Costruito in modo diverso. Prezzo giusto.

Maggior parte API di telefonia attivare l'intelligenza artificiale come ripensamento. Ringflow ha creato intelligenza artificiale, voce e messaggistica da zero come un'unica API coerente, in modo da non dover collegare tre fornitori insieme con il nastro adesivo.

CapacitàFlusso ad anelloAlternativa tipica
Chiamate unificate + SMS + AI in un'unica API
Sandbox permanente: nessuna scadenza, nessuna carta
Registrazione a doppio canale pronta all'uso
Receptionist AI tramite endpoint REST
Consegne webhook firmate HMAC
Rotazione della chiave API senza tempi di inattività
Audit di sicurezza aziendale + BAA disponibili

Il nostro impegno

Un'API REST costruita secondo gli standard di produzione.

L'API di Ringflow è progettata per gestire carichi di lavoro di produzione reali: risposte JSON coerenti, autenticazione forte, segnalazione chiara dei limiti di velocità e un sandbox permanente per test di integrazione sicuri.

Risposte JSON
Autenticazione OAuth 2.0
Intestazioni dei limiti di velocità
Chiavi di idepotenza
Il webhook tenta nuovamente
Endpoint con versione
Tempo di attività di 99 punti
Test in modalità sandbox

Amato dai team di ingegneri di tutti i settori.

Dall'assistenza sanitaria alla vendita al dettaglio: l'API di Ringflow alimenta le comunicazioni di produzione su larga scala.

A

Arjun Mehta

Responsabile dell'ingegneria, Zenia Salute – Mumbai

L'API di Ringflow ci ha consentito di integrare il triage vocale nel nostro portale pazienti in due settimane. Il solo endpoint AI Receptionist ha ridotto del 40% il volume delle nostre chiamate fuori orario.

Cliente verificato
R

Rachele Torres

Vicepresidente del prodotto, ClearLane Finanza — Austin TX

Abbiamo migrato tre fornitori di contact center su Ringflow in un trimestre. La superficie REST unificata ha reso la nostra integrazione semplice: un flusso di autenticazione, uno schema webhook, tutto.

Cliente verificato
B

Ben Hargreaves

Responsabile della piattaforma, StackRoute – Londra

La registrazione a doppio canale e gli endpoint di trascrizione asincrona ci hanno evitato di costruire la nostra pipeline vocale. Ringflow si limita a gestirlo e la latenza è davvero impressionante.

Cliente verificato
N

Nadia Yusupova

CTO, Vendita al dettaglio Orbis – Dubai

Il nostro endpoint di massa SMS invia 50.000 conferme d'ordine al giorno senza intoppi. Le ricevute di consegna arrivano nel nostro webhook in pochi secondi, esattamente ciò che richiedono le operazioni di vendita al dettaglio.

Cliente verificato
T

Tom Fitzgerald

Ingegnere back-end senior, Lawbridge-Chicago IL

La rotazione delle chiavi con tempi di inattività pari a zero è stata la caratteristica che ha convinto il nostro team di sicurezza. Il rollio delle chiavi API senza una finestra di manutenzione è qualcosa che il nostro vecchio provider semplicemente non poteva fare.

Cliente verificato
S

Parco Soo-Jin

Architetto di soluzioni, Clearview SaaS – Seul

L'SDK Go è idiomatico e si compila in modo pulito ad ogni esecuzione CI. La cancellazione del contesto, i nuovi tentativi e il back-off del limite di velocità funzionano esattamente come ci si aspetterebbe che si comportasse un client di prima classe.

Cliente verificato

Domande frequenti

Domande frequenti

Rispondere in modo proattivo alle domande frequenti aumenta la fiducia degli utenti e riduce i ticket di supporto.

Accedi alla dashboard di Ringflow, vai su Impostazioni → Sviluppatore → Chiavi API e fai clic su Nuova chiave. Ogni chiave è limitata a risorse specifiche (chiamate, messaggi, intelligenza artificiale o tutto) ed è legata a un singolo ambiente di lavoro.
SÌ. Ogni account Ringflow include un ambiente Sandbox permanente. Le chiamate sandbox utilizzano il routing simulato dell'operatore, così puoi testare la tua integrazione completa, comprese registrazioni, receptionist AI e webhook, senza costi di utilizzo o una linea telefonica reale.
Nella maggior parte dei casi, meno di 5 minuti dall'iscrizione a una chiamata dal vivo. Fornisci un numero nella dashboard, copia la chiave API e POST su /v2/calls. La nostra guida onboarding lo segue passo dopo passo.
Ogni POST di evento include un'intestazione X-Ringflow-Signature-256: un digest HMAC-SHA256 del corpo della richiesta non elaborata codificato con il segreto del webhook. Sia gli SDK Node.js che quelli Python espongono un'utilità verifySignature() quindi non dovrai mai implementarla tu stesso.
Ringflow offre regioni di residenza dei dati negli Stati Uniti e nell'UE a livello di area di lavoro. I contratti di società in affari sono disponibili sui piani Business ed Enterprise per casi d'uso nel settore sanitario. Contatta il nostro team per il pacchetto completo di documentazione sulla sicurezza.
AI Receptionist è incluso nei piani Business ed Enterprise. Gli account Sandbox e Starter hanno accesso in lettura agli endpoint AI per i test di integrazione, ma la gestione delle chiamate AI in tempo reale richiede un abbonamento Business o Enterprise attivo.

Voce, SMS e intelligenza artificiale: tutto collegato prima di pranzo.

Prova gratuita · Nessuna carta · Portabilità gratuita del numero · Tempo di attività supportato dal contratto sul livello di servizio

Riferimento API REST per sviluppatori · JSON e HTTPS · Ringflow