语音常见问题
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.
语音常见问题
什么是 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.
我最快多久能拨出第一通电话?
当您的工作区拥有一条有效的 SIP 中继线、一个已验证的主叫号码,并启用了一个目的地国家/地区后,您即可在内置浏览器电话中上线并立即拨打测试电话,无需配置外部 SIP 硬件。
拨打电话前需要准备什么?
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.
我可以通过 Bird Voice 接收来电吗?
可以。在您的工作区中选择一个支持语音的电话号码,并为其分配呼入路由。您可以将来电转接到带有呼入网关的 SIP 中继线、运行已发布的呼叫序列、在浏览器电话中呼叫由团队成员组成的振铃组,或转接到已验证的电话号码。新获取的号码在您分配路由之前会拒绝所有来电。
我需要特殊硬件吗?
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.
我可以通过浏览器拨打电话吗?
可以。Bird 控制台中的 Phone 应用使用 WebRTC,让您的团队可以在浏览器中接听振铃组来电并拨打外呼电话;外呼时使用您工作区的 SIP 中继线和已验证的主叫号码。
语音通话如何计费?
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.
计费何时开始?
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.
语音是预付费还是后付费?
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.
是否有每日消费限额?
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.
在哪里可以查看通话费用?
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.
我的通话有哪些限制?
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.
达到限制后会发生什么?
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.
我可以提高限额吗?
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.
我的自动拨号器被拒绝了,但并发通话数还很充裕,这是为什么?
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.
我需要更换 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.
一条中继能同时处理呼入和呼出吗?
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.
AI 语音应用能通过 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.
如果我禁用呼入会怎样?
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 能承载紧急呼叫吗?
No. Bird Voice does not route emergency services calls, so maintain a local emergency-capable telephone connection for emergency dialing.
什么是 SIP 中继?
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.
我需要多少个中继?
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.
我的 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.
我可以限制谁向我的中继发送通话吗?
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.
删除中继后会发生什么?
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.
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.
支持哪些 Digest 算法?
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.
我可以同时使用 IP 白名单和 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.
如何在不中断服务的情况下轮换 API 密钥?
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.
什么是来电显示号码?
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.
如何验证来电显示号码?
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.
如何验证一个连接到无人值守系统的号码?
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.
移除来电显示号码后会怎样?
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.
为什么在拨打电话前需要先启用国家/地区?
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.
如何启用目的地国家/地区?
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.
高风险标记是什么意思?
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.
我需要的国家/地区显示为不支持,该怎么办?
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.
什么是 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.
我的通话被拒绝了,如何查明原因?
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.
被拒绝的通话应该重试吗?
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.
已接听是否意味着客户任务成功完成?
不是。它表示通话已接通。将已确认的业务事件(如预订或已解决的工单)与通话关联,以评估任务是否成功。
为什么通话进行中时费用为空?
通话进行中尚未完成计费。在通话和计费生命周期结束后读取最终记录;值为空不代表价格为零。
如何处理 webhook 重复投递?
验证签名,使用 webhook 标识进行去重,并容忍乱序到达。根据通话记录核对最终结果。
我可以对比呼入和呼出通话吗?
检查方向字段和报告的筛选条件。流量构成和适用的计费项可能不同。
如何衡量每个已完成任务的成本?
将已计费的通话及其会话与应用中已确认的结果关联。包含每个相关的通话段,并使用一致的时间范围和完成定义。
有哪些呼叫状态?
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.
如何区分 Bird 拒绝和运营商故障?
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.
我可以查看正在进行中的呼叫吗?
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.
总时长和计费时长有什么区别?
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.
如何导出通话记录?
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.
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.
被拒绝的通话会产生事件吗?
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.
事件是否会乱序到达?
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.
如何避免重复计算事件?
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.
事件中的费用和拒绝原因在哪里?
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.
我的通话因拒绝原因而失败,该怎么办?
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.
通话已连接但音频只有单向,哪里出了问题?
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.
SIP 连接是否加密?
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.
如何验证 webhook 确实来自 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.
我的数据存储在哪里?
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.
用于语音的 API 密钥具体能做什么?
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.
在哪里可以获取 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.
通话序列和自动化流程是一回事吗?
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.
我可以构建 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.
按键输入等同于语音识别吗?
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.
发布对正在进行的通话有什么影响?
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.
外呼请求被接受是否意味着对方已接听?
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 和电话菜单一样吗?
不是。电话菜单遵循预定义的选项,如按键数字。AI 语音对话则解读语言并通过对话运行时生成回复。两者都需要完整的呼叫路由和结果处理设计。
我可以使用现有的 AI 运行时吗?
支持 SIP 的运行时可以通过 Bird 连接,前提是其信令、认证和媒体行为兼容。在迁移流量之前,先用双向真实通话验证集成。
MCP 连接能构成对话式语音助手吗?
不能。MCP 允许经授权的软件代理操作账户工具。实时语音助手还需要音频、语音处理、轮次控制和对话应用。
助手可以预约或查询订单吗?
通过应用的授权工具连接这些操作。将返回的状态视为唯一事实来源,并在执行变更前要求客户进行相应确认。
应该衡量什么?
将呼叫接通率和完成率与任务成功率分开衡量。跟踪已确认的业务结果、转人工率和观察到的失败原因;仅凭通话转写文本或已接听的电话无法证明转化。
新分配的号码会自动接听吗?
No. Newly provisioned numbers default to a rejecting route until you assign an inbound destination such as a SIP trunk or a forwarding number.
来电能转接到我的 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.
转接的来电为什么失败了?
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.
路由字段能证明通话已接通吗?
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.
转接费用和一次来电相同吗?
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.
我需要安装软电话吗?
No. The built-in dashboard phone runs in your web browser over WebRTC and connects through your workspace's configured Bird SIP trunk.
该电话能接听来电吗?
可以。将号码路由到振铃组后,电话会向该组中在控制台在线的成员振铃。第一个选择 Accept 的成员接听来电。你也可以将来电路由到你的 SIP PBX、已发布的呼叫序列或已验证的电话号码。
拨打电话需要在线吗?
需要。拨号前,请在电话状态中选择 Online 或 Busy。选择 Busy 后,你可以继续拨打电话,但不会收到来电振铃。
最多可以同时有多少人在线?
默认情况下,每个区域内一个组织最多可有 10 名用户同时在电话中在线,具体上限取决于你的 Voice 套餐。在多个工作区在线的用户只计为一人。
我可以发送键盘音吗?
Yes. Use the on-screen dialpad during an active call to send DTMF keypad tones for navigating IVR menus or entering extensions.
浏览器通话的费率不同吗?
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.
我可以用浏览器电话拨打紧急电话吗?
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.
录音会自动生成转写文本吗?
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.
转写文本可以在通话结束后才生成吗?
Yes. Transcription processing finishes asynchronously after the call disconnects, so track the call outcome and the transcript status separately.
一个会话只对应一条录音吗?
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.
我可以将转写文本视为已确认的客户操作吗?
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.