企业官网建设流程全解析

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 字段填错通常源于以下几类情况：

1. 复制了完整浏览器地址：直接从地址栏复制https://yourcompany.kommo.com粘贴到字段中，带了协议前缀和域名后缀。
2. 混淆了邮箱域名与账户域名：有些用户会把自己的企业邮箱域名（如@yourcompany.com）填进去，但邮箱域名与 Kommo 账户子域名完全是两回事。
3. 填入了带点号的业务标识：部分公司内部习惯用带点号的名字（如na.yourcompany）区分区域，这类值同样不符合要求。

判断标准只有一条：取账户 URL 中紧邻.kommo.com之前的字符串，且该字符串中不能出现点号。例如：

如果拿不准，请先登录 Kommo 后台，从浏览器地址栏确认账户的准确 URL，再按上述规则提取子域名。

连接失败后的恢复步骤

如果因为填错了子域名而产生了失败的连接记录，请按以下步骤恢复：

1. 删除已有的失败连接：在 Composio 的「连接（Connected Accounts / Connections）」列表中，找到 Kommo 对应的失败连接并删除。不要试图在旧连接上直接修改字段——OAuth2 授权状态已经与错误的子域名绑定，直接修改可能继续复用失效的授权上下文。
2. 重新发起连接：重新发起 Kommo 的 OAuth2 连接流程，进入认证配置界面。
3. 填入修正后的子域名：在 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:evergreen，topics 含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