基于 Bird 构建客户案例
客户案例基于 Bird 构建
深受工程和产品团队信赖, 助力其在全球范围内交付。
常见问题详解
详解常见问题
Verify 常见问题
如何在我的应用中接入验证功能?
Integration takes two API calls: one to send a code to the user's phone number or email address, and a second to check the code they submit. Because Bird matches the check against the recipient address and your verification configuration, you do not need to store a session ID between requests.
可以通过哪些渠道进行验证?
You can verify users over SMS, WhatsApp, and email today, with voice rolling out as an additional channel. You can adjust enabled channels, fallback order, and sender identities per country without deploying code changes.
我需要存储验证 ID 吗?
No. Resending a code uses the same send request, and code checks match against the recipient's phone number or email address, so your backend does not need to track per-request verification state. The API still returns an identifier in case you want to inspect delivery status later.
我的用户看到验证码来自谁?
You can choose between two Bird-managed sender identities per channel: Bird Verify by default, or Authifly when you prefer a neutral brand that does not display a platform vendor to your users. For email, you can also send from your own verified domain. WhatsApp messages come from the chosen identity's verified business profile, and SMS uses a branded sender ID where local regulations permit one or a local number or short code where required. Authifly is operated by Bird B.V. and provides a public verification page explaining that it delivers legitimate one-time passcodes on a business's behalf.
费用是多少?
Verify pricing is tailored to your destination countries, channels, and message volume while public self-serve rates are being finalized. Contact our sales team to get a quote for your verification traffic.
使用 Verify 需要额外付费吗?
No. Bird does not charge a separate Verify platform fee or per-verification surcharge. You pay the standard delivery rate for the channel that sends each code.
验证码校验的费用是多少?
Code checks are free of charge. Billing applies when Bird sends a verification message, and checking a submitted code carries no fee whether the check succeeds or fails.
如果发送回退到第二个渠道,我需要付两次费用吗?
Yes. Because Bird dispatches two separate messages, the initial attempt and the fallback delivery are each billed at their respective channel rate. Requesting a resend on the same channel is billed the same way.
验证码有几位?有效期多长?
By default, Bird issues a six-digit numeric code valid for ten minutes. You can configure the length from four to eight numeric digits and set the validity window up to roughly 16 hours to match your security requirements.
输入错误的验证码会怎样?
The check response tells your app whether the code matched and why a check failed. It distinguishes between a mistyped code with remaining attempts, a session that ran out of attempts, and a code whose time window passed, so your app can prompt another try or offer a new code.
用户有几次输入机会?
Users get five attempts by default, configurable between one and ten tries. Once those attempts are used up, the code is invalidated and the user must request a fresh verification.
可以多久重新发送一次验证码给同一个人?
Bird enforces a cooldown between sends to the same recipient, set to 60 seconds by default and configurable up to an hour, along with an hourly per-recipient send limit. Together, these limits cap what abuse or automated traffic pumping can cost your account.
什么是 SMS OTP?
An SMS one-time passcode is a short numeric code texted to a user's phone number that they enter in your app to confirm ownership of that number. Because mobile phones receive text messages out of the box without installing an extra app, SMS works well for signups and two-factor logins.
我可以覆盖哪些国家和地区?
Bird delivers SMS codes across international destinations using pre-configured Bird Verify or Authifly senders. Depending on local telecom regulations, messages arrive from a branded alphanumeric sender ID, a local phone number, or a short code, with support for dedicated registered senders expanding coverage further.
你们如何防止 SMS 泵送和暴力攻击?
Bird enforces per-recipient cooldowns, hourly send caps, and per-code attempt limits out of the box to block brute-force guessing and cap repeat-send abuse. Additional automated fraud signals and carrier-level traffic pumping controls are on the roadmap.
什么时候应该用邮件而不是 SMS 进行验证?
Email reaches users without requiring a phone number. That makes it a strong default for signups and account recovery, or a practical fallback when a phone number is unavailable. Many products offer both email and phone verification so users can pick the channel they have on hand.
我可以使用自己的域名发送吗?
Yes. Codes send from a Bird-managed shared domain by default under either the Bird Verify or Authifly sender identity. You can also connect a domain you have verified with Bird so verification emails arrive from your own address.
发送 OTP 前会检查屏蔽列表吗?
One-time passcodes are transactional security messages, so marketing unsubscribes do not block them. Users who opted out of promotional campaigns still receive their login and signup codes.
WhatsApp 验证现在可用吗?
Yes. WhatsApp is available alongside SMS and email as a built-in channel in your country routing plan and uses the same send and check API calls.
为什么用 WhatsApp 而不是 SMS 进行验证?
WhatsApp delivers codes through verified, branded authentication templates inside an app many users keep open over Wi-Fi or mobile data. In regions where WhatsApp is the primary messaging app, placing it ahead of SMS improves delivery speed and user trust while keeping SMS ready as a backup.
如果用户没有使用 WhatsApp 怎么办?
When you verify a phone number, your country plan can queue SMS behind WhatsApp. If WhatsApp cannot deliver the code, the verification session can fall back to SMS on the same phone number, and codes sent during that active session remain valid until the user verifies, the time window ends, or attempts run out.
语音验证现在可用吗?
Voice verification is rolling out alongside SMS, WhatsApp, and email. It plugs directly into your country routing plan as an orderable phone channel, so enabling spoken passcodes requires no changes to your send or check API calls.
什么时候应该使用语音 OTP?
Spoken one-time codes reach landlines, areas with delayed SMS delivery, and users who prefer an audio call over reading a text message on screen. Many teams configure voice as an automatic backup when an initial SMS or WhatsApp code goes undelivered.
语音如何与 SMS 配合?
Both channels use the same recipient phone number. When you place SMS first and voice second in your country routing plan, a verification session can step from a text message to a phone call while previously issued codes in that active session remain valid.
我应该使用哪个渠道进行二次验证?
Start with the contact detail your user has already verified: phone numbers can receive codes over SMS, WhatsApp, or voice, while email addresses verify through the inbox. Bird's country routing lets you prioritize the highest-converting phone channel in each market.
添加双因素认证意味着需要存储验证状态吗?
No. Your sign-in handler requests a code for the user's phone number or email address and submits their entered code against that same recipient address. Bird tracks the active code, validity window, and remaining attempts, so you do not need a pending-verification table in your database.
无密码登录和双因素认证有什么区别?
Two-factor authentication pairs a one-time code with a password, whereas passwordless sign-in replaces the password with a one-time code sent to the user's phone or inbox. Both flows use the same Bird Verify send-and-check calls, so the difference is whether your app prompts for a password first.
没有密码的无密码登录安全性会降低吗?
Removing passwords eliminates a frequent target for credential stuffing, phishing, and reuse across sites. Bird generates each one-time code cryptographically, stores it as a hash, and protects it with attempt limits and send caps so sign-in depends on controlling the receiving phone number or inbox.
Can users log in without typing a code?
Silent mobile network verification is designed to confirm a phone number directly with the carrier without asking the user to type a code. Bird Verify models silent authentication as a channel within the same verification flow, so you can adopt it as coverage rolls out without rebuilding your sign-in logic.
验证请求如何解析为通道方案?
When you start a verification, Bird combines its country-level routing defaults with any per-request overrides you pass, such as preferred channels or digit length. The resulting plan filters out channels unavailable in that destination and returns the active delivery order in the API response.
Bird 的国家/地区基础配置提供了什么?
You get working country routing out of the box without researching local telecom rules yourself. Bird maintains the recommended channel order, compliant sender types, and sensible code settings per market based on live delivery performance across email and SMS.
我可以在 Bird 未在某个国家/地区提供的渠道上启用该渠道吗?
No. Country availability sets the upper bound on which channels can run in a given market. If a configuration includes a channel that Bird does not offer in that country, Bird skips it during plan resolution so your verification flow routes through supported channels.
国家/地区是如何确定的?
Bird detects the destination country automatically from the international dialing prefix on the recipient's phone number and applies the matching country route. You do not need to pass a separate country parameter, and email verification runs independently of country rules.
验证码是如何生成和存储的?
Bird generates each code using a cryptographic random number generator, stores a keyed cryptographic hash instead of the raw digits, and compares submissions in constant time. The plaintext code is omitted from API responses and excluded from internal logs.
如何防止暴力破解验证码?
Each verification allows a fixed number of check attempts, set to five by default, and evaluates guesses in constant time to prevent timing side-channel leaks. Once those attempts are used up, Bird invalidates the code so automated guessing cannot succeed.
这些安全保护需要额外付费吗?
No. Cryptographic code generation, hashed storage, constant-time verification checks, attempt lockouts, and send rate limits are included by default without a separate security add-on.
我的数据存储在哪里?
Verification data stays in the US or EU hosting region configured for your Bird organization. Because your API key encodes that regional assignment, Bird SDKs and the CLI route requests to your region's endpoint automatically without manual URL setup.
API 密钥实际能做什么?
An API key is limited to the specific read or write permissions you assign it, so a key created for verification requests does not need access to other workspace resources. You can also restrict a key to approved IP address ranges and rotate keys with a configurable grace period, set to 24 hours by default, to avoid deployment downtime.
在哪里可以获取你们的安全和数据保护文件?
You can review compliance certifications and security documentation in the Bird Trust Center at trust.bird.com, and find the data processing agreement, privacy statement, and acceptable use policy at bird.com/legal. If your procurement process requires a custom security questionnaire, your Bird account team can complete it with you.
Verify users across SMS, WhatsApp, and email.
Talk with our team about country coverage, sender identities, fallback routing, and volume pricing for your signup and login flows.