智能电话追踪与营销归因

通过托管 OAuth 连接 CallRail，追踪分析来电数据、管理追踪号码与企业标签，助力营销归因与客户洞察。

基本信息

• 技能名称?CallRail
• 中文名称?智能电话追踪与营销归因
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.2
• 标签?call-tracking, telephony, marketing-attribution, crm-integration, oauth, analytics, sales

使用方法

使用说明
核心功能
CallRail 技能提供对 CallRail 电话追踪平台的完整 API 访问能力，通过 Maton 托管的 OAuth 服务简化认证流程。核心功能覆盖四大模块：

1. 通话数据管理 — 支持查询通话记录、获取录音、更新客户信息（姓名、标签、线索状态、价值标记）及标记垃圾电话
2. 追踪号码管理 — 创建与配置来源追踪号码（Trackers），关联 Google My Business、搜索广告等渠道，配置呼叫路由与录音策略
3. 组织与分类 — 创建账户级或公司级标签系统，支持颜色编码，便于对通话进行多维分类与后续分析
4. 数据分析 — 提供通话汇总统计（summary）与时间序列数据（timeseries），支持按公司、追踪器、来源、媒介等维度分组，便于生成营销归因报告
   显著优点
   零配置 OAuth ：无需自行处理 CallRail 的 OAuth 2.0 流程，Maton 自动管理令牌生命周期与刷新
   统一入口 ：通过 api.maton.ai 单一端点访问，简化多账户管理，支持 Maton-Connection 头显式指定连接
   完整数据访问 ：覆盖账户、公司、通话、追踪器、用户、标签、通知、集成等全量 API 能力
   灵活的分页机制 ：支持传统 offset 分页与相对分页（relative_pagination），高效处理大规模数据集
   局限与风险
   写操作需人工确认 ：文档明确要求所有创建、更新、删除操作前须与用户确认目标资源及预期效果
   速率限制严格 ：常规 API 每小时 1,000 次、每日 10,000 次；SMS 与外呼呼叫有更严格限制，大规模数据同步需实现指数退避重试
   数据保留期 ：通话记录仅保留 25 个月，历史数据需自行归档
   依赖 Maton 服务可用性 ：代理层增加单点故障风险，且需持续维护 MATON_API_KEY 安全
   适用人群
   数字营销团队 ：需追踪广告渠道来电转化、优化投放 ROI
   销售运营 ：管理线索分配、通话标签与跟进状态
   客户成功团队 ：分析通话时长、录音质量，评估服务体验
   SaaS/平台开发者 ：将电话追踪数据集成至自有 CRM 或 BI 系统
   常规风险提示
   隐私合规 ：通话录音涉及敏感信息，需确保符合 GDPR、CCPA 及 HIPAA（如涉及医疗）要求
   密钥管理 ： MATON_API_KEY 需严格保密，避免硬编码或日志泄露
   OAuth 授权范围 ：用户授权时需注意 Maton 申请的权限范围，定期检查活跃连接
   错误处理 ：需妥善处理 429（限流）、503（服务不可用）等状态码，避免数据同步中断