Apps & Extensions

Setup Chatgram On Your Native App / Extension

Integrate Chatgram into your mobile app, desktop app, or Chrome extension. Verify your domain, get your Public API Key, and start receiving support messages via Telegram in minutes.

~5 min

Setup Time

Free

To Start

API Key

Auth Method

> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
theme: { primaryColor: '#EE6055' }
});
✓ Widget initialized with API key

Public Key Authentication

Verify → Get Key → Integrate

Step 1: Add DNS Record

Add This TXT Record
to Your Domain

Head to your domain's DNS settings and add the record shown here. This TXT record proves domain ownership without affecting your website, email, or any existing DNS configuration.

🔒Does not affect your website or email delivery

⚡Propagates in 1–10 minutes on most providers

🌐Works with any DNS provider worldwide

Required DNS Record

TXT Record

Type

TXT

Name / Host

_chatgram-verify

Value / Content

chatgram-site-verification=true

TTL

300 (or Auto)

💡

Example: If your domain is mysite.com, the full record hostname becomes _chatgram-verify.mysite.com. Some providers auto-append the domain — if so, just enter _chatgram-verify.

Step 2: Verify Domain

Check Your DNS Record
& Activate Chatgram

Enter your domain and email, and we'll check if the TXT record is set up correctly. Once verified, your domain will be registered and you'll receive a unique activation link.

⏱Instant check

🔐Secure lookup

Your Domain *

Your Email *

Step 3: Telegram Dashboard

Set Up Your Telegram Dashboard

This is your Telegram Channel as your dashboard. Connect it to start receiving customer messages directly in Telegram.

Don't have Telegram? Install Telegram mobile or desktop here.

Telegram Dashboard

Step 3

Complete Step 2 to get your Dashboard link

Verify your domain first, then your unique Telegram link will appear here.

Step 4: For Developers

Integrate with Public Key

For native apps and Chrome extensions, domain auto-detection doesn't apply. Instead, you authenticate using a Public API Key that links the widget directly to your Chatgram account.

How to Get Your Public Key

In the Chatgram bot , open Settings at the bottom, then tap development keys.
Select your domain. Chatgram will send you a message with your keys — forward it to your developer so they can extract the public key (often starts with pk_) and plug it into the code below.

🔑publicKey replaces domain auto-detection

📱Required for native apps & extensions

🔒Safe to expose — it's a public key, not a secret

⚡Same widget, same features, same API

Full Docs on npm

Replace pk_YOUR_PUBLIC_KEY with the key from your Telegram Dashboard

Include via CDN

<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>

<script src="https://unpkg.com/chatgram-widget"></script>

Vanilla JS with Public Key

<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>

💡

When publicKey is provided, the widget skips domain auto-detection entirely. This is the correct approach for native apps, Chrome extensions, Electron apps, and any environment without a standard web domain. Full docs on npm.

Step 5: Submit NEW Extension

Publish your build to the Chrome Web Store

When your Chatgram widget is wired up with publicKey and tested locally, package a production build and submit it as a new extension or as an update to an existing listing. The store review checks your manifest, permissions, and privacy disclosures against what your extension actually does.

Open the Chrome Web Store Developer Dashboard and choose New Item (first publication) or upload a new package for an extension you already manage.
Align your manifest permissions with Chatgram usage (for example, only host permissions or APIs you truly need) and keep your privacy policy URL accurate if you collect user data.
Complete the listing (description, screenshots, category), then submit for review. After approval, users can install your extension and talk to you through the same Chatgram channel you configured earlier.

Tip: Fixes after launch use the same dashboard — upload a new ZIP, bump the version in manifest.json, and submit again for review when required.

How It Works

Set Up in 4 Simple Steps

Domain verification proves you own the domain you want to connect to Chatgram. It takes just a few minutes and requires no technical expertise.

Step 01

Log Into Your DNS Provider

Go to your domain registrar or DNS provider where you manage your domain records. This could be Cloudflare, GoDaddy, Namecheap, or any other provider.

Step 02

Navigate to DNS Records

Find the DNS management section. Look for options like "DNS Records," "DNS Settings," "Zone Editor," or "Manage DNS." Each provider labels it slightly differently.

Step 03

Add a New TXT Record

Create a new DNS record with the exact settings shown in the DNS Record section on this page. Make sure the record type is TXT and the values match precisely.

Step 04

Verify & Activate

Wait a few minutes for DNS propagation, then enter your domain in the Verify Domain section and click "Check Now" to verify and activate Chatgram.

DNS Providers

Quick Links to Popular Providers

Jump straight to your DNS provider's dashboard and add the Chatgram verification record. Not listed here? The process is the same on any provider.

Cloudflare

DNS → Select domain → Add Record

GoDaddy

My Products → DNS → Add Record

Namecheap

Domain List → Manage → Advanced DNS

Google Domains

My Domains → DNS → Custom Records

AWS Route 53

Hosted Zones → Select → Create Record

DigitalOcean

Networking → Domains → Add Record

FAQ

Common Questions

Everything you need to know about DNS verification and domain registration for Chatgram.

Still have questions? Reach out via Chatgram Live Chat or email us at [email protected]

Most DNS providers propagate TXT records within 1–10 minutes. In rare cases, it can take up to 48 hours depending on your DNS provider and TTL settings. Cloudflare typically propagates in under 2 minutes.

No. TXT records are metadata-only entries in your DNS zone. Adding the Chatgram verification record has absolutely no impact on your website, email delivery, or any other DNS records you currently have.

We recommend keeping the TXT record in place. Chatgram periodically re-verifies domain ownership to ensure security. If the record is removed, your domain may become unverified after the next check cycle.

Chatgram supports subdomains. If you want to verify support.mysite.com, add the TXT record as _chatgram-verify.support.mysite.com. Enter "support.mysite.com" in the verification field.

First, double-check that the record name is exactly _chatgram-verify (some providers auto-append your domain, so you may only need to type _chatgram-verify). Verify the value is exactly chatgram-site-verification=true with no extra spaces. If everything looks correct, wait a few more minutes for propagation and try again.

Yes. DNS TXT verification is the industry-standard method used by Google, Microsoft, Stripe, and other major platforms to prove domain ownership. We query public DNS records — no sensitive credentials are involved.

Absolutely. Repeat the process for each domain you want to connect to Chatgram. Each domain needs its own _chatgram-verify TXT record. Your Chatgram dashboard will manage all verified domains in one place.

Ready to Get Started?

Add the Record.
Verify. Go Live.

Your customers are waiting. Set up your DNS record, verify your domain, and start receiving support messages directly in Telegram.

Verify My Domain Learn About Chatgram

🔒Industry-Standard Verification

⚡5-Minute Setup

💬Telegram-Powered Support