Mailgun邮件API集成金蝶云星空(事务邮件自动触达)解决方案
更新: 11/8/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Mailgun 邮件API | ![]() | 金蝶云星空 |
企业使用金蝶云星空管理销售订单、应收、发票与开票全流程,同时使用 Mailgun 作为事务邮件发送通道(订单确认、对账单、电子发票通知、回款提醒等)。两套系统割裂时,业务人员只能从 ERP 导出数据再手动群发,存在三大痛点:
- 触达滞后且低效:订单生成、发票开具后需人工导出表格、套模板、批量发送,最快也隔天,客户体验差。
- 送达不可追踪:邮件发出后是否被接收、打开、点击、退信完全未知,无法沉淀客户沟通轨迹。
- 数据不同步:邮件送达状态、退信、投诉等信号无法回流到 ERP,客户档案与沟通记录脱节,后续催收、回访缺乏依据。
通过成集云打通金蝶云星空与 Mailgun,可在业务事件发生时自动触发事务邮件,并将送达/打开/退信等事件回写 ERP,让"业务发生即触达、触达结果可追踪、追踪数据回业务"。
解决方案
基于成集云数据集成平台构建可视化自动同步任务,对接金蝶云星空开放 API 与 Mailgun REST API。金蝶侧业务单据(销售订单、应收单、发票)经成集云按模板组装为事务邮件后调用 Mailgun 发送;Mailgun 的送达、打开、点击、退信、投诉等 Webhook 事件经成集云签名校验后回写金蝶,更新客户沟通记录与送达状态,全流程自动化、无需人工干预。
业务流程
一、基础资料同步流程
1. 客户收件人同步流程
2. 邮件模板同步流程
二、事务邮件触发流程
1. 销售订单确认邮件
2. 对账单与回款提醒邮件
3. 电子发票开具通知
三、送达事件回传流程
1. 送达状态回写
2. 退信与投诉处理
对接说明
一、基础资料同步(金蝶云星空 → Mailgun)
- 金蝶客户(联系人、邮箱、名称)→ Mailgun 收件人列表,按客户分组管理,状态:已激活
- 金蝶单据字段(订单号、金额、发票号、到期日)→ 成集云映射为 Mailgun 模板变量(Handlebars
) - 邮件模板(订单确认 / 对账单 / 发票通知)预置 Mailgun Templates,发送时按名称引用
二、事务邮件触发(金蝶云星空 → Mailgun)
- 销售订单审核通过 → 触发订单确认邮件,收件人为订单客户邮箱
- 应收单临近到期 / 已逾期 → 触发对账单与回款提醒邮件
- 发票开具完成 → 触发电子发票通知邮件,PDF 发票作为附件
- 发送方式:Mailgun Messages API
POST /v3/{domain}/messages,Basic Auth(用户名为api,密码为 API Key)
三、送达事件回传(Mailgun → 金蝶云星空)
- Mailgun Webhooks(
delivered/opened/clicked/permanent_fail/complained)推送至成集云回调地址 - 成集云对
signature做 HMAC-SHA256 签名校验,防止伪造 - 校验通过后回写金蝶客户沟通记录:送达时间、打开时间、点击动作、退信/投诉标记
- 退信或投诉的客户在金蝶标记"邮箱无效/投诉",后续群发自动跳过
四、同步规则与过滤条件
- 仅向金蝶中"邮箱已验证"且状态正常的客户发送,黑名单客户自动过滤
- 同一单据 24 小时内不重复发送同一类型邮件(幂等去重)
- 批量对账单按客户聚合一封,避免一单一封造成骚扰
- 同步频率:单据事件发生即触发(即时);事件回传为 Mailgun 主动 Webhook 推送(近实时)
- 区域隔离:国内业务使用
api.mailgun.net,有 GDPR 要求的业务使用api.eu.mailgun.net
业务价值
- 触达即时化:订单、发票、对账单在业务发生的同一时刻自动发出,客户体验与回款效率同步提升
- 送达可追踪:打开、点击、退信、投诉全链路回流 ERP,客户沟通轨迹完整可追溯
- 数据一体化:邮件送达状态成为客户档案的一部分,催收、回访、营销决策有据可依
- 人工零介入:从导出、套模板、群发到状态回收全流程自动化,释放业务与财务人力
- 合规与口碑:退信/投诉自动降权,维护发信域名信誉,降低被 ISP 拦截风险
接口文档
- Mailgun API 文档(Messages / Events / Webhooks / Templates / Suppressions)
- 金蝶云星空开放 API 文档

