Chatgram
应用与扩展

在你的原生应用 / 扩展程序中设置 Chatgram

将 Chatgram 集成到您的移动应用、桌面应用或 Chrome 扩展程序中。验证您的域名，获取 Public API Key，几分钟内即可通过 Telegram 接收客服消息。

~5 分钟
设置时间
免费
开始
API 密钥
身份验证方式
> ChatgramWidget.init({)
publicKey：'pk_abc123...',
主题：{ primaryColor: '#EE6055' }
});
✓ 已使用 API 密钥初始化聊天组件
公开密钥认证
验证 → 获取密钥 → 集成
步骤 1：添加 DNS 记录

将此TXT 记录
添加到您的域名

前往您域名的 DNS 设置，添加此处显示的记录。此 TXT 记录可验证域名所有权，不会影响您的网站、电子邮件或任何现有 DNS 配置。

🔒不会影响你的网站或邮件送达
⚡大多数服务商会在 1–10 分钟内完成传播
🌐支持全球任何 DNS 服务商
必填 DNS 记录
TXT 记录
类型
TXT
名称 / 主机
_chatgram-verify
值 / 内容
chatgram-site-verification=true
TTL
300（或自动）
💡
例如：如果你的域名是 mysite.com，完整的记录主机名就是 _chatgram-verify.mysite.com。部分服务商会自动追加域名——如果是这样，只需输入 _chatgram-verify。
步骤 2：验证域名

检查您的 DNS 记录
并认领您的网站

输入您的域名和邮箱。我们会在后台验证 TXT 记录，然后向您发送一个一次性登录链接，用于登录 Chatgram 管理面板。无需 Telegram 即可开始使用。

🔒服务器验证
✉️邮件送达
⏱~ 60 秒
步骤 3：检查您的邮箱

下一步：查看邮箱

第 2 步成功后，我们会通过邮件发送一个一次性链接，让您以网站所有者身份登录 Chatgram 管理面板。

等待第 2 步
步骤 3

完成第 2 步以接收登录邮件

请先验证你的域名，之后登录链接会发送到此邮箱。

步骤 4：面向开发者

使用 Public Key 集成

对于原生应用和 Chrome 扩展程序，域名自动检测不适用。你需要使用公共 API 密钥进行身份验证，将小组件直接关联到你的 Chatgram 账号。

如何获取公钥
  1. 在 Chatgram 机器人中，打开底部的设置，然后点按开发密钥。
  2. 选择你的域名。Chatgram 会向你发送一条包含密钥的消息——将它转发给开发人员，让他们提取公钥（通常以 pk_ 开头），并将其填入下方代码。
🔑publicKey 会取代域名自动检测
📱原生应用和扩展必需
🔒可放心公开——这是公钥，不是密钥
⚡相同的小组件、相同的功能、相同的 API
替换 pk_YOUR_PUBLIC_KEY 使用 Telegram 控制面板中的密钥
通过 CDN 引入
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
或
<script src="https://unpkg.com/chatgram-widget"></script>
使用公钥的 Vanilla JS
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
<script>
  window.addEventListener('load', function () {
    ChatgramWidget.init({
      publicKey: 'pk_YOUR_PUBLIC_KEY',
      showTriggerButton: true,
      triggerPosition: 'bottom-right',
      theme: {
        primaryColor: '#EE6055',
        secondaryColor: '#D94F44',
      },
    });
  });
</script>
💡
提供 publicKey 时，聊天组件会完全跳过域名自动检测。这适用于原生应用、Chrome 扩展、Electron 应用，以及任何没有标准 Web 域名的环境。完整文档见 npm。
步骤 5：提交新扩展程序

将你的构建发布到 Chrome 网上应用店

当您的 Chatgram 聊天组件接入了 publicKey 并在本地测试后，打包生产版本并提交为 新扩展 也可以作为现有条目的更新提交。商店审核会检查清单、权限和隐私披露是否与扩展程序的实际功能相符。

  • 打开 Chrome 网上应用店开发者信息中心 并选择 新项目 （首次发布）或为你已管理的扩展程序上传新软件包。
  • 对齐你的 manifest 权限 结合 Chatgram 的使用场景（例如，仅启用真正需要的主机权限或 API），并确保您的 隐私政策 如果您收集用户数据，请确保 URL 准确无误。
  • 完善商品信息（描述、截图、类别），然后 提交审核。审核通过后，用户即可安装你的扩展程序，并通过你之前配置的同一 Chatgram 渠道与你交流。

