SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场sales-bitrix24

sales-bitrix24

营销与增长

查看项目

更新于 10-16 10:14

技能介绍

用途

本技能为 Bitrix24（bitrix24.com）平台提供使用辅助，重点覆盖 CRM 相关的自动化与集成开发。Bitrix24 是一款提供永久免费方案的一体化商务套件，内置完整 CRM（线索、交易、管道/漏斗、联系人、公司、Smart Process Automation 等）。

该技能首先收集上下文（若存在 references/learnings.md 则先读取以获取累积的平台知识），围绕六类典型需求展开：A) 通过 REST API 增改查线索或交易并映射管道/阶段；B) 用出站 Webhook（ONCRMDEALADD/UPDATE、ONCRMLEADADD）响应 CRM 变更；C) 选择认证方式——自有门户用入站 Webhook，构建供他人安装的应用用 OAuth 2.0；D) 批量调用与处理速率限制；E) 搭建 CRM 结构（管道、阶段、Smart Process Automation、联络中心）；F) 判断免费版与付费版、云端与自托管本地部署的取舍。若用户提示已提供足够上下文，可跳过收集步骤直接作答。

主要能力

  • 区分场景：自动化自己的账号用入站 Webhook；构建多租户/Market 应用用 OAuth 2.0。
  • 将跨厂商 CRM 选择、通用 iPaaS 集成、全渠道/联络中心或营销策略等问题路由到对应技能，例如 /sales-crm-selection、/sales-integration、/sales-do，并给出确切命令。
  • 提供平台参考：模块地图（CRM 与任务、联络中心、站点）、免费版与付费版、云端与本地部署模型、CRM 数据模型（线索/交易/管道结构）以及快速上手示例（创建交易、订阅交易事件、批量）。
  • 提供集成接口参考：基于方法的 REST API（https://{portal}.bitrix24.com/rest/{user_id}/{webhook_code}/{method}）、入站与出站 Webhook、应用用 OAuth 2.0、核心 crm.* 方法（crm.deal.add/.list/…、crm.lead.、SPA 用 crm.item.）、{result,time} 响应、批量（每请求 50 条命令）与速率限制。

使用方式与关键要点

  • 它是 RPC，不是资源型 REST：在 URL 上调用方法（crm.deal.add、crm.lead.list），而非 GET /deals；每个实体都有一致的 *.add/.update/.get/.list/.delete/.fields 方法集。
  • 自有门户用入站 Webhook：静态 URL 加密钥（Developer resources → Incoming webhook），不过期，按权限限定范围，是自动化自己账号最简单的方式；仅在多租户/Market 应用时用 OAuth 2.0。
  • 管道 = CATEGORY_ID，阶段 = STAGE_ID：交易的漏斗是 CATEGORY_ID（0 为默认），其列是 STAGE_ID（crm_status）；写入前先从 crm.dealcategory.* / crm.status.* 获取有效值。
  • 事件只携带 ID：出站 Webhook（ONCRMDEALUPDATE 等）POST {event, data:{FIELDS:{ID}}} 加应用令牌——校验令牌后用 crm.deal.get 获取当前数据，并去重。
  • 用批量应对速率限制：Bitrix24 有节流（约 2 请求/秒），使用 batch（最多 50 条命令，可用 $result[...] 链式引用）并在出错时退避。
  • 永久免费是卖点：免费方案用户数不限，常被用作 Keap/Ontraport/Zoho 的免费替代；付费层增加自动化/SPA 深度；如需自行托管可选择本地部署（Self-Hosted）。

适用场景

  • 开发者/自动化：表单提交后通过 API 在指定管道与阶段创建 Bitrix24 交易。
  • 集成：当交易更新时通过出站 Webhook 通知外部系统，并校验与去重。
  • 决策：评估免费版是否够用，以及选择云端还是自托管。

限制与注意事项

  • 内容为 2026-06 基于调研的最佳努力，功能/定价已对照营销站点与 API 文档，需在账号内确认。
  • 入站 Webhook 与 OAuth 不可混用：Webhook 属于你的门户、静态 URL 加密钥、不过期，但部分方法被禁用（电话、某些仅应用可用的操作）；OAuth 用于应用、令牌会过期需刷新。
  • 管道/阶段是 ID：CATEGORY_ID（漏斗）+ STAGE_ID（crm_status），使用标签或来自错误漏斗的阶段会失败或表现异常；先读 crm.status./crm.dealcategory.。
  • 速率限制真实存在：约 2 请求/秒持续限制加各方法运行时限，批量（每请求 50 条）并退避，否则会被节流。
  • 出站 Webhook 载荷很薄：只到实体 ID，需通过 *.get 重新获取；校验应用令牌；去重（事件可能重复）。
  • 平台庞大：CRM 只是众多模块之一，广度带来学习曲线；若只做 CRM 选型，可经 /sales-crm-selection 与专注型 CRM 权衡。
  • 云端与本地部署有差异：Self-Hosted 解锁源码/额外控制，且出站 Webhook 需有效许可证；云端为托管式，需审慎选择。