Composio 中 Kommo 连接的 Subdomain 字段填写指南：只填账户子域名，不填完整 URL

Composio 中 Kommo 连接的 Subdomain 字段填写指南只填账户子域名不填完整 URL【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本指南面向在 Composio 平台上通过 OAuth2 方式接入 Kommo CRM 的开发者与运维人员核心解决一个高频认证失败问题连接配置中Subdomain 字段只应填写账户 URL 中.kommo.com之前的部分。读完本文你将掌握正确的子域名提取规则、常见的错误填法以及连接失败后的恢复步骤并了解该规则在仓库中的出处与相关验证信息。Kommo 工具包与 OAuth2 认证概览Kommo原名 amoCRM是一个用于管理客户关系、销售管道和业务流程的 CRM 平台。在 Composio 中Kommo 以标准工具包toolkit的形式提供其注册信息可以在 docs/public/data/toolkits.json 中查到搜索slug: kommo对应的条目名称Kommo分类crm认证方式OAUTH2工具数量53 个如KOMMO_CREATE_LEAD、KOMMO_CREATE_CONTACT、KOMMO_CREATE_COMPANY、KOMMO_GET_ACCOUNT、KOMMO_LIST_CONVERSATIONS等触发器数量0由于 Kommo 走的是 OAuth2 认证流程连接的建立需要你或你的 Agent在 Composio 的认证配置中提供账户级别的标识信息其中就包括本指南要讨论的Subdomain子域名字段。该字段填写错误是 Kommo 连接建立失败的最常见原因之一也是本知识库条目被归类为「authentication / errors-and-troubleshooting」主题的原因参见 docs/content/kb/guide/toolkits-kommo.mdx 的 frontmatter 元数据。核心规则Subdomain 字段只填.kommo.com之前的部分根据知识库原文docs/kb/articles/toolkits-kommo.md规则非常简单明确Subdomain字段应只包含账户 URL 中.kommo.com之前的那一部分。以账户地址https://yourcompany.kommo.com为例你需要在 Subdomain 字段中填写yourcompany也就是说不要填写以下内容❌ 完整的账户 URL如https://yourcompany.kommo.com❌ 邮箱域名如yourcompany.com❌ 任何包含.com或点号.的值如yourcompany.kommo.com、my.company正确填写后Composio 会在 OAuth2 流程中结合该子域名与 Kommo 进行账户级别的 API 通信。子域名是 Kommo 多租户架构下区分不同企业账户的唯一标识填错或填成邮箱域名都会导致认证请求指向错误的账户最终连接失败。常见错误与原因分析从实际排障经验看Subdomain 字段填错通常源于以下几类情况复制了完整浏览器地址直接从地址栏复制https://yourcompany.kommo.com粘贴到字段中带了协议前缀和域名后缀。混淆了邮箱域名与账户域名有些用户会把自己的企业邮箱域名如yourcompany.com填进去但邮箱域名与 Kommo 账户子域名完全是两回事。填入了带点号的业务标识部分公司内部习惯用带点号的名字如na.yourcompany区分区域这类值同样不符合要求。判断标准只有一条取账户 URL 中紧邻.kommo.com之前的字符串且该字符串中不能出现点号。例如账户 URL正确的 Subdomain 值https://yourcompany.kommo.comyourcompanyhttps://acme-crm.kommo.comacme-crmhttps://demo.kommo.comdemo如果拿不准请先登录 Kommo 后台从浏览器地址栏确认账户的准确 URL再按上述规则提取子域名。连接失败后的恢复步骤如果因为填错了子域名而产生了失败的连接记录请按以下步骤恢复删除已有的失败连接在 Composio 的「连接Connected Accounts / Connections」列表中找到 Kommo 对应的失败连接并删除。不要试图在旧连接上直接修改字段——OAuth2 授权状态已经与错误的子域名绑定直接修改可能继续复用失效的授权上下文。重新发起连接重新发起 Kommo 的 OAuth2 连接流程进入认证配置界面。填入修正后的子域名在 Subdomain 字段中严格按上文规则只填.kommo.com之前的部分如yourcompany然后完成授权。这条「先删除、再重连、再填正确值」的流程同样记录在知识库原文中见 docs/kb/articles/toolkits-kommo.md 与对应源文件 docs/kb/source/toolkits/kommo/public.md是官方给出的标准恢复方式。相关资源与仓库出处本指南内容在仓库中对应以下文件供进一步排查与溯源知识库文章docs/kb/articles/toolkits-kommo.md —— 本文的主体来源类型为 troubleshooting 排障文档。知识库源文件docs/kb/source/toolkits/kommo/public.md —— 标记为type: troubleshooting、category: authentication标签包含kommo、oauth、subdomain。站点指南版本docs/content/kb/guide/toolkits-kommo.mdx —— 带站点元数据freshness:evergreentopics 含authentication、errors-and-troubleshooting、toolkits-and-providers的同一内容。工具包注册数据docs/public/data/toolkits.json —— Kommo 工具包的认证方案OAUTH2、分类crm与 53 个工具的完整清单。此外subdomain作为「连接级字段」connection-level field在 Composio 的认证体系中是常见模式——例如 Salesforce 的「My Domain」同样要求填写.salesforce.com之前的部分参见 docs/public/data/toolkits.json 中 Salesforce 相关条目的字段描述。理解这一模式有助于你在接入其他基于子域名区分租户的工具包时举一反三快速定位同类认证问题。小结Kommo 连接的 Subdomain 字段只填账户 URL 中.kommo.com之前的字符串不带协议、不带.com、不带点号若已有失败连接先删除再重连并填入修正值即可完成 OAuth2 认证。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考