提示： 上线后的修复仍可在同一个控制面板中完成——上传新的 ZIP，并在其中更新版本号 manifest.json, 并在需要时再次提交审核。

工作原理

4 个简单步骤即可完成设置

域名验证可证明你拥有要连接到 Chatgram 的域名。只需几分钟，无需任何技术知识。

01
步骤 01

登录 DNS 服务商

前往管理域名记录的域名注册商或 DNS 服务商。这可能是 Cloudflare、GoDaddy、Namecheap 或其他服务商。

02
步骤 02

前往 DNS 记录

找到 DNS 管理部分。查找“DNS 记录”“DNS 设置”“区域编辑器”或“管理 DNS”等选项。不同服务商的标注可能略有不同。

03
步骤 03

添加新的 TXT 记录

请按照本页面“DNS 记录”部分所示的准确设置创建一条新的 DNS 记录。确保记录类型为 TXT，且值完全一致。

04
步骤 04

验证并激活

等待几分钟，让 DNS 记录生效，然后在“验证域名”部分输入您的域名并点击“立即检查”，以验证并激活 Chatgram。

DNS 服务商

快速链接，直达热门服务商

直接前往 DNS 服务商的控制面板，添加 Chatgram 验证记录。这里没有列出你的服务商？其他服务商的操作流程也相同。

Cloudflare
DNS → 选择域名 → 添加记录
GoDaddy
我的产品 → DNS → 添加记录
Namecheap
域名列表 → 管理 → 高级 DNS
Google Domains
我的域名 → DNS → 自定义记录
AWS Route 53
托管区域 → 选择 → 创建记录
DigitalOcean
网络 → 域名 → 添加记录
常见问题

常见问题

了解有关 Chatgram DNS 验证和域名注册的所有信息。

还有疑问？请通过 Chatgram Live Chat 联系我们，或发送邮件至 [email protected]

大多数 DNS 服务商会在 1–10 分钟内完成 TXT 记录的传播。少数情况下，根据 DNS 服务商和 TTL 设置，最长可能需要 48 小时。Cloudflare 通常不到 2 分钟即可完成传播。

不会。TXT 记录只是 DNS 区域中的元数据条目。添加 Chatgram 验证记录绝不会影响你的网站、邮件投递或当前的其他 DNS 记录。

建议保留 TXT 记录。Chatgram 会定期重新验证域名所有权，以确保安全。如果删除该记录，您的域名可能会在下一个检查周期后变为未验证状态。

Chatgram 支持子域名。如果你要验证 support.mysite.com，请将 TXT 记录添加为 _chatgram-verify.support.mysite.com。在验证字段中输入 "support.mysite.com"。

首先，再次确认记录名称准确无误地写为 _chatgram-verify（有些服务商会自动附加你的域名，因此你可能只需输入 _chatgram-verify）。确认值准确无误地写为 chatgram-site-verification=true，且前后没有多余空格。如果一切看起来都正确，请再等几分钟，让 DNS 记录完成传播，然后重试。

可以。DNS TXT 验证是 Google、Microsoft、Stripe 等主要平台用于证明域名所有权的行业标准方法。我们会查询公开的 DNS 记录，不涉及任何敏感凭据。

当然可以。对每个要连接到 Chatgram 的域名重复此流程即可。每个域名都需要有自己的 _chatgram-verify TXT 记录。您可以在 Chatgram 控制面板中统一管理所有已验证的域名。

准备好开始了吗？

添加记录。
验证。 上线。

你的客户正在等待。设置 DNS 记录并验证域名，即可开始直接在 Telegram 中接收客服消息。

🔒符合行业标准的验证
⚡5 分钟即可完成设置
💬由 Telegram 驱动的支持服务