---
title: "Verify 日志"
description: "在 Bird 控制台中浏览、筛选和查看每个验证会话：状态、各渠道的尝试、转化耗时和费用明细。"
canonical: "https://bird.com/zh-sg/wendang/guides/verify/verify-log"
---

# Verify 日志

**Verify log** 位于 **Verify** > **Verifications** 下的 [**Verifications**](https://bird.com/dashboard/w/verify/verifications) 页面，记录了你的工作区中的每个验证会话。最新的验证排在最前面。你可以用它确认某个验证已创建，跟踪每次渠道尝试和校验，并查看转化耗时和每次尝试的费用。生成的一次性验证码不会以明文存储，也不会在控制台中显示。

![Verifications 页面列出验证，包含状态、验证 ID、收件人、渠道、费用和创建时间等列](/images/docs/dashboard-verify-verifications.png)

## 验证列表

每一行对应一个验证会话。各列如下：

| 列               | 显示内容                                                                                                              |
| :--------------- | :-------------------------------------------------------------------------------------------------------------------- |
| **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](https://en.wikipedia.org/wiki/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`    | 该验证被安全或策略检查拦截                                                 |

如需了解状态转换和终止原因如何与重新发送及渠道回退相互作用，请参阅[发送验证](/docs/guides/verify/sending-verifications#statuses)。

## 查看验证详情

选择任意一行即可打开验证详情面板。面板将会话信息分为三个部分：

### 摘要

摘要标题区记录会话的结果和配置：

- **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`](/docs/api/reference/create-verification-check) 调用及验证码是否匹配。
- **Terminal state**：会话进入最终状态的时间。

### 费用明细

当会话包含计费的尝试时，**Cost breakdown** 会按渠道和发送方类别（`Shared sender`、`Custom domain`、`Dedicated sender` 或 `Managed sender`）对费用分组，并以工作区货币显示会话的 **Total**。

验证列表和详情视图仅在控制台中提供，没有公开的列表或读取 API 端点。如需以编程方式跟踪验证的创建、每次尝试的投递和转化，请使用同步的[校验响应](/docs/guides/verify/sending-verifications#check-the-code)，并订阅 [Verify 事件](/docs/guides/verify/events)。

## 后续步骤

- [Verify 事件](/docs/guides/verify/events)：接收 `verify.verification.*` 和 `verify.attempt.*` 事件的 webhook 推送。
- [发送验证](/docs/guides/verify/sending-verifications)：配置验证码有效期、尝试次数上限、重新发送和多渠道回退。
- [Verify 目的地](/docs/guides/verify/destinations)：启用目的地国家/地区，并自定义渠道回退顺序。

## Related resources

- [Verify phone numbers at signup](/learn/series/verify-phone-numbers-at-signup) (video)
- [What does OTP mean? One-time passwords explained](/explained/verify/what-does-otp-mean) (answer)
- [Customer verification](/verify-api) (product)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=verify)