← 所有文章
公告

UnifyPort 新增 Facebook 消息接入:把单聊连接到你的客服与业务系统

客户在 Facebook 发来一条产品咨询。你的团队需要找到客户记录、安排客服跟进,再给出有用的回复。把这条消息连接到现有业务系统,是后续服务的起点。

UnifyPort 新增 Facebook 消息接入,与 WhatsApp、Telegram、LINE、X、Zalo 和 TikTok 一起纳入统一 API。开发者可以通过共用的消息接口发送单聊消息,并通过标准 Webhook 事件接收支持范围内的入站消息。

已经使用 UnifyPort 的团队,可以让 Facebook 成为现有工作流的另一个消息来源;正在开始集成的团队,也可以从 Facebook 这一个渠道起步。

增加一个渠道,沿用熟悉的处理方式

Facebook 消息可以进入你的应用处理其他 UnifyPort 渠道时使用的事件流程。启用 Webhook 并订阅 message.received,再由自己的后端决定下一步如何处理。

Facebook 接入会将支持范围内的端到端加密(E2EE)单聊消息映射为这一标准事件。你的应用可以根据所属消息账号和会话关联上下文,再把消息交给自己的客服队列或业务系统。

这让接入方式保持一致:接收事件、在应用中处理,再通过 POST /v1/messages 发送回复。各渠道的具体能力可以在消息支持说明中查看。

从文字交流扩展到多媒体沟通

Facebook 消息接入支持文本,以及单条图片、视频、音频和文件发送。你的应用可以据此设计更贴合沟通任务的回复方式:

  • 讨论商品时,发送一张产品图片。
  • 文字不容易解释清楚时,分享一段操作视频。
  • 需要客户稍后查看时,提供说明文档或文件。

按实际任务选择媒体,并用真实业务素材检查接收端的展示效果。音频等格式的具体表现可参照消息支持说明。

API 也提供账号当前同步范围内的会话列表,方便应用获取会话标识,再衔接后续处理流程。

让消息进入团队已有的工作流

一条入站消息,可以成为不同业务流程的起点:

  • 客服跟进: 在自己的客服系统中创建任务,由客服接手回复。
  • CRM 关联: 将会话关联到客户记录,保留这次沟通需要的上下文。
  • AI 辅助: 把消息交给自己的 AI 工作流生成回复建议,再由应用安排审核和发送。

客户匹配、任务分派和 AI 逻辑由你的应用实现,UnifyPort 提供消息和事件的接入能力。可以先从“接收一条产品咨询并回复”这样明确的任务开始,再逐步扩展。

使用已有 Facebook 会话开始接入

Facebook 通过已有授权的 Cookie 会话接入,准备过程分为四步:

  1. 将会话 JSON 放到服务端可访问、短期有效且受控的地址。
  2. 使用 provider=facebook 和 auth_mode=session 创建消息账号。
  3. 通过 session_url 导入会话。
  4. 确认授权完成且 runtime_status=running,再发送消息。

会话凭证留在服务端。账号和 Webhook 订阅准备好后,用一个测试会话验证完整链路:收到消息、进入自己的业务系统,再发送回复。

从一个 Facebook 会话开始

选择一个 Facebook 会话,以及一个希望衔接的业务任务,先跑通第一条消息流程。以后增加其他 UnifyPort 渠道时,可以沿用同样的接入思路。

查看 Facebook 接入指南,连接你的消息账号;也可以先创建 UnifyPort 工作区,开始准备集成。

UnifyPort API

让消息接入变成一条稳定的产品管线。

先用统一 API 跑通发送,再用标准事件把所有入站消息接回业务系统。