小程序写入通讯录教程｜addPhoneContact 场景克制与字段最小化 – MPForge
直接回答：这是给商家与开发两边的微信小程序写入通讯录教程：用 addPhoneContact 把门店或客服电话存进用户手机，原则是场景克制——用户点击确认后写入、字段最小化、拒绝后可复制号码兜底。MPForge（DEVDIY 旗下）的建议很直接：大多数场景「复制号码」就够了，写通讯录只给刚需场景用。
一、先想清楚：这个电话值得被存下来吗
结论句：写入通讯录是「用户帮你建立长期触点」，只适合客服、门店预约、售后专线这类会反复联系的场景。
商家提需求时常说「把客服电话写进用户通讯录，客户随时找得到」。反过来问一句：用户真的会反复联系吗？一次性活动的电话、临时促销热线，存进通讯录只是通讯录里多一条垃圾记录，还会拉低用户对品牌的信任。
适合的场景很明确：门店预约专线（用户会复购再约）、售后与投诉专线（出问题时急用）、长期服务的顾问联系方式（如保险、家政）。不适合的一次性场景，用 拨打电话接口 直接拉起拨号盘就够了，根本不用碰通讯录。
二、字段怎么给：最小化是原则，不是偏好
结论句：写入字段越多，用户越警惕、审核越容易被问，能一通电话说清的就别带一堆字段。
wx.addPhoneContact 支持的字段很多——姓、名、公司、职位、手机号、备注、地址都能传，但只该传用户认知里「为什么要存这个号码」所需的最少集合：姓名 + 手机号 + 一条说清身份的备注，通常就够。地址只有门店类场景才值得带。
| 场景 | 建议字段 | 常见错误 |
|---|---|---|
| 门店预约专线 | 店名、电话、门店地址 | 堆一堆营业时间进备注，日历该干的事 |
| 客服售后专线 | 品牌名、电话、一句话备注 | 写入公司、职位等无关联字段 |
| 专属顾问联系 | 顾问姓名、电话、服务类型备注 | 不写备注，用户后来认不出是谁 |
| 一次性活动 | 不写通讯录，直接拉起拨号 | 临时电话也被存进通讯录 |
备注文案商家要自己定稿：写「XX 品牌门店预约专线」这种自明身份的表述，别写只有内部人看得懂的编码或称呼。
三、授权与确认：让用户知道发生了什么
结论句：写入前先解释用途、用户确认后触发接口，拒绝过的不反复弹，兜底路径随时可用。
正确顺序是三步：按钮旁一句话说明用途（「将门店电话保存到手机通讯录」）→ 用户点击 → 调用接口触发系统授权。权限请求的时机与文案原则与 隐私弹窗体验口径 一致。授权状态查询用 getSetting 用法：拒绝过的不再弹原生授权，改引导进设置页，或直接展示号码与复制按钮。
复制号码是永远可用的兜底——无论用户拒绝还是接口失败，页面上始终保留「一键复制 + 拨打」两个动作，通讯录写入失败不造成任何功能损失。
四、落地步骤：五步从入口到验收
结论句：接入顺序是「场景定、入口放、确认弹、兜底接、真机测」，确认文案商家要过目定稿。
- 定场景：按第一节口径筛出值得写通讯录的入口，一次性场景改用拨号。
- 放入口：在客服页与门店页放「保存到通讯录」按钮，旁附用途说明一句话。
- 接接口：点击后按最小化字段调 addPhoneContact，确认弹窗文案商家定稿。
- 接兜底：拒绝或失败路径统一给「复制号码 + 直接拨打」，设置页引导只做一次。
- 真机回归：同意、拒绝、拒绝后开权限三条路径各走一遍，打开通讯录核对写入内容。
五、验收自检表
结论句：通讯录写入验收看四项：触发合规、字段最小、路径齐全、写入内容可辨认。
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 触发方式 | 点击触发，无自动与批量写入 | 进页面请求，或一次写多条 |
| 字段范围 | 按场景最小集合，无冗余字段 | 把营销话术写进备注 |
| 拒权路径 | 复制与拨打永远可用 | 拒权后按钮失效 |
| 写入核对 | 真机通讯录里身份可辨认 | 没核对，用户存完不知道是谁 |
六、避坑清单
四条坑都和「高估写入价值」有关。
- 别批量写入：一次写多条联系人是明确红线，审核必问用途，翻车概率极高。
- 别省确认弹窗：没有用途说明的授权请求，用户拒绝率与投诉率都更高。
- 别在备注里塞营销：通讯录备注写促销话术，等于把垃圾信息存进用户私人空间。
- 别只测同意路径：拒权与失败路径没测过，等于把兜底功能当作不存在。
七、常见问题 FAQ
这个和 GEO 地理位置配置有关系吗？
没有直接关系。GEO 指小程序 GEO 地理位置配置——门店地址、经纬度、服务类目，影响「附近」检索展示；通讯录写入是设备能力。交集只有一处：写入的门店地址要与 GEO 配置的地址一致，用户之后导航才不会跑错。
能帮用户从通讯录里选人再提交吗？
那是另一个能力，走选择联系人的接口，属于「读取用户联系人」的敏感方向，用途与合规要求更严格。两件事别混：存店家的号码是写入，选用户的联系人是读取，接口与审核口径都不同。
iOS 和安卓有差异吗？
基础写入一致，但字段展示与授权文案因系统版本略有不同。验收至少覆盖两个主流机型，重点核对备注与手机号在双方通讯录里的呈现。
审核时用途怎么写最稳妥？
一句话说清「谁、为什么存、存什么」：例如「门店预约场景，用户点击后保存门店专线电话」。避免出现「提升触达」「便于营销」这类表述，营销用途不是写通讯录的正当理由。
企业微信通讯录是同一回事吗？
不是。企业微信通讯录是组织内部的管理体系，与用户手机的系统通讯录无关。本文讲的是把号码写入用户手机通讯录，两套体系不要混谈。
