Perguntas frequentes sobre voz
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.
Perguntas frequentes sobre voz
O que é o 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.
Em quanto tempo posso fazer minha primeira chamada?
Assim que seu espaço de trabalho tiver um tronco SIP ativo, um identificador de chamadas verificado e um país de destino habilitado, você pode ficar online no telefone integrado ao navegador e fazer uma chamada de teste imediatamente, sem configurar hardware SIP externo.
O que preciso antes de poder fazer chamadas?
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 receber chamadas com o Bird Voice?
Sim. Selecione um número de telefone com suporte a voz no seu espaço de trabalho e atribua uma rota de entrada. Você pode encaminhar as chamadas recebidas para um tronco SIP com um gateway de entrada, executar uma sequência de chamadas publicada, tocar um grupo de toque de colegas no telefone do navegador ou desviá-las para um número de telefone verificado. Números recém-adquiridos rejeitam chamadas recebidas até que você atribua uma rota.
Preciso de hardware especial?
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 fazer chamadas pelo navegador?
Sim. O app Phone no painel da Bird usa WebRTC para que sua equipe atenda chamadas de grupos de toque e faça chamadas de saída pelo navegador, usando o tronco SIP e os identificadores de chamadas verificados do seu espaço de trabalho nas chamadas de saída.
Como as chamadas de voz são tarifadas?
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 a cobrança começa?
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.
O serviço de voz é pré-pago ou pós-pago?
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.
Existe um limite diário de gastos?
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.
Onde posso ver quanto custou uma chamada?
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.
Quais limites se aplicam às minhas chamadas?
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.
O que acontece quando atinjo um 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 aumentar meus 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.
Um discador de campanha está sendo recusado, mas tenho bastante margem de chamadas simultâneas. Por quê?
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.
Preciso substituir meu 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.
Um único trunk pode lidar com chamadas de entrada e de saída?
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.
Uma aplicação de voz com IA pode se conectar 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.
O que acontece se eu desativar chamadas de entrada?
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.
O Bird Voice transporta chamadas de emergência?
No. Bird Voice does not route emergency services calls, so maintain a local emergency-capable telephone connection for emergency dialing.
O que é um 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.
Quantos trunks preciso?
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.
De que dados de conexão o meu PBX precisa?
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 restringir quem envia chamadas para o meu 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.
O que acontece quando elimino um 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.
Como funciona a autenticação 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.
Quais algoritmos Digest são suportados?
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 usar lista de IPs permitidos e autenticação por API key ao mesmo tempo?
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.
Como faço a rotação de uma API key sem tempo de inatividade?
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.
O que é um 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.
Como verifico um 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.
Como verifico um número que toca num sistema sem atendimento?
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.
O que acontece quando removo um 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.
Por que tenho de ativar países antes de ligar?
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.
Como ativo um país de destino?
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.
O que significa o selo 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.
Um país de que preciso está listado como Not supported. O que faço?
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.
O que é a atestação 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.
Minha chamada foi recusada. Como descubro o 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 tentar novamente uma chamada recusada?
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.
Atendida significa um resultado positivo para o cliente?
Não. Significa que a chamada foi conectada. Associe a um evento de negócio confirmado, como uma reserva ou caso resolvido, para avaliar o sucesso da tarefa.
Por que o custo está vazio em uma chamada ativa?
Uma chamada ativa ainda não teve a tarifação concluída. Leia o registro final após o encerramento da chamada e do ciclo de tarifação; um valor ausente não é preço zero.
Como devo lidar com entregas duplicadas de webhook?
Verifique a assinatura, elimine entregas duplicadas usando o identificador do webhook e tolere chegadas fora de ordem. Reconcilie o resultado final com o registro da chamada.
Posso comparar chamadas recebidas e realizadas?
Verifique a direção e os filtros do relatório explicitamente. A composição do tráfego e os componentes tarifados aplicáveis podem ser diferentes.
Como meço o custo por tarefa concluída?
Associe as chamadas tarifadas e suas sessões a resultados confirmados na sua aplicação. Inclua todos os trechos de chamada relevantes e use um período e uma definição de conclusão consistentes.
Que estados de chamada existem?
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.
Como distingo uma recusa do Bird de uma falha da operadora?
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 ver chamadas que ainda estão em curso?
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 é a diferença entre duração total e tempo faturável?
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.
Como exporto registos de chamadas?
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.
Que eventos de voz o Bird emite?
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.
Uma chamada recusada emite eventos?
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.
Os eventos podem chegar fora de ordem?
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.
Como evito a contagem duplicada de eventos?
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.
Onde estão o custo e o motivo de rejeição nos eventos?
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.
A minha chamada falhou com um motivo de rejeição. O que devo fazer?
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.
As chamadas conectam, mas o áudio é unidirecional. Qual é o 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.
A conexão SIP é encriptada?
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.
Como verifico se um webhook realmente veio 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.
Onde são armazenados os meus dados?
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.
O que pode fazer uma chave API usada para voz?
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.
Onde obtenho a documentação de segurança e proteção de dados da 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.
Uma sequência de chamada é o mesmo que um fluxo de automação?
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 criar um 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.
Entrada de teclado significa reconhecimento de fala?
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.
O que a publicação muda para chamadas ativas?
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.
Uma solicitação de saída aceita significa que o destinatário atendeu?
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 é a mesma coisa que um menu telefônico?
Não. Um menu telefônico segue opções predefinidas, como dígitos do teclado. Uma conversa por voz com IA interpreta linguagem e gera respostas por meio de um runtime conversacional. Ambos ainda precisam de um design completo de roteamento de chamadas e tratamento de resultados.
Posso usar meu runtime de IA existente?
Um runtime compatível com SIP pode se conectar por meio do Bird quando sua sinalização, autenticação e comportamento de mídia forem compatíveis. Valide a integração com uma chamada real em ambas as direções antes de migrar o tráfego.
Uma conexão MCP cria um agente de voz conversacional?
Não. MCP permite que um agente de software autorizado opere ferramentas da conta. Um agente de voz ao vivo precisa adicionalmente de áudio, processamento de fala, alternância de turnos e uma aplicação de conversa.
O assistente pode agendar compromissos ou consultar pedidos?
Conecte essas ações por meio das ferramentas autorizadas da sua aplicação. Trate o status retornado como a fonte da verdade e exija a confirmação adequada do cliente antes de fazer uma alteração.
O que devo medir?
Meça conexão e conclusão da chamada separadamente do sucesso da tarefa. Acompanhe o resultado de negócio confirmado, a taxa de escalonamento e os motivos de falha observados; uma transcrição ou uma chamada atendida sozinha não comprova conversão.
Números recém-alocados atendem 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.
Uma chamada recebida pode chegar ao meu assistente de 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.
Por que uma chamada encaminhada falhou?
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.
O campo de rota prova que a chamada foi conectada?
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.
Encaminhar custa o mesmo que uma chamada recebida?
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.
Preciso instalar um softphone?
No. The built-in dashboard phone runs in your web browser over WebRTC and connects through your workspace's configured Bird SIP trunk.
O telefone recebe chamadas de entrada?
Sim. Direcione um número para um grupo de toque, e o telefone toca para os membros do grupo que estão online no painel. O primeiro membro a selecionar Accept atende a chamada. Você também pode direcionar chamadas recebidas para o seu PBX SIP, uma sequência de chamadas publicada ou um número de telefone verificado.
Preciso estar online para fazer chamadas?
Sim. Escolha Online ou Busy no status do telefone antes de discar. Com Busy, você continua fazendo chamadas sem tocar para as chamadas recebidas.
Quantas pessoas podem estar online ao mesmo tempo?
Por padrão, até 10 usuários de uma organização podem estar online no telefone ao mesmo tempo em cada região, e o limite depende do seu plano de Voice. Um usuário online em vários espaços de trabalho conta uma única vez.
Posso enviar tons de teclado?
Yes. Use the on-screen dialpad during an active call to send DTMF keypad tones for navigating IVR menus or entering extensions.
Chamadas pelo navegador têm tarifas diferentes?
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 usar o telefone do navegador para emergências?
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.
Uma gravação cria automaticamente uma transcrição?
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.
Uma transcrição pode chegar depois que a chamada termina?
Yes. Transcription processing finishes asynchronously after the call disconnects, so track the call outcome and the transcript status separately.
Uma sessão significa uma gravação?
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 tratar uma transcrição como uma ação confirmada do 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.
Coloque em prática.
Continue com a documentação, guias e exemplos sobre este tópico.
Guia de implementaçãoVoice overviewEntenda o conceitoWhat is a voice API?Explore a funcionalidadeVoice
Obtenha um resumo de implementaçãoFale com nosso time de voz
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.