Chatgram
Aplicacions i extensions

Configura Chatgram a la teva aplicació nativa / extensió

Integra Chatgram a la teva aplicació mòbil, aplicació d’escriptori o extensió de Chrome. Verifica el teu domini, obtén la clau d’API pública i comença a rebre missatges d’assistència via Telegram en qüestió de minuts.

~5 min
Temps de configuració
Gratis
Per començar
Clau d’API
Mètode d’autenticació
> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
theme: { primaryColor: '#EE6055' }
});
✓ Giny inicialitzat amb la clau d’API
Autenticació amb clau pública
Verifica → Obtén la clau → Integra
Pas 1: Afegeix un registre DNS

Afegeix aquest registre TXT
al teu domini

Ves a la configuració DNS del teu domini i afegeix-hi el registre que es mostra aquí. Aquest registre TXT demostra que ets el propietari del domini sense afectar el teu lloc web, el correu electrònic ni cap configuració DNS existent.

🔒No afecta el teu lloc web ni l’entrega del correu electrònic
⚡La propagació triga entre 1 i 10 minuts amb la majoria de proveïdors
🌐Compatible amb qualsevol proveïdor de DNS del món
Registre DNS obligatori
Registre TXT
Tipus
TXT
Nom / amfitrió
_chatgram-verify
Valor / contingut
chatgram-site-verification=true
TTL
300 (o automàtic)
💡
Exemple: Si el teu domini és mysite.com, el nom d'amfitrió complet del registre serà _chatgram-verify.mysite.com. Alguns proveïdors afegeixen el domini automàticament; en aquest cas, introdueix només _chatgram-verify.
Pas 2: Verifica el domini

Comprova el teu registre DNS
i reclama el teu lloc web

Introdueix el teu domini i correu electrònic. Verificarem el registre TXT i després t’enviarem un enllaç d’inici de sessió d’un sol ús per al tauler d’administració de Chatgram. No cal tenir Telegram per començar.

🔒Verificat al servidor
✉️Enviament per correu electrònic
⏱~ 60 segons
Pas 3: Consulta el teu correu electrònic

Següent: consulta el teu correu electrònic

Quan es completi correctament el pas 2, t’enviarem per correu electrònic un enllaç d’un sol ús per iniciar sessió al tauler d’administració de Chatgram com a propietari del teu lloc web.

A l’espera del pas 2
Pas 3

Completa el pas 2 per rebre el correu electrònic amb l’enllaç d’inici de sessió

Verifica primer el teu domini i t’enviarem aquí l’enllaç d’inici de sessió.

Pas 4: Per a desenvolupadors

Integra amb la clau pública

Per a aplicacions natives i extensions de Chrome, no s'aplica la detecció automàtica del domini. En lloc d'això, t'autentiques amb una clau d'API pública que vincula el widget directament al teu compte de Chatgram.

Com obtenir la clau pública
  1. Al bot de Chatgram , obre Configuració a la part inferior i toca claus de desenvolupament.
  2. Selecciona el teu domini. Chatgram t'enviarà un missatge amb les claus: reenvia'l al desenvolupador perquè n'extregui la clau pública (sovint comença per pk_) i l'afegeixi al codi següent.
🔑publicKey substitueix la detecció automàtica del domini
📱Necessària per a aplicacions natives i extensions
🔒És segur fer-la pública: és una clau pública, no un secret
⚡El mateix widget, les mateixes funcions i la mateixa API
Substitueix pk_YOUR_PUBLIC_KEY per la clau del teu tauler de control de Telegram
Inclou-la mitjançant CDN
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
o
<script src="https://unpkg.com/chatgram-widget"></script>
JavaScript pur amb clau pública
<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>
💡
Quan es proporciona publicKey, el widget omet completament la detecció automàtica del domini. Aquesta és la manera correcta de fer-ho per a aplicacions natives, extensions de Chrome, aplicacions d’Electron i qualsevol entorn sense un domini web estàndard. Consulta la documentació completa a 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.

Com funciona

Configura-ho en 4 senzills passos

La verificació del domini demostra que ets el propietari del domini que vols connectar a Chatgram. Només triga uns minuts i no cal tenir coneixements tècnics.

