首页 专区 Skill 文章 专题 AI工具 学习 编程手册

PHP MySQL jquery HTML CSS
首页 > Skill > 商业运营

bigin-crm-skill

Polar Sponsor
爱发电 赞助
.NET 9.0
立即下载

使用 OAuth2 认证 API 在 Bigin CRM 中管理管道、联系人、公司、任务和活动，实现小型企业销售自动化。

／／ 大约 1, 一个简单的技能, 连接 Bigin CMM 到 OpenClaw.

功能概述

／／ 大约 1, 一个简单的技能, 连接 Bigin CMM 到 OpenClaw.是一项面向实际任务的技能，主要用于Prerequists.；Bigin 帐号( 建议开发者沙盒).；

核心要点

  • Python 3. 8／ 请求库( pip 安装请求) ／ 架构 ／ 核心 Fe。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

🏗️ 关于

一个用于将 Bigin CRM 接入 OpenClaw 的简易技能

前提条件

  • Bigin 账户（推荐使用开发者沙箱环境）
  • Python 3.8+
  • requests 库（执行 pip install requests 安装）

🏗️ 架构

┌─────────────────────────────────────────┐
│         OpenClaw Agent                  │
│  （您的个人销售助手）                   │
└─────────────────────────────────────────┘
           │
           ▼
┌─────────────────────────────────────────┐
│      Bigin CRM Skill（Python）          │
│  - OAuth2 认证                          │
│  - REST API v2 封装器                   │
│  - 销售管线自动化                       │
│  - 联系人/公司管理                      │
└─────────────────────────────────────────┘
           │
           ▼
┌─────────────────────────────────────────┐
│        Bigin CRM REST API v2            │
│  - 销售管线（核心销售模块）             │
│  - 联系人与公司                         │
│  - 任务、事件、通话                     │
│  - 产品与备注                           │
└─────────────────────────────────────────┘

🛠️ 核心功能

1. 认证与初始化

# 一次性 OAuth 初始化
bigin auth --client-id "1000.xxx" --client-secret "xxx"
# 自动打开浏览器进行 Bigin/Zoho 登录
# 凭据安全存储于 ~/.openclaw/credentials/bigin-crm.json

# 查看当前认证状态
bigin auth:whoami

2. 管线管理（核心功能）

# 创建一条管线记录（例如：商机/交易）
bigin pipeline create --contact-id 12345 --company-id 67890 
  --stage "Initial Contact" --amount 50000 
  --closing-date "2026-03-15" --owner "sales@yourcompany.com"

# 更新管线阶段
bigin pipeline update --id 12345678 --stage "Negotiation" 
  --amount 75000 --probability 70

# 推进至下一阶段
bigin pipeline advance --id 12345678

# 标记为成交或失败
bigin pipeline win --id 12345678
bigin pipeline lose --id 12345678 --reason "Budget constraints"

# 列出所有管线（按阶段、负责人筛选）
bigin pipeline list --stage "Proposal" --owner "me" --limit 50

# 搜索管线
bigin pipeline search --query "company:Acme" --stage "Open"

# 获取管线详情（含历史记录）
bigin pipeline get --id 12345678 --include-history

3. 联系人管理

# 创建联系人
bigin contact create --first-name "John" --last-name "Doe" 
  --email "john@company.com" --phone "+91-98765-43210" 
  --company "Acme Inc" --source "Website"

# 从 CSV 批量导入
bigin contact import --file contacts.csv --mapping mapping.json

# 搜索联系人
bigin contact search --query "company:Acme" --limit 100

# 更新联系人信息
bigin contact update --id 87654321 --phone "+91-99999-88888"

# 获取联系人详情（含关联管线）
bigin contact get --id 87654321 --include-pipelines

4. 公司管理

# 创建公司
bigin company create --name "Acme Inc" --industry "Technology" 
  --website "https://acme.com" --employees 50 
  --address "123 Business Park, Bengaluru"

