Apps & Extensions

Shyira Chatgram ku rubuga rwawe 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.

~iminota 5

Igihe cyo kuyishyiraho

Ubuntu

Kugira ngo utangire

API Key

Auth Method

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

Public Key Authentication

Verify → Get Key → Integrate

Intambwe ya 1: Ongeraho inyandiko ya DNS

Ongeraho iyi nyandiko ya TXT
kuri domeni yawe

Jya mu igenamiterere rya DNS rya domeni yawe wongeremo inyandiko yeretswe hano. Iyi nyandiko ya TXT yemeza ko domeni ari iyawe, itagize icyo ihungabanya ku rubuga rwawe, imikorere ya email cyangwa imiterere ya DNS isanzweho.

🔒Nta cyo ihungabanya ku rubuga rwawe cyangwa ku itangwa rya email

⚡Ikwirakwira mu minota 1–10 kuri serivisi nyinshi

🌐Ikorana na serivisi iyo ari yo yose ya DNS ku isi

Inyandiko ya DNS isabwa

Inyandiko ya TXT

Ubwoko

TXT

Izina / Host

_chatgram-verify

Agaciro / Ibirimo

chatgram-site-verification=true

TTL

300 (cyangwa Automatic)

💡

Urugero: Niba indangarubuga yawe ari mysite.com, izina ryuzuye ry’inyandiko riba _chatgram-verify.mysite.com. Abatanga serivisi bamwe bahita bongera indangarubuga — niba ari ko bimeze, andikamo gusa _chatgram-verify.

Intambwe ya 2: Emeza indangarubuga

Reba Inyandiko ya DNS
maze wiyemeze ko urubuga ari rwawe

Andika indangarubuga yawe na imeri yawe. Tuzagenzura inyandiko ya TXT ku ruhande rwacu, hanyuma tukohereze imeri irimo umurongo wo kwinjira ukoreshwa rimwe gusa mu rwego rw’ubuyobozi rwa Chatgram. Nta Telegram ikenewe kugira ngo utangire.

🔒Yagenzuwe na seriveri

✉️Kohereza imeri

⏱Amasegonda ~ 60

Indangarubuga yawe *

Imeli yawe *

Intambwe ya 3: Reba imeli yawe

Ibikurikira: Reba imeli yawe

Intambwe ya 2 nirangira neza, tuzakoherereza imeri irimo umurongo ukoreshwa rimwe gusa, winjire mu rwego rw’ubuyobozi rwa Chatgram nka nyir’urubuga rwawe.

Hategerejwe intambwe ya 2

Intambwe ya 3

Rangiza intambwe ya 2 kugira ngo wakire imeri yo kwinjiramo

Banza wemeze indangarubuga yawe, hanyuma umurongo wo kwinjiramo woherezwe kuri iyi aderesi ya imeri.

Intambwe ya 4: Iby’abakora porogaramu

Integrate with Public Key

For native apps na 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

Shyiramo ukoresheje CDN

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

cyangwa

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

Uko Ikora

Igenamiterere mu Ntambwe 4 Zoroheje

Kwemeza domeni bigaragaza ko ari wowe uyitunze kandi ko ushaka kuyihuza na Chatgram. Bifata iminota mike gusa kandi ntibisaba ubumenyi bwihariye mu bya tekiniki.

Intambwe 01

Injira muri Konti y’Ucunga DNS

Jya ku kigo wandikishijemo domeni yawe cyangwa ku mucungamutungo wa DNS, aho ucunga inyandiko za domeni yawe. Urugero ni Cloudflare, GoDaddy, Namecheap cyangwa undi mucungamutungo uwo ari we wese.

Intambwe 02

Jya ku Nyandiko za DNS

Shaka igice cyo gucunga DNS. Reba amahitamo nka "DNS Records," "DNS Settings," "Zone Editor" cyangwa "Manage DNS." Amazina ahinduka gato bitewe n’umucungamutungo.

Intambwe 03

Ongeraho Inyandiko Nshya ya TXT

Kora inyandiko nshya ya DNS ukoresheje igenamiterere nyaryo ryerekanwe mu gice cy’Inyandiko ya DNS kuri uru rupapuro. Reba neza ko ubwoko bw’inyandiko ari TXT kandi ko indangagaciro zihuye neza n’izerekanwe.

Intambwe 04

