博客
- 对比选型
消息发错后：编辑、撤回还是仅本地隐藏？
区分 UnifyPort 已发文本编辑、本人消息撤回和本地收件箱隐藏，核对渠道支持、目标 ID 与结果不确定时的处理边界。
阅读更多 → - 教程
UnifyPort 群组 @ 提及：修复 WhatsApp 与 LINE 的普通文本标记
通过匹配顶层 mentions 与正文标记实现群组提及，排查标记原样显示、旧字段失效，以及 WhatsApp 和 LINE 的支持差异。
阅读更多 → - 教程
UnifyPort 媒体发送：文件 URL 与送达问题排查
正确构造图片、视频和文件发送请求，检查渠道能力与 URL 可访问性，区分请求已接受和消息已送达，避免不安全重试。
阅读更多 → - 对比选型
WhatsApp 置顶聊天与置顶消息：API 应该怎么选？
区分聊天列表置顶与会话内消息置顶，核对 UnifyPort 的目标 ID、时长参数、取消操作和事件范围，避免共享收件箱选错接口。
阅读更多 → - 对比选型
Webhook 维护：暂停 worker、停用端点，还是删除？
比较暂停业务处理、停用和删除 UnifyPort webhook 端点的不同作用范围，规划恢复流程，不把遗漏事件的重放当作保证。
阅读更多 → - 指南
LINE Login 与 Messaging API 的用户 ID 不同？先检查 Provider
排查 LINE 登录与消息渠道的用户 ID 不一致：核对 provider 归属，明确渠道迁移限制，并将 CRM 身份关联与消息路由分开。
阅读更多 → - 指南
LINE replyToken 过期怎么办？避免慢回复造成重复发送
区分 LINE 回复令牌过期、重复使用和发送结果未知，处理 webhook 重投，并判断延迟回复何时应改为独立的 push 消息。
阅读更多 → - 指南
WhatsApp 会话列表缺少聊天？先检查标签筛选
UnifyPort 的 WhatsApp 会话列表在省略 label_id 时只返回特别关注会话。排查筛选、分页和会话标识，避免把局部列表当成完整聊天档案。
阅读更多 → - 教程
用 contact.updated Webhook 同步 WhatsApp 联系人姓名
正确合并 WhatsApp 通讯录姓名变更：区分字段缺省与清空，保留本地昵称，并分离联系人 ID 和会话 ID。
阅读更多 → - 教程
用 request_id 和 X-Request-Id 追踪 UnifyPort API 错误
保留客户端与服务端请求标识，正确处理 204 空响应和超时，并区分请求追踪、webhook 去重与发送重试。
阅读更多 →