企业官网建设流程全解析

OpenIntegrations 是一个面向 1С:Предприятие、OneScript 与 CLI + MCP 的开源集成工具包，其中Bitrix24 模块可以帮你用几行脚本或一条命令行完成 Bitrix24 的任务创建与查询、文件上传、私信收发等高频操作。本文带你从鉴权配置快速上手，逐一拆解四大核心场景：活页（业务数据）、任务、文件与私信，全部配有可直接套用的命令示例与文档入口。

⚡ Bitrix24 集成快速上手：先搞定鉴权

调用任何 Bitrix24 接口前，你只需要两个东西：门户地址（URL）和凭据（Webhook 链接或 Token）。Bitrix24 官方提供两种接入方式，OpenIntegrations 对两者都做了统一封装：

🧩 方式一：3 分钟创建 Webhook

按官方引导依次进入应用（Приложения）→ Разработчикам（开发人员）→ Другое（其他）→ 传入式 Webhook：

在"其他"分类中选择"传入式 Webhook"，配置好所需权限后，复制生成的 Webhook 链接——它就是后续所有命令里的--url参数（此时--token留空即可）：

⚠️ Webhook 链接本身包含密钥，务必保密，不要提交到代码库。

🔑 方式二：本地应用 + Token 刷新

如果希望更规范地管理凭据（比如多权限、可刷新的 Token），选择"本地应用"，勾选"Использует только API"（仅使用 API），然后保存应用代码（client_id）与应用密钥（client_secret）：

之后把 client_id 交给GetAppAuthLink方法生成授权链接，浏览器登录拿到 code，再把 code、client_id、client_secret 交给GetToken换取 access token 与 refresh token。Token 会过期，用RefreshToken方法（传入 refresh token 即可）续期，刷新后两个 token 都会更新，记得重新保存。

完整步骤可对照官方文档：Bitrix24 入门指南（俄文版：docs/ru/md/Instructions/Bitrix24.md）。

✅ Bitrix24 任务管理：创建、查询、评论、看板一步到位

任务（Задачи）是 Bitrix24 的使用重头戏，OpenIntegrations 的 Bitrix24 模块几乎覆盖了任务生命周期中的每个动作。

1. 创建任务。通过CreateTask方法，用一段 JSON 描述任务字段（标题、描述、优先级、截止时间、负责人）即可下发一条新任务：

oint bitrix24 CreateTask \ --url "b24-ar17wx.bitrix24.by" \ --fields "{'TITLE':'New task','PRIORITY':'2','RESPONSIBLE_ID':'1'}" \ --token "***"

命令行示例见 docs/en/cli/bitrix24/CreateTask/bash.txt，字段含义的完整说明在 Create-task.mdx。

2. 灵活查询任务列表。GetTasksList支持按创建人、负责人、创建时间等条件过滤，也能指定只返回哪些字段、翻页偏移等，适合做日报汇总或数据同步：

oint bitrix24 GetTasksList \ --url "b24-ar17wx.bitrix24.by" \ --offset 1 \ --token "***"

示例参考 docs/en/cli/bitrix24/GetTasksList/bash.txt 与 Get-tasks-list.mdx。

3. 围绕任务的协作细节。创建任务后，常用动作都能直接调用：

• 加评论：AddTaskComment（示例：Add-task-comment.mdx）
• 看板流转：MoveTaskToKanbanStage把任务拖到指定阶段（Kanban 目录）
• 任务清单：AddTasksChecklistElement拆解步骤并逐项勾选（Tasks-checklists-management）
• 状态操作：StartTask/CompleteTask/PauseTask/DeferTask（Tasks-management）

📁 Bitrix24 文件管理：上传、外链与误删恢复

Bitrix24 的网盘与聊天文件夹都能被脚本化管理，常用动作包括：

• 上传文件到指定文件夹：UploadFileToFolder接受标题、文件（本地路径或 URL）和目标文件夹 ID，是自动化归档的常用入口：

oint bitrix24 UploadFileToFolder \ --url "b24-ar17wx.bitrix24.by" \ --title "Imortant doc.docx" \ --file "https://releases.openintegrations.dev/test_data/document.docx" \ --folderid 64974 \ --token "***"

（示例来自 docs/en/cli/bitrix24/UploadFileToFolder/bash.txt）

• 生成对外分享链接：GetFileExternalLink给文件生成可公开访问的 URL；
• 整理目录：MoveFileToFolder、RenameFile、MakeFileCopy、GetFolderItems（列出文件夹内容）；
• 安全网：MarkFileAsDeleted只是"放入回收站"，RestoreFile可以一键恢复，DeleteFile才是永久删除——自动化脚本里建议默认走"软删除"。

方法文档集中在 File-management，云盘（Storages）相关操作见 Storages-management。

💬 Bitrix24 私信管理：群聊与一对一消息自动化

"私信"对应 Bitrix24 的 Messengers（私聊 + 群聊）。OpenIntegrations 让你用程序代替手点：

• 拿到对话对象：GetDialog根据会话/用户 ID 获取私信与群聊信息（示例：docs/en/cli/bitrix24/GetDialog/bash.txt），GetUsers/FindUsers帮你先定位到正确的用户；
• 发消息（可带附件）：SendMessage支持文本、图片块（GetPictureBlock）和文件块（GetFileBlock），把"通知 + 附件"一次发到位，示例见 Message-management；
• 消息状态管理：MarkMessageAsReaded/MarkMessageAsUnreaded标记已读未读，SetMessageReaction给消息加表情回应，EditMessage/DeleteMessage修改或撤回；
• 群聊运维：CreateChat建群、AddUsersToChat拉人、ChangeChatTitle/ChangeChatPicture改群名和头像（Chats-and-dialogs-management）。

典型玩法：任务完成时自动在群内播报结果，或把每天未读私信汇总成日报——两三条命令就能搭起来。

🚀 进阶自动化：把 Bitrix24 跑成流水线

掌握四大场景后，还可以用这些"隐藏技能"提升自动化深度：

这些能力组合起来，就能搭出"线索进来 → 自动建任务 → 按看板推进 → 完成后私信通知客户"的完整自动化闭环。

📚 资源导航

• 官方 Bitrix24 集成文档：docs/en/md/Instructions/Bitrix24.md
• 全部 CLI 命令示例：docs/en/cli/bitrix24/（Windows 批处理版在bat.txt，Linux 版在bash.txt）
• 方法参数数据文件：docs/en/data/Bitrix24/
• 库源码（OneScript 模块，OPI_Bitrix24）：src/en/OInt/

最后提醒：Webhook URL 与 Token 等同于你门户的钥匙，请存放在安全的配置中；命令行执行成功后，可用--out选项或标准重定向把返回的 JSON 存下来，方便排查与二次处理。上手 OpenIntegrations 的 Bitrix24 模块后，你会发现"活页、任务、文件、私信"这套日常事务，真的可以交给脚本一键托管。