API接入

API接入通过接口连接通信能力与企业业务系统，让系统可以调用服务、查询数据并接收结果。它关注数据和业务动作如何交换，具体范围以实际平台接口文档和项目能力为准。

API可把通信记录与客户资料关联，驱动CRM回写、工单或后续任务。能调用哪些能力、使用哪些字段，以实际平台接口文档和项目能力为准。

SIP负责实时语音连接，API负责通话前后的客户数据、业务状态和动作。两者可以组合，但不相互替代。

AI要查询客户身份、订单或办理报修时，需要获得企业业务系统授权接口。单独接通电话不会自动获得这些数据，接口范围与权限需确认。

双方接口兼容且授权允许时，可关联客户、通信记录、状态和后续任务。具体字段与调用范围以实际平台接口文档和项目能力为准。

需要订单或ERP系统提供已授权的查询接口，并确认客户身份和可访问范围。不能因为通信API已接通就默认可以查询所有订单。

工单系统提供相应接口且权限允许时，可以评估创建、查询和更新工单。需约定业务标识与幂等规则，避免重复请求产生重复工单。

提供呼叫控制接口且号码、线路与权限符合条件时，可以评估API发起呼叫。具体控制能力、字段和容量以实际平台接口文档和项目能力为准，不承诺所有线路均支持。

回调通常是在呼叫或任务事件发生后，由平台向企业系统通知状态与结果。事件、字段、接收规则与重试以实际平台接口文档和项目能力为准。

常见API调用由企业系统主动查询或操作，Webhook通常由平台在事件发生后通知接收方。Webhook也是接口集成的一部分，其事件与字段以实际平台接口文档和项目能力为准。

可能涉及API Key、Token、签名、IP白名单或权限控制，不是所有方式都必须同时使用。具体鉴权以实际平台接口文档和项目能力为准，凭证只在服务端安全保管。

按约定事件ID或业务唯一标识识别已处理事件，避免重复创建工单或任务。回调字段、幂等范围和接收规则以实际平台接口文档和项目能力为准，还需考虑状态顺序变化。

先区分可重试错误、权限或参数错误，并判断原操作是否已执行；超时不等于执行失败。次数、间隔、限流及幂等要求以实际平台接口文档和项目能力为准，不使用统一重试值。

需要按平台容量、接口限流、业务峰值及下游承载能力评估，并进行约定负载测试。并发、QPS和限流以实际平台接口文档和项目能力为准，不提供通用数字或SLA。

准备业务目标、接口信息、鉴权、回调、业务标识和异常策略六类信息。字段、权限、回调与容量要求以实际平台接口文档和项目能力为准。

接口返回200不代表业务接入完成，应验证鉴权、字段、回调、重试、幂等及CRM和工单的真实结果。按实际平台文档和项目范围执行正常、失败与恢复测试，并保留可追踪记录。