登录开始免费试用
easyCoexistence 官方 API

AI 智能体 SaaS 架构:在 WhatsApp、Instagram 和 TikTok 上触达您客户的客户

用于触达您客户的客户的 AI 智能体 SaaS 分为五层运行:连接层,每位客户通过 easyCoexistence 的 Partner API 连接 WhatsApp、Instagram、TikTok 及更多渠道;接收层,负责验证 Webhook 并将其排队;您自有的会话存储;运行您模型的智能体工作进程;以及发送层,通过各网络的官方 API 完成回复和发布,并跟踪状态事件。

smb_message_echoes

Webhook 描述的是一条从 Coexistence 号码上的 WhatsApp Business 应用发出的消息。

7 days

Meta 会重试您端点未接受的 WhatsApp Webhook 多长时间,这可能导致同一条消息被投递两次。

1 attempt

每条转发的 Instagram、Facebook 或 TikTok 事件的投递情况,不重试,也不保留副本。

24 hours

人发来消息后的 WhatsApp 客服窗口;窗口之外,企业只能发送已获批准的模板。

20 mps

同时使用 WhatsApp Business 应用和 Cloud API 的号码的固定吞吐量。

AI 智能体 SaaS 有哪些层?

共五层,各司其职,因此即使模型速度慢也不会丢失消息,某个账户断开也不会导致整个产品停摆。easyCoexistence 位于首层和末层:它负责连接账户并保持其正常工作,而会话逻辑和模型则留在您的后端。

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

如何对租户、渠道和会话建模?

使用三张表。租户即您的客户,其 id 会作为 external_ref 随每个连接会话发出,因此每个连接和状态事件返回时都会带上该标记。渠道行保存 WhatsApp 号码的 connection_id 或社交账户的 channel_id,并记录网络及其状态。会话由渠道以及此人在该网络上的 ID 共同确定:WhatsApp 中是来信号码 from;Instagram 私信中是 Instagram 范围内的 ID;TikTok 中是评论所在的线程。

入站事件应先落在哪里?

先写入持久化队列,然后才运行任何模型。接收端点会在 WhatsApp 投递中检查 URL 路径中的密钥,在转发的社交事件中检查 X-EC-Signature,随后把事件写入队列并返回 2xx。两类来源的行为不同:Meta 最多在 7 天内重试 WhatsApp Webhook,因此同一消息可能到达两次;而转发的 Instagram、Facebook 或 TikTok 事件只发送一次且不做保留,被您的端点丢弃的事件便无法找回。请按网络自身的消息或评论 ID 去重。

如何保证回复有序且及时?

每个会话配一个工作进程,并在每次发送前进行检查。智能体处理时锁定该会话,这样同一人的两条消息会依次回复,且绝不会重复回复。WhatsApp 回复发出前,请将此人的最后一条消息与 24 小时窗口进行比对;窗口关闭后,改为发送已获批准的模板。每个号码的发送排队速率不超过每秒 20 条消息,这是 Coexistence 号码的固定速率。同时请记住,TikTok 的回复是公开评论。

人工如何接管智能体?

通过渠道本身。使用 Coexistence 时,您客户的员工仍在同一号码上使用 WhatsApp Business 应用,其发出的每条消息都会以 smb_message_echoes 的形式到达您的 Webhook。请将回显视为交接信号:暂停该会话中的智能体,把员工的回复作为上下文提供给模型,并在安静一段时间后恢复,或在员工于您的产品中将其交还时恢复。Instagram 也会把账户自己的私信以回显的形式返回,因此同一规则可防止智能体自己回复自己。

智能体能否同时发布内容?

可以,通过同一个密钥。智能体起草帖子,您的后端则通过 POST /channels/:id/posts 将其排入队列,发布至 Instagram、Facebook、TikTok 和 LinkedIn,可提前 1 分钟至 90 天设置。post.published 与 post.failed 事件会回传到会话存储。由于 LinkedIn 的 API 条款限制自动发帖,LinkedIn 帖子只有在有人于您的产品中批准后才会发出。

连接中断时产品如何反应?

通过渠道行上的状态字段。状态事件会将其改为 disconnected、removed 或 suspended,智能体随即停止在该渠道发送,您的界面则请租户通过新的连接会话重新连接。connection.token_missing 事件会使号码仍能接收但无法发送,因此智能体改为为员工起草回复。connection.connected 或 channel.connected 会将该行恢复为 active,工作进程在下次回复前获取新的凭证。

您存储哪些数据,easyCoexistence 保留哪些数据?

会话由您的产品存储。WhatsApp 号码的消息从 Meta 直接发送至您的 Webhook,转发的社交事件则经由 easyCoexistence 传递,不保留副本。easyCoexistence 仅保留服务该连接所需的内容:账户记录、其令牌、健康历史,以及其发布的帖子。如果您的账户同时启用了 easyCoexistence 自带的自动化功能,其消息文本保留 7 天,运行日志保留 30 天。

常见错误

  • 仅用对方的电话号码作为会话的键。同一人可能同时给您的两个租户发消息,因此请将渠道和对方的 ID 合并作为每个线程的键。
  • 让两个工作进程同时回复同一会话。并行的工作进程可能导致回复乱序或重复发送,因此智能体处理某线程时应锁定该线程。
  • 员工通过 WhatsApp Business 应用回复后,仍让智能体保持开启。回显表示有人已接手该线程,因此应在此暂停智能体,直到您的交接规则将其交还。
  • 定时发布智能体起草的 LinkedIn 帖子。每篇 LinkedIn 帖子都需要人工批准,因此应先将这些草稿送入审核步骤,再进入队列。
使用 EasyCoexistence 完成这些操作

easyCoexistence 是您智能体产品的连接层:为您客户的 WhatsApp 号码及其 Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户,以及更多渠道,通过托管链接完成连接,并提供最新凭证、Webhook、发布队列和已签名的状态事件,每个连接全天候 24/7 受到监控。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费。

常见问题

您客户的客户需要安装任何东西吗?

不需要。他们照常在 WhatsApp、Instagram 私信或 Messenger 中,或在评论区向企业发消息,您的智能体会在同一渠道上回复。

您客户的员工能否继续手动回复?

可以。使用 Coexistence 时,WhatsApp Business 应用在同一号码上照常运行,员工发出的每条消息都会以回显的形式到达您的 Webhook,因此智能体可以主动让开。

easyCoexistence 会运行模型吗?

不会。模型、其提示词和记忆都在您的后端运行。easyCoexistence 负责连接账户、传递其事件,并保持其访问权限正常。

智能体 SaaS 每位客户需要支付多少 easyCoexistence 费用?

每个已连接的号码或账户每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,因此同时使用 WhatsApp 和 Instagram 的客户计为两次。前 3 天免费。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间