CRM 域把联系人(Contact)与商机(Opportunity)两类核心对象抽象为 ICrmService,消费方通过 DI 注入接口即可,无需关心具体供应商。
统一接口
ICrmService(命名空间 Bitzsoft.Integrations.Crm)定义 8 个方法,覆盖联系人与商机的增删改查:
| 方法 | 说明 |
|---|---|
CreateContactAsync | 创建联系人 |
GetContactAsync | 查询单个联系人 |
UpdateContactAsync | 更新联系人信息 |
DeleteContactAsync | 删除联系人 |
ListContactsAsync | 查询联系人列表(关键词搜索、分页) |
CreateOpportunityAsync | 创建商机 |
ListOpportunitiesAsync | 查询商机列表(按阶段过滤) |
UpdateOpportunityStageAsync | 更新商机阶段 |
接口还暴露 ProviderName 属性,返回运行时供应商名称(如 "HubSpot")。
包结构
Bitzsoft.Integrations.Crm/ ← 抽象层(ICrmService + DTO + ProviderDescriptors)Bitzsoft.Integrations.Crm.All/ ← 聚合包(拉入全部 5 家)Bitzsoft.Integrations.Crm.HubSpot/ ← HubSpotBitzsoft.Integrations.Crm.Dynamics365/ ← Microsoft Dynamics 365Bitzsoft.Integrations.Crm.Salesforce/ ← Salesforce(适配器,只读)Bitzsoft.Integrations.Crm.Zoho/ ← Zoho CRMBitzsoft.Integrations.Crm.Xiaoshouyi/ ← 销售易供应商清单
| 供应商 | Provider ID | 鉴权 | 文档 |
|---|---|---|---|
| HubSpot | hubspot | Private App Access Token Bearer | hubspot.mdx |
| Microsoft Dynamics 365 | dynamics-365 | Azure AD Client Credentials OAuth2(OData v4) | dynamics365.mdx |
| Salesforce | salesforce | OAuth 2.0 JWT Bearer(适配器,只读) | salesforce.mdx |
| Zoho CRM | zoho | OAuth2 Bearer Token | zoho.mdx |
| 销售易 | xiaoshouyi | OAuth2 Client Credentials Bearer | xiaoshouyi.mdx |