FAQ Voice
Get straight answers on SIP trunks, AI voice agents, call routing, and billing.
See how to connect your PBX, verify caller IDs, automate inbound and outbound calls, and manage call limits before you go live. Pick a topic below or talk with our team about your call volume and destinations.
Trusted by engineering and product teams
shipping at global scale.
FAQ Voice
Cos'è Bird Voice?
Bird Voice connects your PBX, contact center, browser dialer, or AI voice agent to the global telephone network. You can place and receive calls over SIP trunks, automate IVR call sequences, record and transcribe conversations, and track call outcomes in real time.
Quanto velocemente posso effettuare la mia prima chiamata?
Quando il tuo spazio di lavoro ha un trunk SIP attivo, un ID chiamante verificato e un paese di destinazione abilitato, puoi andare online nel telefono integrato nel browser ed effettuare subito una chiamata di prova, senza configurare hardware SIP esterno.
Di cosa ho bisogno prima di poter chiamare?
You need three settings configured in your workspace: a SIP trunk that authorizes your equipment by IP address or API key, a verified caller ID to display on outbound calls, and the destination country enabled in your outbound allowlist. Bird provisions carrier routing for your workspace automatically.
Posso ricevere chiamate con Bird Voice?
Sì. Seleziona un numero di telefono abilitato alla voce nel tuo spazio di lavoro e assegnagli un instradamento in entrata. Puoi inviare le chiamate in arrivo a un trunk SIP con un gateway in entrata, eseguire una sequenza di chiamata pubblicata, far squillare un gruppo di squillo di colleghi nel telefono del browser oppure inoltrarle a un numero di telefono verificato. I numeri appena acquisiti rifiutano le chiamate in arrivo finché non assegni un instradamento.
Ho bisogno di hardware specifico?
No. You can place calls directly from the browser phone in the dashboard, or connect an existing SIP softphone, IP PBX, or voice application using standard SIP signaling and media settings.
Posso effettuare chiamate dal browser?
Sì. L'app Phone nella dashboard di Bird usa WebRTC, così il tuo team può rispondere alle chiamate dei gruppi di squillo ed effettuare chiamate in uscita dal browser, usando il trunk SIP e gli ID chiamante verificati del tuo spazio di lavoro per le chiamate in uscita.
Come vengono tariffate le chiamate vocali?
Calls are rated by destination country and numbering range. Each destination rate specifies a minimum billed duration followed by a rounding increment, so a rate with a one-minute minimum and six-second steps bills a ten-second answered call for one minute.
Quando inizia la fatturazione?
Billable talk time starts when the recipient answers and ends when either side hangs up. Unanswered calls do not incur talk-time charges, while phone number rentals and optional add-on services are billed according to the published rate card.
La voce è prepagata o postpagata?
Voice usage is prepaid from your organization's wallet, which your monthly Voice plan deposit also funds. Bird checks your available wallet balance before placing each call, and refuses calls up front for insufficient balance when funds cannot cover the attempt.
Esiste un limite di spesa giornaliero?
Yes. Each workspace has a configurable daily voice spend cap in the Voice settings, up to your organization's maximum, which resets at midnight UTC. Once daily spend reaches that cap, additional calls are refused for exceeding the daily spend limit until the cap is raised or the next UTC day begins. Higher Voice plans increase the organization maximum, and you can request a custom ceiling from our team.
Dove posso vedere il costo di una chiamata?
Open the call record in the dashboard call log to view the rated cost at full precision, excluding tax. To analyze spend across multiple calls, export your filtered call log as a CSV or review your workspace usage and invoices.
Quali limiti si applicano alle mie chiamate?
Voice traffic is governed by three independent caps: active calls in progress at the same time (concurrent calls), new call attempts started per second (calls per second), and total voice charges per UTC day (daily spend). Your Voice plan sets the concurrency, call-rate, and organization daily spend ceilings, while workspaces without a plan use pay-as-you-go defaults. Each workspace can also configure a lower daily spend cap within the organization ceiling.
Cosa succede quando raggiungo un limite?
Bird blocks the call during setup before dialing an upstream carrier. Your PBX receives a standard service-unavailable signaling response, while the call log records the exact limit that was reached (concurrent calls, calls per second, or daily spend) so you can adjust your pacing or capacity.
Posso aumentare i miei limiti?
Yes. Upgrading your Voice plan under Billing and payments in the dashboard raises your concurrent-call, calls-per-second, and daily spend ceilings as soon as payment clears. If your call volume exceeds the highest self-serve plan, contact sales with your expected concurrency, call pacing, and destination mix.
Un dialer per campagne viene rifiutato ma ho ampio margine di chiamate simultanee. Perché?
Inspect the rejection reason on the call record in the dashboard. An outbound dialer that launches a burst of calls at once can exceed your calls-per-second rate limit even while total active calls remain well below your concurrency cap. Pace your dialer's call initiation rate before retrying.
Devo sostituire il mio PBX?
No. Bird SIP trunks connect your existing IP PBX, SBC, or contact center platform to the telephone network using standard SIP transport, authentication, and audio codecs.
Un singolo trunk può gestire chiamate in entrata e in uscita?
Yes. You can configure outbound and inbound traffic on the same SIP trunk. To receive incoming calls on that trunk, enable inbound calling, configure a delivery gateway, and assign a voice-capable Bird number to the trunk.
Un'applicazione vocale AI può connettersi tramite SIP?
Yes. Any AI voice runtime that supports SIP signaling and RTP media can connect directly to a Bird SIP trunk. Your application manages speech recognition, model inference, and tool calls while Bird handles carrier connectivity.
Cosa succede se disabilito le chiamate in entrata?
Disabling inbound calling on a trunk resets any phone numbers routed to that trunk back to a rejecting route. If you re-enable inbound calling later, reassign those numbers to the trunk before resuming inbound traffic.
Bird Voice gestisce le chiamate di emergenza?
No. Bird Voice does not route emergency services calls, so maintain a local emergency-capable telephone connection for emergency dialing.
Cos'è un SIP trunk?
A SIP trunk connects your IP PBX, contact center, or voice application to the telephone network through Bird. Bird assigns your workspace a dedicated trunk domain, and you point your phone system at that domain to place and receive calls.
Quanti trunk mi servono?
A single trunk handles traffic for most workspaces. You can create additional trunks when you want isolated IP allowlists, API keys, or Digest authentication settings for separate office locations, environments, or PBX clusters.
Quali dettagli di connessione servono al mio PBX?
Configure your PBX with the trunk's SIP domain from the dashboard, the standard Bird SIP username, and the secret of an API key assigned to that trunk as the password. Point outbound signaling to the trunk domain on port 5060 for UDP or TCP, or port 5061 for encrypted TLS.
Posso limitare chi invia chiamate al mio trunk?
Yes. You can lock down a trunk using an IP allowlist, SIP Digest authentication with workspace API keys, or both together. Changes to allowed IP ranges and API keys take effect on the next call attempt.
Cosa succede quando elimino un trunk?
The trunk domain stops accepting new call attempts immediately. Active calls already in progress finish normally, and historical call records from that trunk remain in your call log.
Come funziona l'autenticazione SIP Digest?
When your PBX starts a call, Bird replies with an authentication challenge, and your PBX resends the request with an authorization header signed using your Bird SIP username and API key secret. Your PBX transmits a cryptographic hash of the secret so the raw password stays off the network.
Quali algoritmi Digest sono supportati?
Bird supports SHA-256 and MD5. By default, Bird offers SHA-256 first and MD5 second, and your PBX selects the first algorithm it supports. If legacy equipment requires MD5 and fails when a challenge starts with SHA-256, configure the trunk to offer MD5 by itself.
Posso usare sia la lista IP consentiti sia l'autenticazione tramite API key?
Yes. When a trunk uses both methods, Bird checks the source IP address before issuing a password challenge, so traffic from an unlisted address is blocked before credential verification.
Come faccio a ruotare un'API key senza interruzioni di servizio?
Add the new API key to the trunk first, update your PBX credentials, and then revoke the old key. Revoking or deleting a key immediately stops it from authenticating calls on the trunks where it was assigned.
Cos'è un caller ID?
A caller ID is a phone number your workspace is authorized to display on outbound calls. When you place a call, Bird checks the calling number against your workspace's eligible identities, including voice numbers managed in Bird and verified external numbers.
Come verifico un caller ID?
Add the number in international E.164 format in the dashboard and start the verification call. Answer the call, enter the spoken verification code in the dashboard, and confirm the number status shows verified before placing outbound calls.
What should I do if the verification call does not arrive?
If the verification attempts have expired, request a new code from the number's row in the dashboard to trigger a fresh call. If the number is still waiting for a code, remove the caller ID entry and add the number again.
Come verifico un numero che squilla su un sistema non presidiato?
Route the number temporarily to a phone or extension where someone can answer the verification call and capture the code. If the number cannot receive live voice calls, contact support to complete an ownership check.
Cosa succede quando rimuovo un caller ID?
New outbound calls presenting that number are refused immediately as an unverified caller ID. Active calls already in progress continue uninterrupted, and historical call logs for that number remain in your workspace.
Perché devo abilitare i paesi prima di chiamare?
Country allowlisting protects your balance from international toll fraud. Attackers who compromise a PBX typically dial high-cost international numbers, so keeping unused countries disabled caps your financial exposure to the regions where you actually do business.
Come abilito un paese di destinazione?
Search for the country by name or two-letter ISO code on the Destinations page in the dashboard and switch its toggle on. Outbound calls to that country are permitted immediately.
Cosa significa il badge High risk?
The High risk badge marks destinations with elevated per-minute carrier rates or revenue-share numbering ranges that attract toll-fraud traffic. Keep high-risk destinations disabled unless you actively call customers there, and review the destination rate before enabling them.
Un paese di cui ho bisogno è indicato come Not supported. Cosa faccio?
Countries marked Available can be toggled on directly in the dashboard. If a country is marked Not supported, Bird cannot place calls there from your account; contact support so our team can review route availability and restore access where possible.
Why did my call fail for a missing route when the destination country is enabled?
Enabling a country permits calls at the national level, but specific numbering ranges or regional prefixes within that country may still lack an active carrier route. Share the call ID with support so our team can inspect the dialed prefix and carrier coverage.
How should caller and destination numbers be formatted on outbound SIP calls?
Provide both the destination number and the calling number in full international E.164 format, starting with a plus sign followed by the country code and subscriber number. The calling number must match a verified caller ID or eligible Bird number in your workspace, and no custom SIP headers are required.
Cos'è l'attestazione STIR/SHAKEN?
STIR/SHAKEN cryptographically signs outbound caller identity so downstream carriers can verify the calling customer and phone number. Attestation reflects the verification level of the caller and number, though destination carriers still apply their own call-filtering and spam policies.
La mia chiamata è stata rifiutata. Come scopro il motivo?
Open the call record in your dashboard call log. Your PBX receives a generic service-unavailable response over SIP, while the dashboard call record shows the specific rejection reason along with a direct link to the workspace setting that resolves it.
Devo riprovare una chiamata rifiutata?
Fix the underlying rejection reason before retrying. For example, a call blocked for exceeding your calls-per-second rate limit will continue to fail until your dialer slows its pacing, and a call blocked for an unverified caller ID or disabled destination country requires a configuration update first.
"Risposta" equivale a un esito positivo per il cliente?
No. Significa che la chiamata è stata connessa. Collega un evento aziendale confermato, come una prenotazione o un caso risolto, per valutare il successo dell'attività.
Perché il costo è vuoto su una chiamata attiva?
Una chiamata attiva non ha completato la tariffazione. Leggi il record finale dopo che la chiamata e il ciclo di tariffazione sono terminati; un valore mancante non è un prezzo pari a zero.
Come gestisco la consegna duplicata dei webhook?
Verifica la firma, deduplica usando l'identità del webhook e tollera l'arrivo fuori ordine. Riconcilia il risultato finale con il record della chiamata.
Posso confrontare le chiamate in entrata e in uscita?
Controlla la direzione e i filtri del report in modo esplicito. Il mix di traffico e le componenti tariffate applicabili possono differire.
Come misuro il costo per attività completata?
Collega le chiamate tariffate e le relative sessioni ai risultati confermati nella tua applicazione. Includi ogni segmento di chiamata pertinente e usa un periodo coerente e una definizione uniforme di completamento.
Quali stati delle chiamate esistono?
Completed calls show one of five statuses: Answered when the recipient picked up, No answer when the call rang out, Failed when carrier delivery did not complete, Rejected when Bird blocked the call before dialing or the recipient declined it, and Unknown when the final signaling state could not be determined.
Come distinguo un rifiuto di Bird da un errore del carrier?
Calls blocked by Bird appear as Rejected and include a rejection reason in the call log showing which account or trunk check failed. A Rejected status without a pre-dial block means the recipient declined the call. Carrier delivery issues appear as Failed along with the signaling response code.
Posso vedere le chiamate ancora in corso?
Yes. The Live tab on the Calls page displays active calls across your trunks along with a live concurrency count. Each active call appears as Ringing while waiting for an answer or In progress once connected, and the view updates automatically.
Qual è la differenza tra durata totale e tempo fatturabile?
Total duration measures the time from when Bird receives the call request until hangup, including ringing. Billable time measures the connected conversation from answer to hangup. Unanswered calls accumulate zero answered talk time. Check your rate card for applicable per-minute increments and service charges.
Come faccio a esportare i registri delle chiamate?
You can download a CSV from the Calls page that includes the full set of records matching your active filters across pages, fetch call logs programmatically through the Voice API using a read-scoped API key, or list call records from the Bird CLI.
Quali eventi vocali emette Bird?
Bird sends three call lifecycle webhooks: a call-initiated event when Bird accepts the call and begins routing, a call-answered event when the recipient picks up, and a call-ended event when the call finishes with its final status and duration. Unanswered calls skip the answered event and go straight from initiated to ended.
Una chiamata rifiutata genera eventi?
Calls admitted and then refused by a policy check emit a call-ended event with a rejected status, which you can reconcile against the call record. Calls turned away at the SIP edge before admission do not generate a call record or webhook events. Check the call log to confirm whether a call without a webhook completed or was blocked before admission.
Gli eventi possono arrivare fuori ordine?
Yes. Webhook deliveries can arrive out of sequence, so a call-answered notification may reach your endpoint after the call-ended notification. Compare the event timestamps in your handler so an older lifecycle transition does not overwrite a newer call state.
Come evito di contare gli eventi due volte?
Deduplicate incoming deliveries using the unique webhook identifier header attached to each HTTP request. Network or signaling retries reuse the same webhook identifier for a given call lifecycle transition, allowing your handler to ignore duplicates safely.
Dove si trovano il costo e il motivo del rifiuto negli eventi?
Call costs and specific rejection reasons are stored on the call record in the call log. A rejected status on a call-ended event indicates either a pre-dial refusal by Bird or a call declined by the recipient. Inspect the call record to see the specific rejection reason and the final rated cost once billing completes.
Why is my call missing from the call log?
Calls turned away at the SIP boundary before admission do not create a call record. Verify four settings on your trunk and PBX: the trunk has at least one allowed IP range or API key assigned, your traffic arrives from a public IP address on the trunk's allowlist, your SIP Digest credentials and hashing algorithm match the trunk configuration, and your PBX dials the trunk's exact SIP domain.
La mia chiamata è fallita con un motivo di rifiuto. Cosa devo fare?
Open the call record in your dashboard call log, where the summary banner explains why the call was blocked and links directly to the setting that resolves it. Self-service rejection reasons cover an unauthorized source IP, an unverified caller ID, a disabled destination country, insufficient wallet balance, a reached daily spend cap, a reached concurrent-call limit, or a reached calls-per-second rate limit.
Why does my PBX fail authentication when answering a Digest challenge with MD5?
Some legacy SIP equipment fails to parse an authentication challenge that offers SHA-256 first. Configure the trunk's Digest authentication setting to offer MD5 by itself so your PBX receives a challenge format it supports.
Le chiamate si connettono ma l'audio è unidirezionale. Qual è il problema?
One-way audio usually happens when a firewall blocks RTP media ports or when NAT advertises an unreachable private IP address in the session description. Verify that your firewall allows the required media ports, configure NAT traversal or public media addressing on your PBX, and confirm both sides share a supported audio codec.
La connessione SIP è crittografata?
Yes, when you configure TLS transport on port 5061 to encrypt SIP signaling in transit. Unencrypted UDP and TCP signaling are also available on port 5060 for equipment that requires them.
Come verifico che un webhook provenga realmente da Bird?
Bird signs webhook requests with an HMAC signature. Validate the request signature against your endpoint's signing secret before processing the event payload, and rotate the signing secret from the dashboard whenever needed.
Dove vengono archiviati i miei dati?
Voice call records are stored in your workspace's configured service region. Review Bird's data-processing and retention terms for full details on regional media handling, signaling, and storage locations.
Cosa può fare un'API key utilizzata per le chiamate vocali?
Permissions are separated by role: voice write access allows an authorized key to authenticate SIP calls on trunks where it is assigned, voice read access permits reading call logs, and a separate voice management permission controls trunk and routing configuration.
Why does a refused call return a generic SIP error instead of the specific rejection reason?
Bird writes the detailed rejection reason to your private dashboard call log while returning a generic service-unavailable response over SIP. Keeping detailed refusal reasons off the signaling response prevents outside scanners from probing your trunk to discover valid numbers, credentials, or enabled destinations.
Dove trovo la documentazione sulla sicurezza e la protezione dei dati di Bird?
Security certifications and compliance reports are available in the Bird Trust Center at trust.bird.com, and our data processing agreement, privacy statement, and acceptable use policy are published at bird.com/legal. Contact your Bird account team if you need assistance with a custom vendor security review.
Una sequenza di chiamata è la stessa cosa di un flusso di automazione?
A call sequence controls what happens inside a live phone call, such as playing prompts, collecting keypad digits, and recording audio. An automation flow coordinates broader multi-step business workflows across channels, and each is published independently.
Posso creare un menu IVR?
Yes. You can play a text-to-speech or pre-recorded audio prompt, collect keypad presses, and route callers down separate branches for valid selections, timeouts, or unrecognized digits.
L'input da tastiera equivale al riconoscimento vocale?
No. Call sequence input collection reads DTMF keypad digits pressed by the caller. Spoken natural-language conversations use an AI voice runtime with speech recognition and turn-taking.
Cosa cambia la pubblicazione per le chiamate attive?
Calls already running on a published version finish on that snapshot without interruption, while new calls pick up the newly published version. Draft test calls evaluate the latest saved steps as they move from one node to the next.
Una richiesta in uscita accettata significa che il destinatario ha risposto?
No. An accepted request confirms that Bird queued the call attempt for dialing. Track the call's lifecycle events and call record to see whether the recipient answered, and use idempotency keys on retries to prevent duplicate calls.
AI Voice è la stessa cosa di un menu telefonico?
No. Un menu telefonico segue scelte predefinite come i tasti numerici. Una conversazione vocale con IA interpreta il linguaggio e genera risposte attraverso un runtime conversazionale. Entrambi richiedono comunque un design completo di instradamento delle chiamate e gestione degli esiti.
Posso usare il mio runtime IA esistente?
Un runtime compatibile con SIP può connettersi tramite Bird quando la segnalazione, l'autenticazione e il comportamento media sono compatibili. Valida l'integrazione con una chiamata reale in entrambe le direzioni prima di spostare il traffico.
Una connessione MCP crea un agente vocale conversazionale?
No. MCP consente a un agente software autorizzato di utilizzare gli strumenti dell'account. Un agente vocale dal vivo necessita inoltre di audio, elaborazione vocale, gestione dei turni e un'applicazione conversazionale.
L'assistente può prenotare appuntamenti o cercare ordini?
Collega queste azioni tramite gli strumenti autorizzati della tua applicazione. Considera lo stato restituito come fonte di verità e richiedi la conferma appropriata del cliente prima di effettuare una modifica.
Cosa devo misurare?
Misura connessione e completamento della chiamata separatamente dal successo dell'attività. Traccia il risultato di business confermato, il tasso di escalation e i motivi di errore osservati; una trascrizione o una chiamata con risposta da sole non possono provare la conversione.
I numeri appena assegnati rispondono automaticamente?
No. Newly provisioned numbers default to a rejecting route until you assign an inbound destination such as a SIP trunk or a forwarding number.
Una chiamata in entrata può raggiungere il mio assistente AI?
Yes. Point the phone number's inbound route to the SIP trunk and delivery gateway where your AI voice runtime listens, so incoming callers connect directly to your assistant.
Perché una chiamata inoltrata non è riuscita?
Check both the inbound leg and the correlated outbound forwarding leg in the call log. A forwarded call requires a verified target number, an enabled destination country, active carrier routing, and available concurrency and spend capacity.
Il campo route dimostra che la chiamata si è connessa?
No. The route field shows which routing rule Bird selected for the incoming call. Check the call status and lifecycle events to confirm whether the destination answered.
L'inoltro costa quanto una singola chiamata in entrata?
Forwarding bridges an incoming call leg with a new outbound call leg to your forwarding number. Review the published rates for both legs and inspect the call log for the rated charges.
Devo installare un softphone?
No. The built-in dashboard phone runs in your web browser over WebRTC and connects through your workspace's configured Bird SIP trunk.
Il telefono riceve chiamate in entrata?
Sì. Instrada un numero verso un gruppo di squillo e il telefono squilla per i membri del gruppo online nella dashboard. Il primo membro che seleziona Accept prende la chiamata. Puoi anche instradare le chiamate in entrata verso il tuo PBX SIP, una sequenza di chiamata pubblicata o un numero di telefono verificato.
Devo essere online per effettuare chiamate?
Sì. Prima di comporre il numero, scegli Online o Busy nello stato del telefono. Con Busy puoi continuare a effettuare chiamate senza ricevere squilli per quelle in entrata.
Quante persone possono essere online contemporaneamente?
Per impostazione predefinita, fino a 10 utenti di un'organizzazione possono essere online nel telefono contemporaneamente in ciascuna regione, e il limite dipende dal tuo piano Voice. Un utente online in più spazi di lavoro conta una sola volta.
Posso inviare toni dal tastierino?
Yes. Use the on-screen dialpad during an active call to send DTMF keypad tones for navigating IVR menus or entering extensions.
Le chiamate dal browser hanno tariffe diverse?
No. Browser calls use the same per-destination Voice rates and billing increments as SIP trunk calls, and their final rated cost appears on the call record.
Posso usare il telefono nel browser per le emergenze?
No. Bird Voice does not support emergency calling, so use a local telephone service for emergency numbers.
Are calls recorded automatically?
No. Recording happens when you enable it in your call workflow or sequence, giving you control over which calls are captured and when recording starts and stops.
Una registrazione crea automaticamente una trascrizione?
No. Audio recording and speech-to-text transcription are configured separately, so you can record audio on its own or request transcription when you need searchable text.
Una trascrizione può arrivare dopo la fine della chiamata?
Yes. Transcription processing finishes asynchronously after the call disconnects, so track the call outcome and the transcript status separately.
Una sessione corrisponde a una registrazione?
No. A single session can span multiple call legs, such as an inbound call and a transferred leg, and each leg can produce its own recording and transcript.
Posso considerare una trascrizione come un'azione confermata del cliente?
A transcript provides a record of what was said during the conversation. Verify completed bookings, order updates, or payments directly against the system of record that processed the transaction.
Mettilo in pratica.
Continua con la documentazione, le guide e gli esempi per questo argomento.
Guida all'implementazioneVoice overviewComprendi il concettoWhat is a voice API?Esplora la funzionalitàVoice
Ottieni un brief di implementazioneParla con il nostro team Voice
Ready to place your first call or migrate your phone traffic?
Connect a SIP trunk, verify your caller ID, and place a test call from the browser in minutes, or talk with our team to plan destination coverage, call capacity, and pricing for production traffic.