Panoramica di Voice

Bird Voice ti consente di chiamare numeri di telefono e rispondere alle chiamate verso i numeri che possiedi. Collega un sistema telefonico tramite SIP, effettua una chiamata dal browser o usa il builder di sequenze per eseguire un flusso di chiamata salvato. Bird collega le chiamate alla rete telefonica pubblica, la PSTN.

La connessione tra il tuo sistema telefonico e Bird è un trunk SIP. SIP (Session Initiation Protocol) stabilisce le chiamate tra sistemi telefonici. Bird assegna al tuo spazio di lavoro un indirizzo trunk, che il tuo sistema telefonico usa per le chiamate in uscita verso la rete telefonica, e che Bird usa in direzione opposta per consegnare le chiamate in arrivo sui tuoi numeri.

Non ti serve un sistema telefonico per effettuare la prima chiamata: il telefono nella dashboard ne avvia una direttamente dal browser, attraverso uno dei tuoi trunk.

Puoi anche creare una sequenza nella dashboard e avviarla con la API Create Call. La sequenza gestisce i messaggi vocali, le scelte da tastiera e l'instradamento della chiamata dopo che il destinatario risponde.

Come viene effettuata una chiamata

Il tuo sistema telefonico invia un SIP INVITE all'indirizzo del trunk per avviare una chiamata. Bird verifica l'ID chiamante, il paese di destinazione, i limiti e il saldo del portafoglio prima di contattare un operatore. Se la chiamata supera i controlli, Bird la instrada e trasmette l'audio. Ogni connessione è un leg. Quando un leg termina, Bird scrive il relativo record in Voice > Legs ed emette un voice_call.ended evento.

Una chiamata che non supera un controllo viene rifiutata prima che un operatore sia coinvolto, e il motivo specifico viene registrato nel record del leg. Effettuare chiamate descrive ciò che Bird legge da ogni chiamata, e Chiamate rifiutate elenca ogni motivo di rifiuto e come risolverlo.

Come si risponde a una chiamata in entrata

Un numero del tuo spazio di lavoro ha una sola risposta alla volta, impostata sul numero stesso o, se il numero non ne ha una, presa dall'instradamento predefinito dello spazio di lavoro: consegnare la chiamata a uno dei tuoi trunk SIP, inoltrarla a un numero che hai verificato, eseguire una sequenza pubblicata, far squillare un ring group di persone online nel telefono del browser oppure rifiutarla. L'instradamento predefinito è inizialmente impostato su rifiuto, quindi un numero che nessuno ha configurato respinge i chiamanti.

Quando arriva una chiamata, Bird controlla i limiti dell'account e il portafoglio come per una chiamata in uscita, poi agisce in base alla risposta del numero e registra quale risposta è stata applicata. Ricevere chiamate spiega come assegnare una risposta a un numero, cosa mostra un inoltro a chi risponde e come leggere un rifiuto.

Prima della tua prima chiamata

Per le chiamate tramite la tua apparecchiatura SIP, prepara quanto segue. Per le chiamate tramite API, segui i prerequisiti di Create Call.

• Crea un trunk SIP, attiva le chiamate in uscita e autorizza chi può usarlo per chiamare: un intervallo IP o una chiave API per la tua apparecchiatura, credenziali di sessione per un browser o la CLI.
• Scegli un ID chiamante idoneo: usa un numero che il tuo spazio di lavoro possiede tramite Bird, oppure registra un numero esterno e confermalo con una chiamata di verifica.
• Abilita le tue destinazioni: attiva i paesi verso cui chiami.

Effettua la tua prima chiamata ti guida attraverso tutti e tre i requisiti e termina con una chiamata reale.

Leggere i record delle chiamate richiede voice:read; effettuare chiamate richiede voice:write. La gestione di trunk, instradamenti dei numeri, caller ID e sequenze usa i permessi voice_management. L'accesso a una pagina non concede il permesso di modificarne le impostazioni né di effettuare una chiamata fatturabile.

L'app Voice nella dashboard

Visibilità

Una chiamata può contenere più leg. Il registro contiene un record per ogni leg, sia che la connessione sia riuscita, sia che il leg sia rimasto senza risposta o sia stato rifiutato. Le chiamate inoltrate o con più partecipanti possono quindi avere più voci:

• Registro dei segmenti: la vista dei singoli segmenti nella pagina Legs. Mostra lo stato, entrambi i numeri, il trunk su cui è arrivato il segmento, la risposta SIP con cui si è concluso, gli orari di risposta e fine, il tempo fatturabile e il costo. Applica i filtri, poi esporta i record corrispondenti in formato CSV. Il CSV include le durate e il tempo fatturabile, ma non ha una colonna per il costo; consulta gli addebiti in Utilizzo, spesa e fatture.
• Eventi Voice: voice_call.initiated, voice_call.answered e voice_call.ended consegnati al tuo endpoint, così i tuoi sistemi vengono informati di una chiamata senza polling.

Il riferimento API elenca i contratti HTTP pubblici supportati e i metodi SDK. Il riferimento CLI e il riferimento tool MCP descrivono le operazioni pubblicate. Queste superfici possono esporre operazioni diverse; un'azione nella dashboard o un comando CLI non stabilisce di per sé un metodo SDK pubblico.

Limiti

Alle tue chiamate, in entrambe le direzioni, si applicano tre limiti: quante possono essere in corso contemporaneamente, quante nuove chiamate puoi avviare al secondo e quanto puoi spendere per le chiamate vocali in un giorno UTC. Il tuo piano Voice stabilisce i limiti di chiamate simultanee e al secondo per la tua organizzazione: il piano a consumo usa i valori predefiniti, mentre i piani Voice superiori li aumentano. Il limite di spesa giornaliero funziona diversamente. Ogni spazio di lavoro imposta il proprio limite in Voice > Spend limit e quello per paese in Voice > Destinations, fino al massimo previsto per l'organizzazione. I piani Voice più ampi aumentano questo massimo. Una chiamata che supera uno di questi limiti viene rifiutata in fase di avvio e il relativo record indica quale limite è stato superato, come descritto in Chiamate rifiutate. I valori di ciascun piano sono riportati nella pagina dei prezzi di Voice; per passare a un piano superiore, vai in Billing and payments > Overview.

La durata massima di una chiamata sulla piattaforma è di 4 ore. Bird interrompe la chiamata per entrambe le parti quando raggiunge questa durata, quindi suddividi le sessioni più lunghe in più chiamate. Per una chiamata che esegue una sequenza di chiamata, il conteggio inizia quando Bird la accetta o la riceve. Anche il tempo di attesa prima della composizione e quello durante gli squilli rientrano quindi nelle 4 ore. Stati spiega come viene visualizzata una chiamata di questo tipo nel registro.

La soglia al secondo è la policy voice_call descritta in Limitazione delle richieste, che spiega anche come viene determinato il tuo limite effettivo e come aumentarlo.

Prossimi passi