應用程式與擴充功能

在您的原生應用程式／擴充功能上設定 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 擴充功能不適用網域自動偵測。您需要改用 Public API Key 進行驗證，將小工具直接連結至您的 Chatgram 帳戶。

如何取得公開金鑰

在 Chatgram bot 中，打開底部的設定，然後點選 開發金鑰。
選擇你的網域。Chatgram 會傳送一則包含金鑰的訊息給你——請將訊息轉傳給開發人員，讓他們擷取公開金鑰（通常以 pk_ 開頭），並將其填入下方程式碼。

🔑publicKey 取代網域自動偵測

📱原生應用程式與擴充功能必備

🔒可安全公開——這是公開金鑰，不是密鑰

⚡相同的小工具、相同的功能、相同的 API

npm 上的完整文件

取代 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 時，Widget 會完全略過網域自動偵測。這是原生應用程式、Chrome 擴充功能、Electron 應用程式，以及任何沒有標準網域的環境所適用的做法。請參閱 npm 上的完整文件。

步驟 5：提交新版擴充功能

將你的建置版本發布至 Chrome 線上應用程式商店

使用 publicKey 設定好 Chatgram 小工具並在本機測試後，請打包正式版，並以新擴充功能的形式提交，或更新現有的商店頁面。商店審查會檢查擴充功能的 manifest、權限和隱私揭露，確認是否符合擴充功能的實際用途。

開啟 Chrome 線上應用程式商店開發人員資訊主頁，選擇 新增項目（首次發布），或為你已管理的擴充功能上傳新套件。
確保 manifest 權限符合 Chatgram 的使用需求（例如，只申請實際需要的主機權限或 API），如果你會收集使用者資料，也請確認隱私權政策網址正確無誤。
完成商店頁面資訊（說明、螢幕截圖、類別），然後提交審查。核准後，使用者就能安裝你的擴充功能，並透過先前設定的同一個 Chatgram 管道與你聯絡。

提示：上線後如需修正，請在同一個資訊主頁上傳新的 ZIP、更新 manifest.json 中的版本號，並在需要時再次提交審查。

運作方式

只需 4 個簡單步驟即可完成設定

網域驗證可確認你擁有要連結至 Chatgram 的網域。只需幾分鐘即可完成，無須具備技術專業知識。

步驟 01

登入 DNS 服務供應商

前往您管理網域記錄的網域註冊商或 DNS 服務供應商。可能是 Cloudflare、GoDaddy、Namecheap 或其他供應商。

步驟 02

前往 DNS 記錄

找到 DNS 管理區段。請尋找「DNS Records」、「DNS Settings」、「Zone Editor」或「Manage DNS」等選項。各家服務供應商的標示略有不同。

步驟 03

新增 TXT 記錄

請依照本頁「DNS 記錄」區段顯示的設定，新增 DNS 記錄。請確認記錄類型為 TXT，且值完全相符。

步驟 04

驗證並啟用

等待幾分鐘讓 DNS 記錄生效，接著在「驗證網域」區段輸入您的網域，然後點擊「立即檢查」以驗證並啟用 Chatgram。

DNS 服務供應商

新增記錄。
驗證。正式上線。

你的客戶正在等候。設定 DNS 記錄、驗證網域，並開始直接在 Telegram 接收支援訊息。

驗證我的網域了解 Chatgram

🔒業界標準驗證

⚡5 分鐘快速設定

💬以 Telegram 為核心的客戶支援

在您的原生應用程式／擴充功能上設定 Chatgram

將這筆TXT 記錄
新增至您的網域

檢查您的 DNS 記錄
並認領您的網站

下一步：查看電子郵件

使用 Public Key 整合

將你的建置版本發布至 Chrome 線上應用程式商店

只需 4 個簡單步驟即可完成設定

登入 DNS 服務供應商

前往 DNS 記錄

新增 TXT 記錄

驗證並啟用

熱門服務商的快速連結熱門服務商

常見問題

新增記錄。
驗證。正式上線。

在您的原生應用程式／擴充功能上設定 Chatgram

將這筆TXT 記錄新增至您的網域

檢查您的 DNS 記錄並認領您的網站

下一步：查看電子郵件

使用 Public Key 整合

將你的建置版本發布至 Chrome 線上應用程式商店

只需 4 個簡單步驟即可完成設定

登入 DNS 服務供應商

前往 DNS 記錄

新增 TXT 記錄

驗證並啟用

熱門服務商的快速連結熱門服務商

常見問題

新增記錄。驗證。 正式上線。

將這筆TXT 記錄
新增至您的網域

檢查您的 DNS 記錄
並認領您的網站

新增記錄。
驗證。正式上線。