Bitrix24 API 技能：通过 curl 管理 CRM、任务和用户，自动化业务流程

bitrix by vm0-ai/vm0-skills

105 周安装量

50 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill bitrix

CRM 自动化 API

🇨🇳中文介绍

Bitrix24 API

通过直接的 curl 调用使用 Bitrix24 REST API，以管理您 Bitrix24 工作区中的 CRM、任务和用户。

官方文档：https://apidocs.bitrix24.com/

使用时机

在您需要时使用此技能：

管理 CRM 潜在客户（创建、更新、列出、删除）
管理 CRM 交易和销售漏斗
管理 CRM 联系人和公司
创建和管理任务
获取用户信息
自动化业务流程

先决条件

登录到您的 Bitrix24 工作区
转到应用程序 → 开发者资源 → 现成场景 → 其他 → 传入 Webhook
创建一个新的 Webhook 并选择所需的权限（CRM、任务、用户）
复制 Webhook URL
将其存储在环境变量中

export BITRIX_WEBHOOK_URL="https://your-domain.bitrix24.com/rest/1/your-secret-code"

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 获取当前用户

获取有关已认证用户的信息：

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/user.current.json"

{
  "result": {
    "ID": "1",
    "NAME": "John",
    "LAST_NAME": "Doe",
    "EMAIL": "john@example.com"
  }
}

获取工作区中的用户列表：

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/user.get.json" | jq '.result[] | {ID, NAME, LAST_NAME, EMAIL}'

3. 创建潜在客户

写入 /tmp/bitrix_request.json：

