SuperAPI AI 工具集

b24jssdk-recipes

数据与分析

查看项目

更新于 10-15 20:06

技能介绍

用途:这是一组十三个端到端示例程序,展示如何用 @bitrix24/b24jssdk 构建 Bitrix24 迷你应用,覆盖 CRM 分析、群发消息、任务自动化、ERP 同步、磁盘文件操作、Telegram 机器人、Webhook 处理、AI 助手、联网检索、错误处理、事件注册、OAuth 安装与延迟批量导出。

主要能力:所有示例统一使用 $b24.actions.v{2,3}.*.make() 接口;旧的 callMethod / callBatch / callListMethod / fetchListMethod 已在 3.0.0 移除,不应再基于其编写代码。示例默认运行于 Node 下的 B24Hook,但函数体接收 $b24: TypeB24,因此在框架内也可用,只需把启动改为 initializeB24Frame()(第 13 个示例除外,其结果为从门户下载文件)。

使用方式:安装 pnpm add @bitrix24/b24jssdk,设置环境变量 export B24_HOOK='https://YOUR_PORTAL.bitrix24.com/rest/1/...',再用 npx tsx examples/01-crm-analytics.ts 运行,无需构建步骤。部分示例需额外依赖,如 node-cron、grammy、express、openai。

限制与注意事项:order 在 callList.make 中会被静默忽略,应改用 filter 收窄;customKeyForResult、idKey、cursorIdKey 需按方法正确设置,否则可能得到空数组;REST 错误会抛 AjaxError;多漏斗的阶段 ID 可能带分类前缀(如 C2:WON);复制单个示例时部分需一并复制 lib/ 下的共享工具(第 1、3、6 个需 lib/funnel.ts,第 7、12 个需 lib/crypto.ts)。第 12 个示例的 B24_OAUTH_STORE 默认写入工作目录下的 .oauth-store.json,实际服务器上通常不宜如此。