Chatgram
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
& Claim Your Site

Enter your domain and email. We'll verify the TXT record on our side, then email you a single-use sign-in link for the Chatgram admin panel. No Telegram needed to get started.

🔒Server-verified
✉️Email delivery
⏱~ 60 seconds
Step 3: Check Your Email

Next: Check Your Email

Once Step 2 succeeds we will email you a single-use link that signs you in to the Chatgram admin panel as the owner of your site.

Awaiting Step 2
Step 3

Complete Step 2 to receive your sign-in email

Verify your domain first, then your sign-in link will be emailed 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
  1. In the Chatgram bot , open Settings at the bottom, then tap development keys.
  2. 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
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>
or
<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.
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.

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

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

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

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

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.

🔒Industry-Standard Verification
⚡5-Minute Setup
💬Telegram-Powered Support