技能介绍

你在对接什么

企业把合同签进 OA、CRM 或 SaaS 平台时，腾讯电子签（Tencent eSign）的 API 往往卡在环境混用、Endpoint 选错、签名参数不对，或回调收不到。本技能面向客户侧 IT / 集成开发，把官方文档里的接入路径整理成可检索的知识，并在回答里必须附上官方原文链接，方便你们内审和对照控制台配置。

技能如何帮你排障与接入

双集成模式：区分自建应用（企业自用、对接内部系统）与第三方应用（平台给子客提供电子签），各自控制台、通用/文件 Endpoint、SecretId/SecretKey 来源不同；上线时需完成密钥更换、回调地址、请求域名「三件套」。
参数与接口地图：AppId、操作人 Operator.UserId、第三方 ProxyOrganizationOpenId / ProxyOperator.OpenId、FlowId、TemplateId 等从哪取、干什么用；API 按模板与文件、创建/查询/控制签署流程、可嵌入页面、印章与证书、组织员工等 20+ 类索引，细节可对照技能内 references/api_reference.md。
流程与回调：文件发起、模板发起等签署主路径；回调需公网可达且返回 HTTP 200，可配加密 Key 与签名 Token；收不到回调时按文档做连通性排查。
多模态排障：支持根据截图、录屏、错误页、F12 控制台、接口 JSON 返回识别错误码与配置问题，再结合上述知识给出原因与文档链接；涉及密钥等敏感信息会提醒打码。

边界与注意

商务类问题（价格、采购、套餐、开白名单等）技能不代答，应走渠道商务对接。
文件上传等须走文件 Endpoint（如 file.ess.tencent.cn / 测试域），与通用 API 域名混用会触发 action not exist 等典型报错。
专业版以下部分子企业不能单独配回调，需走主企业回调策略。