Verify 日志
Verify log 位于 Verify > Verifications 下的 Verifications 页面，记录了你的工作区中的每个验证会话。最新的验证排在最前面。你可以用它确认某个验证已创建，跟踪每次渠道尝试和校验，并查看转化耗时和每次尝试的费用。生成的一次性验证码不会以明文存储，也不会在控制台中显示。
验证列表
每一行对应一个验证会话。各列如下：
| 列 | 显示内容 |
|---|---|
| Status | 会话的当前状态（Pending、Converted、Failed、Expired、Canceled 或 Blocked；参见状态） |
| Verification | 验证 ID（vrf_...） |
| Recipient | 正在验证的电话号码或电子邮件地址 |
| Channel | 最近一次尝试所用的发送渠道（Email、SMS、WhatsApp、Telegram 或 Voice） |
| Cost | 该会话中所有发送尝试的总计费金额 |
| Created | 验证的创建时间 |
列表按每页 25 条验证分页显示。
搜索和筛选
页面在数量时间轴上方提供收件人搜索和三个筛选条件。多个筛选条件可组合使用，以缩小列表范围：
- Search by phone number：按 E.164 格式精确匹配收件人电话号码，例如
+14155550100。 - Status：筛选 Pending、Converted（
verified）、Failed 或 Expired 状态。 - Channel：按投递渠道筛选（
Email、SMS、WhatsApp、Telegram或Voice）。 - Date range：选择预设时间段，或在日历或时间轴上选择自定义范围。
如果没有验证符合当前筛选条件，请使用 Clear filters 重置视图。
状态
验证初始状态为 Pending（pending），之后只会进入一次最终状态：
| 控制台标签 | API status | 含义 |
|---|---|---|
| Pending | pending | 验证处于活动状态，正在等待在 expires_at 之前提交匹配的验证码进行校验 |
| Converted | verified | 某次校验调用在过期前提交了匹配的验证码 |
| Failed | failed | 会话已用完允许的校验尝试次数（attempts_exhausted），或所有渠道均投递失败 |
| Expired | expired | 验证码有效期已过（ttl_elapsed），期间既没有成功校验，也没有用完尝试次数 |
| Canceled | canceled | 该会话在完成前已被取消 |
| Blocked | blocked | 该验证被安全或策略检查拦截 |
如需了解状态转换和终止原因如何与重新发送及渠道回退相互作用，请参阅发送验证。
查看验证详情
选择任意一行即可打开验证详情面板。面板将会话信息分为三个部分：
摘要
摘要标题区记录会话的结果和配置：
- Outcome：对于已转化的会话，显示转化耗时（
Converted in）以及第几次检查尝试匹配成功（例如Code matched on 1st check）。对于失败的会话，显示检查失败的次数。 - Code：该会话配置的验证码位数和有效期。
- Channels used：会话期间尝试投递的所有渠道。
- Metadata：创建验证时在
metadata中传入的所有键值对。
生命周期时间线
时间线按顺序列出会话从创建到结束的每个步骤：
- Channel attempts：每次验证码发送（
SMS、WhatsApp、Telegram、Voice或Email）、发送方、投递结果（sent、delivered，或附带错误原因的undelivered）、投递耗时以及每次尝试的费用。会话处于待处理状态时，尚未触发的计划回退渠道会显示为后续步骤。 - Code checks：每次
POST /v1/verify/verifications/check调用及验证码是否匹配。 - Terminal state：会话进入最终状态的时间。
费用明细
当会话包含计费的尝试时，Cost breakdown 会按渠道和发送方类别（Shared sender、Custom domain、Dedicated sender 或 Managed sender）对费用分组，并以工作区货币显示会话的 Total。
验证列表和详情视图仅在控制台中提供，没有公开的列表或读取 API 端点。如需以编程方式跟踪验证的创建、每次尝试的投递和转化，请使用同步的校验响应，并订阅 Verify 事件。
后续步骤
- Verify 事件：接收
verify.verification.*和verify.attempt.*事件的 webhook 推送。 - 发送验证：配置验证码有效期、尝试次数上限、重新发送和多渠道回退。
- Verify 目的地：启用目的地国家/地区，并自定义渠道回退顺序。