如何向Toden确认联系方式

Charles Archibong, 联合创始人

2026年10月4日

通过电子邮件或手机验证码验证联系人访问权限。对于需要捕获用户旅程的用户，请使用工作流程步骤；如果您的应用需要单独进行联系人检查，则可以使用独立 API。

要点

正确、错误和过期的代码会走不同的路径。
即使响应丢失，已验证的挑战也可以得到解决。
重复发送会遵守速率限制。
已证实的联系记录仅针对其预期客户。

通过电子邮件或电话验证码验证联系人访问权限。使用捕获流程的工作流步骤，或独立步骤。 API 当你的应用需要单独进行联系人检查时。

开始之前

支持的配送渠道
客户可通过电子邮件地址或电话联系到他们

请使用具有此控制权限的团队成员。更改设置前，请检查组织和环境。付款或持续注册前，请审核当前价格。屏幕截图显示的是示例工作区或公共集成参考；它们不显示真实客户或已完成的付款。

设置并使用该功能

步骤 1：选择工作流程验证或独立验证

要进行验证流程，请打开您的工作流程并启用电子邮件验证、电话验证或两者都启用。如果您只需要更新现有客户的联系人，请使用联系人范围的工作流程。要在您的应用中显示独立的验证码输入屏幕，请使用独立的联系人。 API 在您的后端。请勿将其证明与单独计费的证明混淆。 SDK 联系步骤。

Step 1: Workflows in the example organisation, with Sandbox selected

仪表盘示例：选择工作流验证或独立验证

步骤 2：配置工作流代码步骤

选择“电子邮件验证”→“设置” 。检查“必须进行验证” 、“验证码长度” 、“最大尝试次数”和“验证码输入方式” 。单独配置已启用的电话验证步骤。确保客户清楚了解尝试次数限制和过期恢复机制。检查特定联系人的规则，例如一次性电子邮件地址的识别结果，然后在创建新会话之前保存并发布工作流程。

Dashboard example: Configure the workflow code step

仪表盘示例：配置工作流代码步骤

步骤 3：从后端发送独立代码

称呼 POST 使用`/api/kyc/contact/verifications`接口，并将渠道设置为电子邮件或电话，并指定目标地址。对于国内电话号码格式，请包含国家/地区信息；在记录现有客户的身份验证信息时，请提供您稳定的外部用户 ID 。存储返回的质询 ID、规范化的目标地址和有效期。沙盒环境不会发送真实消息；其发送渠道为测试渠道。

集成参考：发送代码

步骤 4：根据挑战检查代码

请对方输入密码，然后打电话 POST使用代码访问 /api/kyc/contact/verifications/{id}/check 。使用发送调用返回的质询 ID。发送消息时，请勿将联系人标记为已验证。检查状态：已验证。在沙盒环境中，代码长度为配置长度的全零。切勿在代码输入界面暴露密钥。

集成参考：请查看代码

第五步：处理过期、错误代码和不确定性

验证码有效期为五分钟。显示错误验证码的剩余尝试次数；验证码用尽或过期后需要重新发送。丢失校验响应后，进行检索 GET 使用 /api/kyc/contact/verifications/{id}进行核对。重新验证已验证的挑战不会再次收费。避免重复向同一目标发送邮件；已记录的每小时限额与错误代码尝试无关。