{
  "fields": {
    "TITLE": "New Lead from API",
    "NAME": "John",
    "LAST_NAME": "Doe",
    "PHONE": [{"VALUE": "+1234567890", "VALUE_TYPE": "WORK"}],
    "EMAIL": [{"VALUE": "john@example.com", "VALUE_TYPE": "WORK"}]
  }
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

4. 获取潜在客户

将 <your-lead-id> 替换为实际的潜在客户 ID：

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.get.json?id=<your-lead-id>"

5. 列出潜在客户

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.list.json" | jq '.result[] | {ID, TITLE, STATUS_ID}'

写入 /tmp/bitrix_request.json：

{
  "filter": {"STATUS_ID": "NEW"},
  "select": ["ID", "TITLE", "NAME", "PHONE"]
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.list.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

6. 更新潜在客户

写入 /tmp/bitrix_request.json：

{
  "id": 123,
  "fields": {
    "STATUS_ID": "IN_PROCESS",
    "COMMENTS": "Updated via API"
  }
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.update.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

7. 删除潜在客户

将 <your-lead-id> 替换为实际的潜在客户 ID：

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.delete.json?id=<your-lead-id>"

写入 /tmp/bitrix_request.json：

{
  "fields": {
    "NAME": "Jane",
    "LAST_NAME": "Smith",
    "PHONE": [{"VALUE": "+1987654321", "VALUE_TYPE": "MOBILE"}],
    "EMAIL": [{"VALUE": "jane@example.com", "VALUE_TYPE": "WORK"}]
  }
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.contact.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.contact.list.json" | jq '.result[] | {ID, NAME, LAST_NAME}'

写入 /tmp/bitrix_request.json：

{
  "fields": {
    "TITLE": "New Deal from API",
    "STAGE_ID": "NEW",
    "OPPORTUNITY": 5000,
    "CURRENCY_ID": "USD"
  }
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.list.json" | jq '.result[] | {ID, TITLE, STAGE_ID, OPPORTUNITY}'

12. 更新交易阶段

写入 /tmp/bitrix_request.json：

{
  "id": 456,
  "fields": {
    "STAGE_ID": "WON"
  }
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.update.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

写入 /tmp/bitrix_request.json：

{
  "fields": {
    "TITLE": "New Task from API",
    "DESCRIPTION": "Task description here",
    "RESPONSIBLE_ID": 1,
    "DEADLINE": "2025-12-31"
  }
}

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/tasks.task.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/tasks.task.list.json" | jq '.result.tasks[] | {id, title, status}'

将 <your-task-id> 替换为实际的任务 ID：

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/tasks.task.complete.json?taskId=<your-task-id>"

获取任何实体的可用字段：

# 潜在客户字段
curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.fields.json"

# 联系人字段
curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.contact.fields.json"

# 交易字段
curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.fields.json"

参数	描述
`filter`	过滤结果（例如，`{"STATUS_ID": "NEW"}`）
`select`	要返回的字段（例如，`["ID", "TITLE"]`）
`order`	排序顺序（例如，`{"ID": "DESC"}`）
`start`	分页偏移量

保护 Webhook 密钥：切勿公开暴露您的 Webhook URL
复杂查询使用 POST：过滤器和字段选择使用 POST 效果更好
检查字段名称：使用 *.fields.json 方法获取有效的字段名称
速率限制：Bitrix24 有速率限制；批量操作时请添加延迟
分页：结果是分页的；处理大型数据集时使用 start 参数

🇺🇸English

Bitrix24 API

Use the Bitrix24 REST API via direct curl calls to manage CRM, tasks, and users in your Bitrix24 workspace.

Official docs: https://apidocs.bitrix24.com/

When to Use

Use this skill when you need to:

Manage CRM leads (create, update, list, delete)
Manage CRM deals and sales funnels
Manage CRM contacts and companies
Create and manage tasks
Get user information
Automate business workflows

Prerequisites

Log in to your Bitrix24 workspace
Go to Applications → Developer Resources → Ready-made scenarios → Other → Incoming webhook
Create a new webhook and select the required permissions (CRM, Tasks, Users)
Copy the webhook URL
Store it in the environment variable

export BITRIX_WEBHOOK_URL="https://your-domain.bitrix24.com/rest/1/your-secret-code"

Webhook URL Format

https://[domain]/rest/[user-id]/[secret-code]/[method].json

domain: Your Bitrix24 address
user-id: Webhook creator's ID
secret-code: Authentication token (keep secure)
method: API method name

How to Use

All examples assume BITRIX_WEBHOOK_URL is set to your webhook base URL.

1. Get Current User

Get information about the authenticated user:

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/user.current.json"

Response:

{
  "result": {
  "ID": "1",
  "NAME": "John",
  "LAST_NAME": "Doe",
  "EMAIL": "john@example.com"
  }
}

2. List Users

Get a list of users in the workspace:

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/user.get.json" | jq '.result[] | {ID, NAME, LAST_NAME, EMAIL}'

CRM - Leads

3. Create a Lead

Write to /tmp/bitrix_request.json:

{
  "fields": {
    "TITLE": "New Lead from API",
    "NAME": "John",
    "LAST_NAME": "Doe",
    "PHONE": [{"VALUE": "+1234567890", "VALUE_TYPE": "WORK"}],
    "EMAIL": [{"VALUE": "john@example.com", "VALUE_TYPE": "WORK"}]
  }
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

Response:

{
  "result": 123
}

4. Get a Lead

Replace <your-lead-id> with the actual lead ID:

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.get.json?id=<your-lead-id>"

5. List Leads

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.list.json" | jq '.result[] | {ID, TITLE, STATUS_ID}'

With filter:

Write to /tmp/bitrix_request.json:

{
  "filter": {"STATUS_ID": "NEW"},
  "select": ["ID", "TITLE", "NAME", "PHONE"]
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.list.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

6. Update a Lead

Write to /tmp/bitrix_request.json:

{
  "id": 123,
  "fields": {
    "STATUS_ID": "IN_PROCESS",
    "COMMENTS": "Updated via API"
  }
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.update.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

7. Delete a Lead

Replace <your-lead-id> with the actual lead ID:

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.delete.json?id=<your-lead-id>"

CRM - Contacts

8. Create a Contact

Write to /tmp/bitrix_request.json:

{
  "fields": {
    "NAME": "Jane",
    "LAST_NAME": "Smith",
    "PHONE": [{"VALUE": "+1987654321", "VALUE_TYPE": "MOBILE"}],
    "EMAIL": [{"VALUE": "jane@example.com", "VALUE_TYPE": "WORK"}]
  }
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.contact.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

9. List Contacts

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.contact.list.json" | jq '.result[] | {ID, NAME, LAST_NAME}'

CRM - Deals

10. Create a Deal

Write to /tmp/bitrix_request.json:

{
  "fields": {
    "TITLE": "New Deal from API",
    "STAGE_ID": "NEW",
    "OPPORTUNITY": 5000,
    "CURRENCY_ID": "USD"
  }
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

11. List Deals

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.list.json" | jq '.result[] | {ID, TITLE, STAGE_ID, OPPORTUNITY}'

12. Update Deal Stage

Write to /tmp/bitrix_request.json:

{
  "id": 456,
  "fields": {
    "STAGE_ID": "WON"
  }
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.update.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

Tasks

13. Create a Task

Write to /tmp/bitrix_request.json:

{
  "fields": {
    "TITLE": "New Task from API",
    "DESCRIPTION": "Task description here",
    "RESPONSIBLE_ID": 1,
    "DEADLINE": "2025-12-31"
  }
}

Then run:

curl -s -X POST "$(printenv BITRIX_WEBHOOK_URL)/tasks.task.add.json" --header "Content-Type: application/json" -d @/tmp/bitrix_request.json

14. List Tasks

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/tasks.task.list.json" | jq '.result.tasks[] | {id, title, status}'

15. Complete a Task

Replace <your-task-id> with the actual task ID:

curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/tasks.task.complete.json?taskId=<your-task-id>"

Get Field Definitions

Get available fields for any entity:

# Lead fields
curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.lead.fields.json"

# Contact fields
curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.contact.fields.json"

# Deal fields
curl -s -X GET "$(printenv BITRIX_WEBHOOK_URL)/crm.deal.fields.json"

Common Parameters

Parameter	Description
`filter`	Filter results (e.g., `{"STATUS_ID": "NEW"}`)
`select`	Fields to return (e.g., `["ID", "TITLE"]`)
`order`	Sort order (e.g., `{"ID": "DESC"}`)
`start`	Pagination offset

Guidelines

Keep webhook secret : Never expose your webhook URL publicly
Use POST for complex queries : Filters and field selections work better with POST
Check field names : Use *.fields.json methods to get valid field names
Rate limits : Bitrix24 has rate limits; add delays for bulk operations
Pagination : Results are paginated; use start parameter for large datasets

Weekly Installs

105

Repository

vm0-ai/vm0-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli84

opencode82

cursor82

codex79

github-copilot78

claude-code74

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

40,000 周安装

Bitrix24 API 技能：通过 curl 管理 CRM、任务和用户，自动化业务流程

🇨🇳中文介绍

Bitrix24 API

使用时机

先决条件

相关 Skills

Webhook URL 格式

如何使用

1. 获取当前用户

2. 列出用户

CRM - 潜在客户

3. 创建潜在客户

4. 获取潜在客户

5. 列出潜在客户

6. 更新潜在客户

7. 删除潜在客户

CRM - 联系人

8. 创建联系人

9. 列出联系人

CRM - 交易

10. 创建交易

11. 列出交易

12. 更新交易阶段

任务

13. 创建任务

14. 列出任务

15. 完成任务

获取字段定义

常用参数

指南

🇺🇸English

Bitrix24 API

When to Use

Prerequisites

Webhook URL Format

How to Use

1. Get Current User

2. List Users

CRM - Leads

3. Create a Lead

4. Get a Lead

5. List Leads

6. Update a Lead

7. Delete a Lead

CRM - Contacts

8. Create a Contact

9. List Contacts

CRM - Deals

10. Create a Deal

11. List Deals

12. Update Deal Stage

Tasks

13. Create a Task

14. List Tasks

15. Complete a Task

Get Field Definitions

Common Parameters

Guidelines

最新 Skills