Kit(原 ConvertKit)API 集成,支持托管 OAuth。可管理邮件订阅者、表单、标签、序列、广播及自定义字段。当用户需要管理邮件营销列表、创建或更新订阅者、管理标签,或处理邮件序列和广播时,请使用此技能。对于其他第三方应用,请使用 api-gateway 技能。

安装

概览

Kit(原 ConvertKit)API 集成工具通过统一的网关接口,为开发者提供对 Kit 邮件营销平台的全面管理能力。该工具封装了 Kit V4 API 的所有核心功能,并集成了托管式 OAuth 认证机制,用户无需自行处理复杂的身份验证流程即可安全访问订阅者、标签、表单、序列、广播等关键资源。所有请求均通过 `https://gateway.maton.ai/kit/{native-api-path}` 转发至官方 API 端点,自动注入有效的 OAuth token,极大简化了第三方应用与 Kit 的对接过程。开发者只需在 Maton 平台生成 API 密钥并配置环境变量 `MATON_API_KEY`,即可快速开始调用各类管理接口,实现自动化邮件营销流程的构建与维护。

核心功能特点

  1. 支持完整的 Kit V4 API 功能覆盖,包括订阅者、标签、表单、序列、广播、自定义字段和 Webhook 的管理
  2. 内置托管 OAuth 认证系统,自动处理连接创建、授权及令牌刷新,降低集成复杂度
  3. 提供标准化的网关代理接口,统一请求格式并支持多连接环境下的连接指定
  4. 兼容主流编程语言,支持 Python、JavaScript 等常见开发环境的代码示例
  5. 采用游标分页机制优化大数据量查询性能,支持按状态、时间范围、邮箱地址等多维度筛选

适用场景

该工具特别适合需要与 Kit 邮件营销平台深度集成的自动化场景。例如,当企业运营多个内容创作者账户时,可通过此工具批量管理不同创作者的订阅者列表,并根据用户行为动态分配标签或加入特定邮件序列。对于电商类应用,可在用户完成购买后自动将其添加至‘已购用户’标签组,并触发后续的产品推荐广播;而对于 SaaS 产品而言,新注册用户可被即时纳入欢迎邮件序列,提升转化率。此外,借助 Webhook 功能,外部系统可在订阅者状态变更(如激活、退订)时实时接收通知,从而联动其他业务系统执行后续操作。无论是构建内部管理工具、开发客户自动化流程,还是搭建跨平台数据同步管道,该技能都能显著减少重复性编码工作,提高系统集成效率。