如何通过Bitrix24 API更新CRM联系人的文件类型字段?
Bitrix24 API更新CRM联系人文件字段(图片)解决方案
- 必须先完成前置操作:通过
disk.folder.uploadfile接口将图片上传至Bitrix24磁盘存储,获取文件ID后,再用该ID调用crm.contact.update接口更新对应字段。 - 具体操作步骤:
- 上传图片到磁盘
发起POST请求调用{{url}}/{{token}}/disk.folder.uploadfile.json,通过form-data传递参数:id:目标文件夹ID(可传-1代表根目录,或通过crm.contact.list获取联系人关联的磁盘文件夹ID)file:直接上传本地图片文件流(无需转base64)
接口返回结果中会包含文件的ID,记下来备用。
- 更新CRM联系人图片字段
调用crm.contact.update.json时,将自定义字段(比如UF_CRM_QR_CODE)的值设为文件ID的数组,参数格式如下:fields[UF_CRM_QR_CODE] = ["文件ID"]
- 上传图片到磁盘
- 关键注意点:
- Bitrix24的CRM文件类型字段不支持直接传入base64内容,仅接受已上传至系统磁盘的文件ID。
- 确保API权限包含
disk和crm的操作权限,否则会触发权限报错。
内容的提问来源于stack exchange,提问作者Angel Qua
相关产品推荐
相关产品推荐

