博客
UnifyPort 团队的文章、教程和公告。
- 教程
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 之间原生通信的十亿用户平台。本文解析技术变化、对多智能体系统的影响，以及构建前需要考虑的问题。
阅读更多 →