Emeza kandi Ukoreshe

Tegereza iminota mike kugira ngo DNS ikwirakwire, hanyuma wandike domeni yawe mu gice cyo Kwemeza Domeni maze ukande "Check Now" kugira ngo wemeze kandi ukoreshe Chatgram.

Abacungamutungo ba DNS

Amahuza yihuse Ajya ku bacungamutungo bamenyerewe

Jya ako kanya ku kibaho cy’umucungamutungo wa DNS ukoresha, wongereho inyandiko yo kwemeza ya Chatgram. Niba atari hano, uburyo bwo kubikora ni bumwe ku bacungamutungo bose.

Cloudflare

DNS → Hitamo domeni → Ongeraho Inyandiko

GoDaddy

Ibicuruzwa byanjye → DNS → Ongeraho inyandiko

Namecheap

Urutonde rwa za domain → Genzura → DNS igezweho

Google Domains

Za domain zanjye → DNS → Inyandiko zihariye

AWS Route 53

Hosted Zones → Hitamo → Kora inyandiko

DigitalOcean

Imiyoboro → Za domain → Ongeraho inyandiko

Ibibazo bikunze kubazwa

Ibyo ukeneye kumenya byose ku bijyanye no kugenzura DNS no kwandikisha domain kuri Chatgram.

Uracyafite ibibazo? Twandikire ukoresheje Ikiganiro kizima cya Chatgram cyangwa utwoherereze imeri kuri [email protected]

Abenshi mu batanga serivisi za DNS bakwirakwiza inyandiko za TXT mu minota 1–10. Mu bihe bidasanzwe, bishobora gufata amasaha agera kuri 48 bitewe n’utanga serivisi za DNS n’imiterere ya TTL. Cloudflare ikunze kubikwirakwiza mu gihe kitageze ku minota 2.

Oya. Inyandiko za TXT ni amakuru y’inyongera gusa abikwa muri DNS zone yawe. Kongera inyandiko ya Chatgram yo kugenzura nta ngaruka na gato bigira ku rubuga rwawe, ku itangwa rya imeri cyangwa ku zindi nyandiko za DNS usanzwe ufite.

Turagusaba kugumana inyandiko ya TXT. Chatgram ihora igenzura nyir’ubwite bwa domain kugira ngo umutekano ube wizewe. Iyo iyo nyandiko ikuweho, domain yawe ishobora kongera kugaragara nk’itaragenzuwe nyuma y’isuzuma rikurikiraho.

Chatgram yemera subdomain. Niba ushaka kugenzura support.mysite.com, ongeraho inyandiko ya TXT kuri _chatgram-verify.support.mysite.com. Andika "support.mysite.com" mu mwanya wo kugenzura.

Banza ugenzure neza ko izina ry’inyandiko ari _chatgram-verify (bamwe mu batanga serivisi bahita bongera domain yawe, bityo ushobora gukenera kwandika _chatgram-verify gusa). Reba ko agaciro kayo ari chatgram-site-verification=true neza, nta myanya y’inyongera. Niba byose bisa n’ibyanditse neza, tegereza indi minota mike kugira ngo bikwirakwize, hanyuma wongere ugerageze.

Yego. Kugenzura ukoresheje DNS TXT ni uburyo busanzwe mu nganda bukoreshwa na Google, Microsoft, Stripe n’izindi mbuga zikomeye kugira ngo hemezwe nyir’ubwite bwa domain. Dusuzuma inyandiko za DNS zigaragara ku mugaragaro — nta makuru y’ibanga yinjizwa.

Yego rwose. Subiramo ubu buryo kuri buri domain ushaka guhuza na Chatgram. Buri domain igomba kugira inyandiko yayo ya TXT ya _chatgram-verify. Dashboard ya Chatgram izacunga domain zose zagenzuwe ahantu hamwe.

Witeguye gutangira?

Ongeraho inyandiko.
Genzura. Tangira gukora.

Abakiriya bawe baragutegereje. Shyiraho inyandiko ya DNS, genzura domain yawe, maze utangire kwakira ubutumwa bwo gusaba ubufasha kuri Telegram.

Genzura domain yanjye Menya ibya Chatgram

🔒Igenzura ryizewe rikoreshwa mu rwego rw’inganda

⚡Kwinjiza mu minota 5

💬Ubufasha bukoresha Telegram