# 搜索公司
bigin company search --query "industry:Technology"

# 获取公司详情（含全部联系人及管线）
bigin company get --id 67890 --include-contacts --include-pipelines

5. 任务与活动管理

# 创建跟进任务
bigin task create --related-to pipeline:12345678 
  --subject "Send proposal" --due "2026-02-25" --priority "High"

# 创建事件（会议）
bigin event create --related-to contact:87654321 
  --title "Product Demo" --start "2026-02-24 14:00" --duration 30 
  --location "Zoom"

# 记录一次通话
bigin call create --related-to contact:87654321 
  --subject "Discovery call" --duration 15 
  --outcome "Interested, follow-up scheduled"

# 列出即将到期的任务
bigin task list --due-before "2026-02-28" --status "Open"

# 标记任务为已完成
bigin task complete --id 54321

6. 管线自动化

# 自动分配未指派的管线（轮询模式）
bigin pipeline assign --unassigned --round-robin

# 为滞留管线创建跟进任务
bigin automation follow-up --stale-days 7 --create-tasks

# 基于用户活动自动推进管线阶段
bigin automation advance --auto-advance --criteria "proposal-sent-and-7-days"

# 批量更新管线阶段
bigin pipeline bulk-update --stage "Negotiation" 
  --new-stage "Closed Won" --criteria "probability-gt-80"

7. 报表与分析

# 管线报表
bigin report pipeline --by-stage --by-owner --output pipeline-report.csv

# 销售业绩报表
bigin report performance --owner "sales@company.com" 
  --month "2026-02" --output performance.json

# 销售预测（按概率加权）
bigin forecast --month "2026-03" --output forecast.csv

# 活动报表
bigin report activity --user "me" --week "2026-08" 
  --include-calls --include-tasks --include-events

8. AI 驱动功能

# 自动通过邮箱丰富联系人信息
"当我收到新发件人的邮件时，自动创建联系人，并检查其所属公司是否已存在"

# 智能管线评分
"基于以下维度对所有开放管线进行评分：最近活动时间、邮件回复情况、所处阶段时长、公司规模"

# 跟进提醒
"哪些联系人已超过 7 天未被触达？为其批量创建任务"

# 会议准备
"在我下午 2 点的产品演示前，请提供：该联系人历史记录、活跃中的管线、最近 3 封往来邮件、公司详细信息"

# 管线健康检查
"识别在相同阶段停留超过 14 天的管线，并建议下一步行动方案"

9. 与 Zoho Email Skill 集成

# 统一流程：邮件 → Bigin
# 1. 收到潜在客户邮件
# 2. 解析发件人信息 → 创建/更新联系人
# 3. 检查公司是否存在 → 如不存在则新建
# 4. 若无对应管线，则新建一条
# 5. 分配给销售代表
# 6. 设置跟进任务
# 7. 自动发送确认回执

📁 项目结构

bigin-crm-skill/
├── SKILL.md                          # 技能文档
├── config/
│   ├── bigin-config.json             # API 端点配置（bigin/v2）
│   └── oauth-config.json             # Client ID/secret 模板
├── scripts/
│   ├── bigin_crm.py                  # 主 Python 模块
│   ├── auth.py                       # OAuth2 流程（ZohoBigin 权限范围）
│   ├── pipelines.py                  # 管线操作（核心！）
│   ├── contacts.py                   # 联系人管理
│   ├── companies.py                  # 公司/客户账户管理
│   ├── tasks.py                      # 任务管理
│   ├── events.py                     # 事件/会议管理
│   ├── calls.py                      # 通话日志管理
│   ├── reports.py                    # 分析与报表
│   └── automation.py                 # 管线自动化
├── examples/
│   ├── bulk-import-contacts.csv      # 示例导入文件
│   ├── pipeline-mapping.json         # 管线阶段映射配置
│   └── automation-workflows/         # 预置工作流
│       ├── auto-assign.yaml
│       ├── follow-up-reminders.yaml
│       └── stage-advancement.yaml
├── tests/
│   ├── test_pipelines.py             # 管线单元测试
│   ├── test_contacts.py              # 联系人单元测试
│   └── test_automation.py            # 自动化单元测试
└── README.md                         # 安装与使用说明

