Voce programmabile in JSON. Chiamate, IVR, registrazione, TTS.
Voice per sviluppatori: copertura vocale in oltre 140 paesi, più di 1.500 prefissi telefonici, chiamate mascherate, numeri virtuali. Stessa interfaccia API di Email e SMS: le chiamate sono semplicemente un'altra risorsa.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.voice.calls.create({
to: "+15005550010",
from: "+14155550199",
flow: [
{ say: "Your verification code is..." },
{ say: "4. 2. 9. 1. 7." },
{ gather: { digits: 1, timeout: 5 } },
{ record: { transcribe: true } },
],
}).safe();
if (error) throw error;
console.log(data.id);
// → "call_7tQ04Lp2n..."
Bird Verify
+1 (500) 555-0010
Yourverificationcodeisfourtwonineoneseven.
5 minutes from npm install to first call
Effettua una chiamata dal linguaggio che già utilizzi.
SDK per ogni runtime principale. La prima chiamata va a un numero di test autorizzato (+15005550010) così puoi integrare un controllo CI prima di configurare un numero reale.
Code samples arrive when this API ships. The SDKs already cover the live channels.
Dieci componenti vocali che preferiresti non scrivere da solo.
Routing operatore, controllo chiamata e primitive di osservabilità, con nome e verificabili.
- 01
Chiamate in uscita e in entrata
Effettua e ricevi chiamate tramite REST o SIP: stesso modello di autenticazione, stesso contratto di idempotenza.
- 02
Flussi di chiamata dichiarativi in JSON
Componi say, play, gather, record, transfer e dial come un array JSON piatto.
- 03
Registrazione con trascrizione
Registrazione opzionale su qualsiasi tratta; trascrizioni generate automaticamente in oltre 40 lingue.
- 04
TTS in streaming, sotto i 250 ms
Audio dal primo byte tramite HTTP chunked transfer o WebSocket, fatturato per carattere.
- 05
OTP vocale tramite verifiche
Stessa risorsa bird.verifications dell'OTP via SMS; cambia il campo channel.
- 06
Numeri virtuali in oltre 100 paesi
Configura numeri long code dalla dashboard o dall'API numbers in pochi secondi.
- 07
Chiamate mascherate
I numeri del chiamante e del destinatario non vengono mai esposti reciprocamente: privacy by routing.
- 08
SmartRouting per chiamata
Operatore a costo minimo selezionato in tempo reale per ogni tratta, con riselezione del percorso in caso di errore.
- 09
Eventi webhook per chiamata
call.ringing, call.answered, call.completed e simili: firmati con HMAC, protetti da replay.
- 10
SDK client WebRTC
Bridge browser-PSTN da un singolo pacchetto npm; funziona in qualsiasi runtime moderno.
Perché abbiamo creato Voice
La voce è il canale che tutti trattano come un ripensamento. Noi no.
La voce è complessa — latenza sotto il secondo, routing reale su operatore, conformità delle registrazioni — ed è per questo che la maggior parte dei fornitori le assegna un'autenticazione propria, un SDK proprio, un contratto webhook proprio. Noi ci siamo presi il tempo di modellarla come ogni altro endpoint Bird: stessa autenticazione, stessa idempotenza, stesso formato errori. Il controllo chiamate è solo JSON.
Ogni cambio di stato è un webhook.
Payload firmati con HMAC, protetti da replay, idempotenti. Lo stesso formato su ogni canale Bird: imparane uno e li conosci tutti.
Pianificazione dei tentativi: 5s, 30s, 5m, 30m, 2h, 6h, 12h. Dead-letter dopo l'ultimo tentativo; ogni evento in dead-letter è riproducibile dalla dashboard o dall'API.
call.queuedAccettata dall'API e accodata per la chiamata in uscita.call.ringingLa linea ricevente sta squillando: stato di pre-risposta.call.answeredIl destinatario ha risposto; la fatturazione inizia con questo evento.call.completedLa chiamata si è conclusa normalmente: durata e prezzo nel payload.call.failedErrore permanente (occupato, nessuna risposta, rifiuto operatore) con motivazione tipizzata.call.recording.readyLa registrazione è codificata e disponibile all'URL firmato nel payload.call.transcript.readyTrascrizione completata; il payload include lingua e segmenti.
L'OTP vocale è la stessa risorsa dell'OTP via SMS.
Effettua una chiamata personalizzata o affida la verifica al runtime. Stessa autenticazione, stessa idempotenza, stesso formato di errore: il campo canale è l'unica cosa che cambia.
Chiamata personalizzata.
Componi qualsiasi flusso — say, gather, transfer — per i casi in cui vuoi lo script nel tuo codice.
Verifiche.
Una riga. Bird sceglie il percorso, esegue il controllo antifrode, invia il prompt audio. Stesso codice su ogni canale.