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.
Pas 5: Envia l’extensió NOVA

Publica la teva compilació a Chrome Web Store

Quan el widget de Chatgram estigui connectat amb publicKey i l’hagis provat localment, prepara una compilació de producció i envia-la com a extensió nova o com a actualització d’una fitxa existent. Durant la revisió, la botiga comprova que el manifest, els permisos i les declaracions de privadesa coincideixin amb el funcionament real de l’extensió.

  • Obre el Tauler per a desenvolupadors de Chrome Web Store i tria Element nou (per a la primera publicació) o puja un paquet nou per a una extensió que ja gestiones.
  • Ajusta els permisos del manifest a l’ús de Chatgram (per exemple, limita els permisos d’amfitrió o les API als que realment necessites) i mantén actualitzada l’URL de la política de privadesa si reculls dades dels usuaris.
  • Completa la fitxa (descripció, captures de pantalla i categoria) i, després, envia-la a revisió. Un cop aprovada, els usuaris podran instal·lar l’extensió i parlar amb tu pel mateix canal de Chatgram que vas configurar abans.

Consell: Per fer canvis després del llançament, fes servir el mateix tauler: puja un fitxer ZIP nou, incrementa la versió a manifest.json i torna a enviar-la a revisió quan calgui.

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