📚 资源

Bigin API 文档

  • Bigin API v2 概览： https://www.bigin.com/developer/docs/apis/v2/
  • 模块 API： https://www.bigin.com/developer/docs/apis/v2/modules-api.html
  • 批量 API： https://www.bigin.com/developer/docs/apis/v2/bulk-read/overview.html
  • OAuth 指南： https://www.bigin.com/developer/docs/apis/v2/oauth-overview.html
  • 通知 API： https://www.bigin.com/developer/docs/apis/v2/notifications/overview.html

Zoho OAuth 控制台

  • API 控制台： https://api-console.zoho.com/
  • 创建 “Server-based Application” 类型应用以启用 OAuth2

🚀 快速开始

前提条件

  • Bigin 账户（推荐使用开发者沙箱环境）
  • Python 3.8+
  • requests 库（执行 pip install requests 安装）

步骤 1：创建 Zoho OAuth 应用

  1. 访问 https://api-console.zoho.com/
  2. 点击 “Add Client” → 选择 “Server-based Application”
  3. 设置重定向 URI：http://localhost:8888/callback
  4. 勾选权限范围：ZohoBigin.modules.ALL、ZohoBigin.settings.ALL
  5. 记录下 Client ID 和 Client Secret

步骤 2：初始化项目

mkdir -p ~/.openclaw/skills/bigin-crm-skill
cd ~/.openclaw/skills/bigin-crm-skill
touch SKILL.md README.md
mkdir -p scripts config examples tests

作者最新文章

如何将 Base64 编码的区块链交易载荷解析为结构化 Go 结构体

Singleton模式中饿汉式与懒汉式初始化的本质区别

React 中正确解析并排序 JSON API 数据的完整教程

JAX 中静态参数（static_argnames）与自动微分的冲突原理详解

Java 中单例模式的两种初始化方式：饿汉式与懒汉式详解

热门AI工具

更多
Lovart

Lovart

Hot 豆包大模型

豆包大模型

 Flowith

Flowith

Hot DeepSeek

DeepSeek

 Atoms

Atoms

Hot 墨刀AI

墨刀AI

Hot 咔片AIPPT

咔片AIPPT

Hot UP简历

UP简历

Hot

相关专题

更多
Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法，涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看，帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开，说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充，并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多
MDPHP(麦迪php框架系统)1.1
PHP 多国语言框架2.0
ujframe简单快速PHP开发框架1.0
php轻量型框架1.0
MyQEE开源PHP多项目及模块化开发框架3.0 RC2
php开源学习型框架CMVC1.2.0
PHP框架Kohana3.3.1

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习

PHP实战天龙八部之仿爱奇艺电影网站
PHP实战天龙八部之仿爱奇艺电影网站

共49课时 | 82.6万人学习

最新文章

更多
火山引擎怎么限制一次请求的工具调用次数_火山引擎工具调用轮数控制指南
VibeKnow怎么替换视频中调色后的图片
讯飞绘文怎么把同一主题写给不同读者_讯飞绘文文章受众适配技巧
Lovart AI扩图后图片边缘变形怎么办_Lovart AI边界区域失真处理方法
讯飞绘文怎么通过原文快速完成内容仿写
码上飞AI怎么写取消按钮文案_码上飞AI取消操作表达建议
VibeKnow套餐升级划算吗？各版本权益对比分析
超级麦吉AI怎么让纪要保留结论形成的原因_超级麦吉AI会议决策依据整理方法
立刻MV怎么让副歌突出歌曲主题_立刻MV副歌主题强化方法
Lovart AI怎么让PPT配图不抢走文字重点_Lovart AI演示图文主次安排方法