用途:通过 Bitrix24 的 Webhook REST 接口操作 CRM 数据。所有示例假设已设置环境变量 BITRIX_WEBHOOK_URL 为你的 Webhook 基础地址。
主要能力: 用户:获取当前用户 user.current.json,列出用户 user.get.json。 线索:新增 crm.lead.add.json、查询 crm.lead.get.json、列表 crm.lead.list.json、更新 crm.lead.update.json、删除 crm.lead.delete.json。 联系人:新增 crm.contact.add.json、列表 crm.contact.list.json。 交易:新增 crm.deal.add.json、列表 crm.deal.list.json、更新阶段 crm.deal.update.json。 任务:新增 tasks.task.add.json、列表 tasks.task.list.json、完成 tasks.task.complete.json。 字段定义:通过 crm.lead.fields.json、crm.contact.fields.json、crm.deal.fields.json 获取可用字段。
使用方式:使用 curl 调用,GET 用于简单查询,POST 配合 JSON 文件用于复杂查询。常用参数包括 filter 过滤、select 选择字段、order 排序、start 分页偏移。示例: curl -s -X GET "$BITRIX_WEBHOOK_URL/user.current.json" curl -s -X POST "$BITRIX_WEBHOOK_URL/crm.lead.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json
限制与注意事项:妥善保管 Webhook 地址,不要公开;复杂查询建议用 POST;先用 *.fields.json 确认字段名;Bitrix24 有速率限制,批量操作应加延迟;结果分页,大数据集使用 start 参数。收费、价格、平台等信息暂未提供。