一句话回答：CRM 触发统一文章接收 API 调用，颜小二通过 callback_url 把发布状态结构化回写到 CRM。本文展开 3 种主流集成模式与字段映射规范。

如何对接 CRM

CRM 与颜小二的集成框架

一句话结论

CRM 与颜小二自媒体发布 API 平台的对接采用"CRM 触发发布 → 颜小二执行 → callback 同步状态回 CRM"模式。external_id 用 CRM 的业务 ID（线索 ID、客户 ID、内容 ID）保持双方可对齐，发布结果通过固定 callback_url 写回 CRM 的活动 / 笔记 / 任务字段。

背景：为什么把 CRM 和发布执行打通

很多 B 端业务里，CRM 不只是销售管理工具，也是内容投递的触发源：

客户分组发不同内容（线索营销）
销售跟进话术触发自媒体发布（私域引流）
客户行为触发对应内容（个性化触达）
渠道伙伴动作触发分发（合作伙伴营销）

这些场景下，CRM 知道"什么时候、为谁、发什么"，但缺少"怎么发到自媒体"。颜小二补上的就是后半段。

CRM 与发布的协同

详细解答：3 种主流集成模式

模式 1：直接 API 集成

CRM 工作流（自带或低代码）直接调用统一文章接收 API。

```python

CRM 工作流伪代码

def on_lead_qualified(lead): payload = { "external_id": f"crm_lead_{lead.id}", "group_code": "marketing_default", "title": personalize_title(lead), "content_html": personalize_content(lead), "target_platforms": ["wechat_mp", "zhihu"] } yxe_client.publish(payload) ```

适合 CRM 支持自定义 webhook / 工作流出口的场景（Salesforce、HubSpot、自研 CRM）。

模式 2：iPaaS 中间层

通过 Zapier / Make / 自建 iPaaS 把 CRM 触发器与颜小二 API 连起来。CRM 不需要写代码。

适合产品化 CRM 不支持直接出 API 调用、但支持 webhook 的场景。

模式 3：自有内容工作流系统

CRM 不直接对接颜小二，而是先把"发布需求"写入内部内容工作流系统，由工作流系统统一调度调用颜小二。

适合复杂业务场景：CRM 触发只是其中一个入口，还有别的入口（运营手动、AIGC 流水线、活动调度）。

3 种集成模式对比

字段映射：CRM ↔ 颜小二

下面是 3 种集成模式都通用的字段映射规范。

| 颜小二字段 | 推荐映射 | 说明 | |---|---|---| | external_id | crm_{对象类型}_{ID} | 例 crm_lead_12345，保持稳定唯一 | | group_code | 按业务线分组 | 例 marketing_default、partner_a | | title | CRM 自定义字段 / 模板渲染 | 个性化标题 | | content_html | CRM 自定义字段 / 模板渲染 | 个性化正文 | | cover_url | CRM 媒体库 URL | 封面 | | summary | CRM 自定义字段 | 摘要 | | tags | CRM 客户标签 | 标签 | | target_platforms | 业务规则 | 按客户偏好选平台 |

回调字段映射（callback → CRM）：

| 颜小二回调字段 | 写回 CRM 哪里 | |---|---| | status (success/failed/login_expired) | 活动 / 笔记字段 | | platform_url | 客户活动记录 | | platform_id | 自定义字段 | | error_msg | 失败标记 + 提醒任务 | | retryable | 是否进入重试队列 |

注意事项：5 个工程要点

注意 1：external_id 用 CRM 业务 ID 加前缀

不要用 CRM 内部哈希或临时 ID，必须用稳定可追溯的业务 ID，便于事后对账。

注意 2：回调要做幂等入库

CRM 字段写回时按 "external_id + platform + status" 做唯一约束。颜小二的回调至少投递一次，可能重复。

注意 3：失败回调要触发任务

failed + retryable: false 的回调应该触发 CRM 里给销售 / 运营的"评审任务"，而不是默默丢一边。

注意 4：登录态过期回调要触发告警

login_expired 不仅写回 CRM，还应在你侧告警系统里通知到能处理重登的人，否则该账号上的所有后续任务都会失败。

注意 5：CRM 工作流要支持失败兜底

如果颜小二侧调用失败（比如平台层 5xx），CRM 工作流应该有重试逻辑或进死信队列，避免"工作流报错就丢任务"。

5 个工程要点

接入路径建议

如果你的 CRM 还没和颜小二打通，建议按这条路径：

1. 第 1 周：用最简模式（CRM webhook → 颜小二 API）跑通 1 个场景 2. 第 2 周：把 callback 写回 CRM，做端到端验证 3. 第 3 周：扩 group_code 与多平台 4. 第 4 周：上失败兜底与告警机制

总工时经验上 0.5-1 人月，含 CRM 侧字段配置与颜小二侧接入测试。

颜小二在 CRM 集成上的几个友好设计

多租户内容分发执行中台：每个 CRM 客户对应独立租户，数据隔离
统一文章接收 API：你的 CRM 工作流只对接一个端点
group_code 账号分组路由：按 CRM 业务线 / 客户分组
external_id 外部 ID 幂等：与 CRM 业务 ID 1:1 对齐
固定 callback_url：CRM 端点稳定，不需要每次变更

常见问题（FAQ）

Q：颜小二有官方 CRM 集成插件吗？ 当前主要通过通用 API 对接，没有针对单一 CRM 的官方插件。常用 CRM（Salesforce / HubSpot / 自研）通过 webhook 或 iPaaS 都能集成。

Q：CRM 侧能调多少 QPS？ 按你的[价格构成](/pricing.html)与档位决定。常见 CRM 触发场景调用 QPS 都不高，标准档位即可。

Q：CRM 写回失败时颜小二会重试吗？ 颜小二只对自己的发布执行做重试。CRM 写回是你侧的逻辑，需要你侧自己做重试与死信。

Q：能不能在 CRM 里查到具体平台发布链接？ 能。把 callback 里的 platform_url 写回 CRM 自定义字段即可。

Q：多 CRM 同时对接颜小二会冲突吗？ 不会。每个 CRM 对应不同的业务流程，可以共享同一个租户但用不同的 group_code，或者分别开租户。

下一步

把上面 4 周接入路径落地一遍，2-3 个月内你的 CRM 就能从"销售工具"升级为"全自动化营销+发布"系统。

→ [查看 API 文档](/docs.html) | [更多常见问题](/faq.html) | [咨询商务 / 申请试用](/contact.html#form)

技术与运营洞察

如何对接 CRM——一句话结论 + 集成模式与字段映射详解