博客
UnifyPort 团队的文章、教程和公告。
- 教程
通过 API 退出 WhatsApp 群组：安全操作流程
使用 UnifyPort 和正确的账号、群组 ID 退出 WhatsApp 群组，分清成员关系、历史清理、排队回复与结果未确认时的处理。
阅读更多 → - 教程
Telegram 格式解析失败：安全发送带 HTML 的动态文本
排查 Telegram parse_mode 格式错误，正确转义客户姓名和生成式回复，并区分 Bot API 与 UnifyPort 的 provider_data 参数。
阅读更多 → - 教程
LINE 加载动画不显示？检查聊天类型与显示时机
使用 chatId 和 loadingSeconds 显示 LINE 加载动画，排查不可见、提前消失和重复刷新问题，并区分动画计时与回复令牌。
阅读更多 → - 教程
Telegram Bot API 429：用 retry_after 安排发送队列
持久化 Telegram retry_after 截止时间，让多个 worker 共享冷却状态，并把限流拒绝与发送结果未知分开处理；不要混用 Bot API 和 UnifyPort 契约。
阅读更多 → - 教程
通过 API 设置 WhatsApp 群管理员：提升与取消权限
使用 UnifyPort 管理 WhatsApp 群管理员，正确选择成员 LID、检查角色并核对结果，避免把取消管理员误写成移出群聊。
阅读更多 → - 教程
通过 UnifyPort 添加与移除消息表情回应
使用正确的消息目标和 sender_id 为 WhatsApp、Telegram 添加或移除表情回应，并区分主动操作与 reaction webhook。
阅读更多 → - 教程
通过 API 获取 WhatsApp 群邀请链接：读取不等于重置
使用 UnifyPort 获取 WhatsApp 群邀请链接，控制链接分发，并在原生重置后更新缓存，避免误把读取接口当成重置接口。
阅读更多 → - 教程
WhatsApp 会话如何跨标签交接：安全的 API 操作流程
使用 UnifyPort 将 WhatsApp 会话移到另一工作流标签：先添加目标标签，核实后移除来源标签，保留其他分类并处理不确定结果。
阅读更多 → - 教程
WhatsApp 联系人备注：设置或清空私有显示名称
使用 UnifyPort 设置和清空 WhatsApp 联系人备注，区分账号级名称、CRM 别名、通讯录姓名同步与联系人名片。
阅读更多 → - 教程
UnifyPort 群组 @ 提及：修复 WhatsApp 与 LINE 的普通文本标记
通过匹配顶层 mentions 与正文标记实现群组提及，排查标记原样显示、旧字段失效，以及 WhatsApp 和 LINE 的支持差异。
阅读更多 → - 教程
UnifyPort 媒体发送：文件 URL 与送达问题排查
正确构造图片、视频和文件发送请求，检查渠道能力与 URL 可访问性，区分请求已接受和消息已送达，避免不安全重试。
阅读更多 → - 教程
用 contact.updated Webhook 同步 WhatsApp 联系人姓名
正确合并 WhatsApp 通讯录姓名变更：区分字段缺省与清空，保留本地昵称，并分离联系人 ID 和会话 ID。
阅读更多 → - 教程
用 request_id 和 X-Request-Id 追踪 UnifyPort API 错误
保留客户端与服务端请求标识，正确处理 204 空响应和超时，并区分请求追踪、webhook 去重与发送重试。
阅读更多 → - 教程
按需加载 WhatsApp 更早消息：历史请求与异步回调实现
使用 UnifyPort 实现安全的“加载更早消息”：订阅历史事件、合并异步批次、推进有效锚点，并正确处理超时与完成状态不确定性。
阅读更多 → - 教程
Webhook 媒体相册聚合：合并展示照片，不丢失子消息
按消息 ID 保存相册子项，按带账号与会话范围的相册 ID 聚合，正确处理重复投递、缺失总数和迟到照片，不把等待超时当作完整性证明。
阅读更多 → - 教程
安全轮换 UnifyPort Webhook 签名密钥
先部署临时双密钥验证，再更新 signing_secret，最后按验收条件停用旧密钥；无需关闭 HMAC，也不假设服务端提供轮换宽限期。
阅读更多 → - 教程
WhatsApp 引用回复：reply_token 与父消息 ID 有什么区别？
通过 UnifyPort 引用 WhatsApp 消息时，应使用当前消息的 reply_token，而不是父消息 ID。了解 token 缺失、invalid_reply_token 和渠道支持边界。
阅读更多 → - 教程
处理 LINE 撤回事件：避免已删除消息重新出现在收件箱
通过 message.deleted 清理 LINE 撤回消息在收件箱、搜索与 AI 上下文中的副本，并阻止迟到的消息和编辑事件恢复内容。
阅读更多 → - 教程
WhatsApp Passkey 二维码认证：安全接入 Webhook 的操作指南
面向 UnifyPort 的 WhatsApp QR + Passkey 接入指南：创建消息账号、启动二维码认证、继续 WebAuthn Passkey 分支，并验证签名入站事件。
阅读更多 → - 教程
Telegram getUpdates 与 setWebhook 冲突：安全切换 Runbook
Telegram 机器人在 getUpdates 和 setWebhook 之间切换后收不到消息时，用这份 runbook 先确认当前接收模式，再清理旧接收端、处理待收更新，并判断是否应该改用统一入站 webhook。
阅读更多 → - 教程
Telegram 媒体附件统一 Webhook：照片、语音、文档、联系人和位置怎么处理
用 UnifyPort 的标准 message.received 事件处理 Telegram 媒体消息：映射文本、附件、联系人和位置，先做 HMAC-SHA256 验签，再安全入库。
阅读更多 → - 教程
Zalo QR 授权：处理 qrcode_expired 并接收签名 Webhook
用 QR 授权连接 Zalo 消息账号，安全处理 qrcode_expired，并在路由客服消息前验证签名的 message.received Webhook。
阅读更多 → - 教程
用二维码授权把 TikTok 账号接入签名 Webhook
面向跨境团队的 TikTok 入站接入步骤：先注册带签名的 UnifyPort webhook，再创建 TikTok 账号、轮询二维码授权状态，并接收标准化 message.received 事件。
阅读更多 → - 教程
用 UnifyPort 搭建 WhatsApp 群组入群申请审批队列
把 WhatsApp 群组入群申请变成可签名、可审计的审批队列：用 group.join_request 触发同步，再用列表接口和批量审批接口完成处理。
阅读更多 → - 教程
创建 UnifyPort API key 之后：第一个 Webhook 测试清单
面向新 UnifyPort workspace 的首轮上线清单：验证 API key、创建带签名的 webhook endpoint、保存 message.received 事件，并避开第一天最常见的集成错误。
阅读更多 → - 教程
用 GitHub Copilot 搭一个 TikTok DM Webhook 接收器
把 UnifyPort webhook 文档交给 GitHub Copilot，让它生成一个能校验 HMAC-SHA256、存储 message.received 事件并进入客服队列的 TikTok 入站接收器。
阅读更多 → - 教程
UnifyPort 入站集成：先建 Webhook 的检查清单
把 UnifyPort 入站集成从 signed webhook 开始：注册端点、验证 message.received、先入库，再连接 WhatsApp、Telegram、LINE、TikTok、Zalo 或 X 消息账号。
阅读更多 → - 教程
Telegram 群组入群申请：搭建可靠的审批队列
用定时拉取作为 Telegram 入群申请的事实来源，用 webhook 事件触发刷新，并批量批准或拒绝成员申请。
阅读更多 → - 教程
如何用 message.updated Webhook 处理 LINE 消息编辑
LINE 已为符合条件的群聊新增 messageEdited Webhook 事件。本文介绍如何在 UnifyPort 中将其作为 message.updated 处理，并避免共享收件箱产生重复消息。
阅读更多 → - 教程
如何在 WhatsApp 共享收件箱中同步已读与未读状态
使用 UnifyPort 的会话已读/未读动作、消息回执与 conversation.updated 事件，构建可靠的 WhatsApp 共享收件箱状态同步。
阅读更多 → - 教程
如何在统一 Webhook 中处理消息表情回应
安全处理 UnifyPort 的 message.reaction 事件：定位原消息、区分新增与移除表情、验证 HMAC-SHA256，并以幂等方式更新回应状态。
阅读更多 → - 教程
UnifyPort Webhook 事件筛选：用 subscribed_events 还是通配符？
了解创建 UnifyPort Webhook 端点时如何在明确的 subscribed_events 与 ["*"] 通配符之间选择，并直接套用适合收件箱、账号状态和完整事件采集器的配置。
阅读更多 → - 教程
如何零停机轮换 UnifyPort API Key
替换 UnifyPort API Key 时避免认证中断：先创建第二把 Key，完成部署与验证，再停用旧 Key；同时说明何时不该直接调用即时轮换接口。
阅读更多 → - 教程
WhatsApp 联系人 API：添加联系人与发送 vCard 的区别
了解如何区分把联系人加入已连接 WhatsApp 账号的通讯录，以及在聊天中发送 vCard 联系人名片，并使用正确的 UnifyPort 路由、字段和错误处理。
阅读更多 → - 教程
把 Telegram 个人账号接入 Webhook：验证码与二维码配置指南
从 Telegram API ID/API hash、签名 Webhook 到验证码或二维码授权，完整配置现有 Telegram 个人账号并接收 message.received 事件。
阅读更多 → - 教程
消息账号运行时恢复：该刷新、重连、启动还是重新认证？
根据 runtime_status 和认证状态选择正确的 UnifyPort 恢复动作，避免重启正常连接，或把连接故障误判为认证失效。
阅读更多 → - 教程
TikTok Shop Customer Service API Webhook 上线检查清单
配置 TikTok Shop Customer Service API 的 New Message webhook，完成签名校验、快速应答、幂等处理、历史对账与生产验收。
阅读更多 → - 教程
Telegram API_ID_PUBLISHED_FLOOD 错误怎么解决：恢复清单
定位 Telegram API_ID_PUBLISHED_FLOOD，用自有应用凭据替换公开的示例 API ID，区分相关授权错误，并在不泄露密钥的前提下恢复登录。
阅读更多 → - 教程
LINE MINI App 再审发布：正确处理 Approved 与 Reflected
厘清哪些已认证 LINE MINI App 变更需要再审，Approved 如何变为 Reflected，以及如何避免 30 天自动发布边界。
阅读更多 → - 教程
LINE MINI App Service Message API 错误排查：400、401、403、429 与 500
按 token 签发与消息发送两个阶段排查 LINE MINI App Service Message API 错误，正确保存更新后的 token，并为不同状态码选择安全的重试策略。
阅读更多 → - 教程
WhatsApp Embedded Signup 完成后如何验收：后端核对清单
WhatsApp Embedded Signup 完成后，逐项核对 WABA、系统用户权限、号码状态、webhook 订阅和首次真实投递，再将租户标记为可用。
阅读更多 → - 教程
为排队回复实现 WhatsApp 24 小时发送护栏
用服务端状态机阻止过期的 WhatsApp 排队回复，安全处理窗口重置，并在真正发送前选择合法路径。
阅读更多 → - 教程
Telegram Bot API 10.2 Communities：处理群聊加入与移除事件
了解 Telegram Communities 在 Bot API 10.2 中的事件结构，正确处理 community_chat_added 与 community_chat_removed，并区分社区拓扑和跨渠道消息队列。
阅读更多 → - 教程
LINE 已读 API 迁移指南：2026 年 10 月前改用 markAsRead
从需要单独申请的 LINE 旧版已读 API 迁移到 POST /v2/bot/chat/markAsRead，正确使用 webhook 中的 markAsReadToken，并保留 Official Account Chat。
阅读更多 → - 教程
LINE MINI App 支付 Webhook 漏单恢复：7 天对账 Runbook
通过 LINE 官方 7 天事件历史、cursor 分页和 orderId 幂等处理，恢复遗漏的 MINI App 支付 Webhook，并建立可复用的对账流程。
阅读更多 → - 教程
如何使用通知令牌发送 LINE MINI App 服务消息
详解 LINE MINI App 服务消息的通知令牌签发、保存、轮换与发送流程，包括官方接口、次数限制、模板要求和错误处理。
阅读更多 → - 教程
如何在群聊中发送 Telegram 临时机器人消息
了解 Bot API 10.2 的私密群组回复规则：适用触发条件、15 秒窗口、管理员权限、送达限制，以及编辑和删除方法。
阅读更多 → - 教程
Webhook HMAC 重放防护：时间戳、重试与幂等性
验证 RFC 3339 时间戳与原始请求体的 HMAC-SHA256 签名，以阻止 Webhook 重放请求，再按事件 ID 对合法重试去重。
阅读更多 → - 教程
WhatsApp Embedded Signup v4 的 Coexistence 迁移：2026 年 10 月 15 日前检查清单
Meta 将于 2026 年 10 月 15 日弃用 Embedded Signup v2。使用这份配置、webhook、callback 与发布检查清单，将 WhatsApp Coexistence onboarding 迁移到 v4。
阅读更多 → - 教程
如何追踪并计算 2026 年 10 月起的 WhatsApp 服务消息费用
通过 Pricing Analytics 和状态 webhook，为 WhatsApp 2026 年 10 月 1 日启用的服务消息计费建立测量方案，分清对话、消息类别与 AI 代理费用。
阅读更多 → - 教程
用签名入站 Webhook 搭建 n8n WhatsApp AI Agent
n8n 很适合做 AI 工作流，但 WhatsApp 客服自动化首先需要稳定的入站事件流。本文演示如何把 UnifyPort 的 message.received 签名 webhook 接入 n8n production workflow。
阅读更多 → - 教程
TikTok 数据可携带不等于实时私信：搭建客服真正需要的入站队列
TikTok Data Portability API 已更清晰地列出私信导出数据，但导出不是实时客服消息流。本文说明如何用 UnifyPort webhook 搭建带签名校验的 TikTok 入站队列。
阅读更多 → - 教程
把 Webhook 文档丢给 Devin Desktop，20 分钟搞定 LINE 消息接收服务
实战记录：把 UnifyPort API 文档喂给 Devin Desktop（原 Windsurf），用 Python 搭建 LINE 入站消息处理器——HMAC-SHA256 签名校验、结构化日志、多平台扩展——不需要 LINE 官方账号。
阅读更多 → - 教程
我让 Cursor 对着 Webhook 文档，用半小时搭了个 Telegram 转 Slack 的消息中继
构建日志：把 UnifyPort 的 Webhook 文档喂给 Cursor，让它用 Node.js 搭一个 Telegram 转 Slack 的消息中继——签名验证、Slack Block Kit 格式化、多渠道转发——不用注册 Telegram 机器人。
阅读更多 → - 教程
我让 Claude Code 搭了一个 X 私信和提及监听器——完全没碰 X 的 API
构建日志：把 UnifyPort webhook 文档喂给 Claude Code，让它用 Node.js 搭建 X 私信和提及监听器——签名验证、结构化日志、Discord 告警——不用支付 X 的按次计费 API 费用。
阅读更多 → - 教程
我把 API 文档丢给 Claude Code，它帮我搭了一个 Zalo Webhook 接收器
构建日志：把 UnifyPort API 参考文档喂给 Claude Code，让它用 Python 搭建一个 Zalo webhook 接收器——签名验证、消息记录、转发到 Slack——不到一小时搞定。
阅读更多 → - 教程
我把 Webhook 文档丢给 AI 编码助手,它直接搭出了一个能跑的自动回复机器人
一份开发实录:把 UnifyPort 的 webhook 接口文档喂给 Cursor、Claude Code 这类 AI 编码助手,看它在一个下午里搭出真正能跑的自动回复机器人——签名校验、入站路由、回复调用,一气呵成。
阅读更多 → - 教程
不靠官方 API，如何接收 WhatsApp 入站消息
2026 年 Meta 的几项变化——按条计费、企业认证门槛、禁止通用 AI 机器人——把官方 WhatsApp API 的门槛抬高了。如果你要的只是可靠地接收入站消息，还有另一条路能走。
阅读更多 → - 教程
TikTok Shop 12 小时规则：为什么你的客服系统需要事件驱动架构
TikTok Shop 已将 DM 响应时间纳入店铺健康评分。人工处理在直播期间必然崩溃。本文介绍事件驱动系统如何应对流量爆发，以及跨渠道扩展的架构思路。
阅读更多 → - 教程
Telegram Bot-to-Bot API：对 AI Agent 架构意味着什么
Telegram 悄然成为首个支持 Bot 之间原生通信的十亿用户平台。本文解析技术变化、对多智能体系统的影响，以及构建前需要考虑的问题。
阅读更多 →