SuperAPI AI 工具集

contacts-management

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:在代码中创建、更新和管理联系人及其多渠道通信方式,覆盖多渠道联系人模型、搜索、合并、电话号码解析与邮箱验证。

主要能力:联系人可拥有多个渠道(sms、whatsapp、email、telegram、instagram、messenger、voice),每个渠道有独立标识与投递指标;顶层字段提供 primaryPhone、primaryEmail 等主标识。向新收件人发消息时会自动创建联系人。支持按 ID、电话号码获取,按电话号码、标签、搜索词列出;搜索不区分大小写与重音,可匹配电话号码尾段、displayName 及 WhatsApp 资料名。标签为扁平多对多标签,重复传参表示 AND 匹配,未知标签返回 400;标签的创建、重命名与分配需在仪表盘完成,API 暂无标签 CRUD。渠道操作支持添加、更新、设为主渠道、移除(不能移除最后一个渠道)。更新联系人可改 displayName、defaultChannel、metadata,传 null 可清空。合并会把源联系人的所有渠道移到目标联系人,源联系人标记为已合并且不再出现在列表中,合并不可逆。电话号码解析可返回有效性、国家、国内格式、线路类型、运营商与可用渠道。邮箱验证通过 REST 端点进行,支持单个与批量(每次最多 100 个),返回 deliverable、risky、undeliverable 判定及原因,不做 SMTP 邮箱探测。

使用方式:通过 SDK 调用 contacts.create、get、getByPhone、list、update、merge 及 channels.add/update/setPrimary/remove;电话号码解析用 introspect.phone;邮箱验证尚未生成 SDK,需直接调用 REST 端点 POST https://api.zavu.dev/v1/introspect/email,并携带 Authorization: Bearer $ZAVU_API_KEY。

限制:每个联系人最多 20 个渠道;渠道标签最多 50 字符;显示名最多 200 字符;不能移除最后一个渠道;不能将联系人与自身合并;电话号码须为 E.164 格式;跨联系人的重复标识会被拒绝,应改用合并;旧字段 phoneNumber 已弃用,应使用 primaryPhone;自动创建的联系人没有 displayName,需先命名才能按名称搜索;合并不可逆,且系统不会自动检测重复或给出合并建议。