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
Qu'est-ce que 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.
En combien de temps puis-je passer mon premier appel ?
Dès que votre espace de travail dispose d'un trunk SIP actif, d'un identifiant d'appelant vérifié et d'un pays de destination activé, vous pouvez vous connecter au téléphone intégré au navigateur et passer immédiatement un appel de test, sans configurer de matériel SIP externe.
De quoi ai-je besoin avant de pouvoir appeler ?
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.
Puis-je recevoir des appels avec Bird Voice ?
Oui. Sélectionnez un numéro de téléphone compatible avec la voix dans votre espace de travail et attribuez-lui une route entrante. Vous pouvez acheminer les appels entrants vers un trunk SIP doté d'une passerelle entrante, exécuter une séquence d'appel publiée, faire sonner un groupe de sonnerie de collègues dans le téléphone du navigateur ou les transférer vers un numéro de téléphone vérifié. Les numéros nouvellement acquis rejettent les appels entrants tant que vous ne leur avez pas attribué de route.
Ai-je besoin d'un matériel spécial ?
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.
Puis-je passer des appels depuis le navigateur ?
Oui. L'application Phone du tableau de bord Bird utilise WebRTC pour que votre équipe puisse répondre aux appels des groupes de sonnerie et passer des appels sortants depuis le navigateur, en utilisant le trunk SIP et les identifiants d'appelant vérifiés de votre espace de travail pour les appels sortants.
Comment les appels vocaux sont-ils tarifés ?
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.
Quand la facturation commence-t-elle ?
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 voix est-elle prépayée ou postpayée ?
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.
Y a-t-il un plafond de dépenses quotidien ?
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.
Où puis-je voir le coût d'un appel ?
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.
Quelles limites s'appliquent à mes appels ?
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.
Que se passe-t-il lorsque j'atteins une 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.
Puis-je augmenter mes limites ?
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.
Mon automate d'appels est refusé alors que j'ai largement de la marge en appels simultanés. Pourquoi ?
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.
Dois-je remplacer mon 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 même trunk peut-il gérer les appels entrants et sortants ?
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.
Une application vocale IA peut-elle se connecter via 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.
Que se passe-t-il si je désactive les appels entrants ?
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 prend-il en charge les appels d'urgence ?
No. Bird Voice does not route emergency services calls, so maintain a local emergency-capable telephone connection for emergency dialing.
Qu'est-ce qu'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.
De combien de trunks ai-je besoin ?
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.
Quels paramètres de connexion mon PBX requiert-il ?
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.
Puis-je restreindre qui envoie des appels vers mon 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.
Que se passe-t-il lorsque je supprime 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.
Comment fonctionne l'authentification 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.
Quels algorithmes Digest sont pris en charge ?
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.
Puis-je utiliser à la fois la liste d'adresses IP autorisées et l'authentification par clé API ?
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.
Comment effectuer la rotation d'une clé API sans interruption de service ?
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.
Qu'est-ce qu'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.
Comment vérifier 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.
Comment vérifier un numéro qui sonne sur un système sans surveillance ?
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.
Que se passe-t-il lorsque je supprime 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.
Pourquoi dois-je activer des pays avant d'appeler ?
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.
Comment activer un pays de destination ?
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.
Que signifie le 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 pays dont j'ai besoin est indiqué comme Not supported. Que faire ?
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.
Qu'est-ce que l'attestation 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.
Mon appel a été refusé. Comment savoir pourquoi ?
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.
Dois-je réessayer un appel refusé ?
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.
Un appel décroché signifie-t-il un résultat client réussi ?
Non. Cela signifie que l'appel a abouti. Associez un événement métier confirmé, tel qu'une réservation ou un cas résolu, pour évaluer le succès de la tâche.
Pourquoi le coût est-il vide sur un appel en cours ?
Un appel en cours n'a pas encore été tarifé. Consultez la fiche finale une fois l'appel et le cycle de tarification terminés ; une valeur absente ne signifie pas un prix nul.
Comment gérer la livraison de webhooks en double ?
Vérifiez la signature, dédupliquez à l'aide de l'identifiant du webhook et tolérez une arrivée dans le désordre. Réconciliez le résultat final avec la fiche de l'appel.
Puis-je comparer les appels entrants et sortants ?
Vérifiez la direction et les filtres du rapport de manière explicite. La répartition du trafic et les composants tarifés applicables peuvent différer.
Comment mesurer le coût par tâche accomplie ?
Associez les appels tarifés et leurs sessions aux résultats confirmés dans votre application. Incluez chaque segment d'appel pertinent et utilisez une période et une définition d'achèvement cohérentes.
Quels sont les statuts d'appel existants ?
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.
Comment distinguer un refus de Bird d'une défaillance de l'opérateur ?
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.
Puis-je voir les appels en cours ?
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.
Quelle est la différence entre la durée totale et le temps facturable ?
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.
Comment exporter les enregistrements d'appels ?
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.
Quels événements vocaux Bird émet-il ?
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.
Un appel refusé génère-t-il des événements ?
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.
Les événements peuvent-ils arriver dans le désordre ?
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.
Comment éviter de compter les événements en double ?
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.
Où se trouvent le coût et le motif de rejet dans les événements ?
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.
Mon appel a échoué avec une raison de rejet. Que dois-je faire ?
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.
Les appels se connectent mais l'audio est unidirectionnel. Quel est le problème ?
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 connexion SIP est-elle chiffrée ?
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.
Comment vérifier qu'un webhook provient bien de 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.
Où sont stockées mes données ?
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.
Que peut faire une clé API utilisée pour la voix ?
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.
Où trouver la documentation sécurité et protection des données de 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.
Une séquence d'appels est-elle identique à un flux d'automatisation ?
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.
Puis-je créer 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.
La saisie clavier correspond-elle à de la reconnaissance 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.
Quel effet a la publication sur les appels en cours ?
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.
Une requête sortante acceptée signifie-t-elle que le destinataire a répondu ?
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 est-il identique à un menu téléphonique ?
Non. Un menu téléphonique suit des choix prédéfinis comme des touches du clavier. Une conversation vocale IA interprète le langage et génère des réponses via un moteur conversationnel. Les deux nécessitent une conception complète du routage d'appel et du traitement des résultats.
Puis-je utiliser mon environnement d'exécution IA existant ?
Un environnement d'exécution compatible SIP peut se connecter via Bird lorsque sa signalisation, son authentification et son comportement média sont compatibles. Validez l'intégration avec un appel réel dans les deux sens avant de basculer le trafic.
Une connexion MCP fait-elle un agent vocal conversationnel ?
Non. MCP permet à un agent logiciel autorisé d'utiliser les outils d'un compte. Un agent vocal en direct nécessite en plus l'audio, le traitement de la parole, la gestion des tours de parole et une application conversationnelle.
L'assistant peut-il prendre des rendez-vous ou rechercher des commandes ?
Connectez ces actions via les outils autorisés de votre application. Considérez le statut renvoyé comme la source de vérité, et exigez la confirmation appropriée du client avant d'effectuer une modification.
Que faut-il mesurer ?
Mesurez la connexion et l'aboutissement de l'appel séparément du succès de la tâche. Suivez le résultat métier confirmé, le taux d'escalade et les causes d'échec observées ; une transcription ou un appel décroché seul ne peut pas prouver la conversion.
Les numéros nouvellement attribués répondent-ils automatiquement ?
No. Newly provisioned numbers default to a rejecting route until you assign an inbound destination such as a SIP trunk or a forwarding number.
Un appel entrant peut-il atteindre mon assistant IA ?
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.
Pourquoi un appel transféré a-t-il échoué ?
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.
Le champ route prouve-t-il que l'appel a abouti ?
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.
Le transfert coûte-t-il autant qu'un seul appel entrant ?
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.
Dois-je installer 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.
Le téléphone reçoit-il les appels entrants ?
Oui. Acheminez un numéro vers un groupe d'appel : le téléphone sonne pour les membres du groupe connectés dans le tableau de bord. Le premier membre qui sélectionne Accept prend l'appel. Vous pouvez aussi acheminer les appels entrants vers votre PBX SIP, une séquence d'appel publiée ou un numéro de téléphone vérifié.
Dois-je être en ligne pour passer des appels ?
Oui. Choisissez Online ou Busy dans le statut du téléphone avant de composer un numéro. Busy vous permet de continuer à passer des appels sans recevoir les appels entrants.
Combien de personnes peuvent être en ligne simultanément ?
Par défaut, jusqu'à 10 utilisateurs d'une organisation peuvent être en ligne simultanément dans le téléphone, dans chaque région, et cette limite dépend de votre forfait Voice. Un utilisateur en ligne dans plusieurs espaces de travail n'est compté qu'une fois.
Puis-je envoyer des tonalités clavier ?
Yes. Use the on-screen dialpad during an active call to send DTMF keypad tones for navigating IVR menus or entering extensions.
Les appels depuis le navigateur ont-ils des tarifs différents ?
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.
Puis-je utiliser le téléphone du navigateur pour les urgences ?
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.
Un enregistrement génère-t-il automatiquement une transcription ?
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.
Une transcription peut-elle arriver après la fin de l'appel ?
Yes. Transcription processing finishes asynchronously after the call disconnects, so track the call outcome and the transcript status separately.
Une session correspond-elle à un seul enregistrement ?
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.
Puis-je considérer une transcription comme une action client confirmée ?
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.
Mettez-le en pratique.
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.
Guide d'implémentationVoice overviewComprendre le conceptWhat is a voice API?Explorer la fonctionnalitéVoice
Obtenir un guide d'implémentationParler à notre équipe 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.