01
Pas 01

Inicia sessió al teu proveïdor de DNS

Ves al registrador del teu domini o al proveïdor de DNS on gestiones els registres del domini. Pot ser Cloudflare, GoDaddy, Namecheap o qualsevol altre proveïdor.

02
Pas 02

Ves als registres DNS

Busca la secció de gestió de DNS. Cerca opcions com ara «Registres DNS», «Configuració DNS», «Editor de zones» o «Gestiona el DNS». Cada proveïdor ho anomena d’una manera lleugerament diferent.

03
Pas 03

Afegeix un registre TXT nou

Crea un registre DNS nou amb la configuració exacta que es mostra a la secció Registre DNS d’aquesta pàgina. Assegura’t que el tipus de registre sigui TXT i que els valors coincideixin exactament.

04
Pas 04

Verifica i activa

Espera uns minuts perquè es propaguin els canvis de DNS i, tot seguit, introdueix el teu domini a la secció Verifica el domini i fes clic a «Comprova ara» per verificar-lo i activar Chatgram.

Proveïdors de DNS

Enllaços ràpids als proveïdors populars

Ves directament al tauler del teu proveïdor de DNS i afegeix-hi el registre de verificació de Chatgram. No el trobes a la llista? El procés és el mateix amb qualsevol proveïdor.

Cloudflare
DNS → Selecciona el domini → Afegeix un registre
GoDaddy
Els meus productes → DNS → Afegeix un registre
Namecheap
Llista de dominis → Gestiona → DNS avançat
Google Domains
Els meus dominis → DNS → Registres personalitzats
AWS Route 53
Zones allotjades → Selecciona → Crea un registre
DigitalOcean
Xarxes → Dominis → Afegeix un registre
Preguntes freqüents

Preguntes freqüents

Tot el que necessites saber sobre la verificació DNS i el registre de dominis per a Chatgram.

Encara tens preguntes? Contacta amb nosaltres a través del xat en directe de Chatgram o escriu-nos a [email protected]

La majoria de proveïdors de DNS propaguen els registres TXT en un període d’1 a 10 minuts. En casos poc habituals, pot trigar fins a 48 hores, segons el proveïdor de DNS i la configuració del TTL. Cloudflare normalment ho propaga en menys de 2 minuts.

No. Els registres TXT són entrades de metadades a la zona DNS. Afegir el registre de verificació de Chatgram no afecta en absolut el lloc web, l’entrega del correu electrònic ni cap altre registre DNS que ja tinguis.

Et recomanem que mantinguis el registre TXT. Chatgram torna a verificar periòdicament la propietat del domini per garantir-ne la seguretat. Si elimines el registre, és possible que el domini deixi d’estar verificat després del següent cicle de comprovació.

Chatgram és compatible amb els subdominis. Si vols verificar support.mysite.com, afegeix el registre TXT com a _chatgram-verify.support.mysite.com. Introdueix «support.mysite.com» al camp de verificació.

Primer, comprova que el nom del registre sigui exactament _chatgram-verify (alguns proveïdors hi afegeixen el domini automàticament, de manera que potser només cal que escriguis _chatgram-verify). Comprova que el valor sigui exactament chatgram-site-verification=true, sense espais addicionals. Si tot sembla correcte, espera uns minuts més perquè es propagui i torna-ho a provar.

Sí. La verificació DNS TXT és el mètode estàndard del sector que fan servir Google, Microsoft, Stripe i altres grans plataformes per demostrar la propietat d’un domini. Consultem registres DNS públics: no hi ha cap credencial confidencial implicada.

I tant. Repeteix el procés per a cada domini que vulguis connectar a Chatgram. Cada domini necessita el seu propi registre TXT _chatgram-verify. El tauler de Chatgram gestionarà tots els dominis verificats des d’un sol lloc.

A punt per començar?

Afegeix el registre.
Verifica. Posa’t en marxa.

Els teus clients t’esperen. Configura el registre DNS, verifica el domini i comença a rebre missatges de suport directament a Telegram.

🔒Verificació estàndard del sector
⚡Configuració en 5 minuts
💬Suport amb Telegram