Chatgram
App ed estensioni

Configura Chatgram nella tua app nativa / estensione

Integra Chatgram nella tua app mobile, app desktop o estensione Chrome. Verifica il tuo dominio, ottieni la tua chiave API pubblica e inizia a ricevere messaggi di assistenza su Telegram in pochi minuti.

~5 min
Tempo di configurazione
Gratis
Per iniziare
Chiave API
Metodo di autenticazione
> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
theme: { primaryColor: '#EE6055' }
});
✓ Widget inizializzato con la chiave API
Autenticazione con chiave pubblica
Verifica → Ottieni la chiave → Integra
Passaggio 1: aggiungi un record DNS

Aggiungi questo record TXT
al tuo dominio

Vai alle impostazioni DNS del tuo dominio e aggiungi il record mostrato qui. Questo record TXT dimostra la proprietà del dominio senza modificare il tuo sito web, le email o la configurazione DNS esistente.

🔒Non influisce sul tuo sito web né sulla consegna delle email
⚡La propagazione richiede da 1 a 10 minuti con la maggior parte dei provider
🌐Compatibile con qualsiasi provider DNS al mondo
Record DNS richiesto
Record TXT
Tipo
TXT
Nome / Host
_chatgram-verify
Valore / Contenuto
chatgram-site-verification=true
TTL
300 (o Auto)
💡
Esempio: Se il tuo dominio è mysite.com, il nome host completo del record diventa _chatgram-verify.mysite.com. Alcuni provider aggiungono automaticamente il dominio: in tal caso, inserisci solo _chatgram-verify.
Passaggio 2: verifica il dominio

Controlla il tuo record DNS
e rivendica il tuo sito

Inserisci il tuo dominio e il tuo indirizzo email. Verificheremo il record TXT e ti invieremo un link monouso per accedere al pannello di amministrazione di Chatgram. Non serve Telegram per iniziare.

🔒Verifica lato server
✉️Invio email
⏱~ 60 secondi
Passaggio 3: controlla la tua email

Poi: controlla la tua email

Dopo aver completato il passaggio 2, ti invieremo un link monouso per accedere al pannello di amministrazione di Chatgram come proprietario del tuo sito.

In attesa del passaggio 2
Passaggio 3

Completa il passaggio 2 per ricevere l'email di accesso

Verifica prima il tuo dominio; poi invieremo qui il link di accesso.

Passaggio 4: per sviluppatori

Integra con la chiave pubblica

Per le app native e le estensioni di Chrome, il rilevamento automatico del dominio non è disponibile. Per autenticarti, usa una chiave API pubblica che collega direttamente il widget al tuo account Chatgram.

Come ottenere la chiave pubblica
  1. Nel bot Chatgram , apri Impostazioni in basso, quindi tocca chiavi di sviluppo.
  2. Seleziona il tuo dominio. Chatgram ti invierà un messaggio con le chiavi: inoltralo al tuo sviluppatore, così potrà estrarre la chiave pubblica (spesso inizia con pk_) e inserirla nel codice qui sotto.
🔑publicKey sostituisce il rilevamento automatico del dominio
📱Necessaria per app native ed estensioni
🔒Puoi condividerla in sicurezza: è una chiave pubblica, non un segreto
⚡Stesso widget, stesse funzionalità, stessa API
Sostituisci pk_YOUR_PUBLIC_KEY con la chiave dalla dashboard di Telegram
Includi tramite CDN
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
oppure
<script src="https://unpkg.com/chatgram-widget"></script>
JavaScript vanilla con chiave pubblica
<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>
💡
Quando viene fornito publicKey, il widget salta completamente il rilevamento automatico del dominio. È la soluzione corretta per app native, estensioni di Chrome, app Electron e qualsiasi ambiente senza un dominio web standard. Documentazione completa su npm.
Passaggio 5: invia la NUOVA estensione

Pubblica la tua build sul Chrome Web Store

Quando il widget Chatgram è configurato con publicKey e testato in locale, crea una build di produzione e inviala come nuova estensione oppure come aggiornamento di una scheda già esistente. Durante la revisione, lo store verifica che il manifest, le autorizzazioni e le informative sulla privacy corrispondano alle funzioni effettive dell’estensione.

  • Apri la Dashboard per sviluppatori del Chrome Web Store e seleziona Nuovo elemento (per la prima pubblicazione) oppure carica un nuovo pacchetto per un’estensione che già gestisci.
  • Fai in modo che le autorizzazioni del manifest siano adeguate all’uso di Chatgram (ad esempio, includi solo le autorizzazioni per i siti o le API di cui hai davvero bisogno) e assicurati che l’URL dell’informativa sulla privacy sia aggiornato se raccogli dati degli utenti.
  • Completa la scheda (descrizione, screenshot, categoria), quindi invia per la revisione. Dopo l’approvazione, gli utenti potranno installare l’estensione e contattarti tramite lo stesso canale Chatgram configurato in precedenza.

Suggerimento: Per apportare modifiche dopo il lancio, usa la stessa dashboard: carica un nuovo ZIP, aggiorna la versione in manifest.json e invia di nuovo l’estensione per la revisione, se necessario.

Come funziona

Configuralo in 4 semplici passaggi

La verifica del dominio dimostra che sei il proprietario del dominio che vuoi collegare a Chatgram. Bastano pochi minuti e non servono competenze tecniche.

01
Passaggio 01

Accedi al tuo provider DNS

Vai al registrar del tuo dominio o al provider DNS presso cui gestisci i record del dominio. Potrebbe essere Cloudflare, GoDaddy, Namecheap o qualsiasi altro provider.

02
Passaggio 02

Vai ai record DNS

Individua la sezione di gestione DNS. Cerca voci come "Record DNS", "Impostazioni DNS", "Editor di zona" o "Gestisci DNS". Ogni provider può usare un nome leggermente diverso.

03
Passaggio 03

Aggiungi un nuovo record TXT

Crea un nuovo record DNS con le impostazioni esatte mostrate nella sezione Record DNS di questa pagina. Assicurati che il tipo di record sia TXT e che i valori corrispondano esattamente.

04
Passaggio 04

Verifica e attiva

Attendi qualche minuto affinché le modifiche DNS si propaghino, poi inserisci il tuo dominio nella sezione Verifica dominio e fai clic su "Verifica ora" per verificare e attivare Chatgram.

Provider DNS

Link rapidi ai provider più usati

Vai direttamente alla dashboard del tuo provider DNS e aggiungi il record di verifica di Chatgram. Non lo trovi nell'elenco? La procedura è la stessa con qualsiasi provider.

Cloudflare
DNS → Seleziona il dominio → Aggiungi record
GoDaddy
I miei prodotti → DNS → Aggiungi record
Namecheap
Elenco domini → Gestisci → DNS avanzato
Google Domains
I miei domini → DNS → Record personalizzati
AWS Route 53
Zone ospitate → Seleziona → Crea record
DigitalOcean
Rete → Domini → Aggiungi record
FAQ

Domande frequenti

Tutto quello che devi sapere sulla verifica DNS e sulla registrazione dei domini per Chatgram.

Hai ancora domande? Contattaci tramite Chatgram Live Chat o scrivici a [email protected]

La maggior parte dei provider DNS propaga i record TXT entro 1–10 minuti. In rari casi, a seconda del provider DNS e delle impostazioni TTL, possono essere necessarie fino a 48 ore. Con Cloudflare, in genere la propagazione richiede meno di 2 minuti.

No. I record TXT sono voci di soli metadati nella zona DNS. L’aggiunta del record di verifica Chatgram non influisce in alcun modo sul tuo sito web, sulla consegna delle email o sugli altri record DNS esistenti.

Ti consigliamo di mantenere il record TXT. Chatgram verifica periodicamente la titolarità del dominio per garantire la sicurezza. Se il record viene rimosso, il dominio potrebbe risultare non verificato al successivo controllo.

Chatgram supporta i sottodomini. Per verificare support.mysite.com, aggiungi il record TXT come _chatgram-verify.support.mysite.com. Inserisci "support.mysite.com" nel campo di verifica.

Per prima cosa, controlla che il nome del record sia esattamente _chatgram-verify (alcuni provider aggiungono automaticamente il tuo dominio, quindi potrebbe bastare inserire _chatgram-verify). Verifica che il valore sia esattamente chatgram-site-verification=true, senza spazi aggiuntivi. Se è tutto corretto, attendi ancora qualche minuto perché la propagazione si completi e riprova.

Sì. La verifica DNS TXT è il metodo standard del settore, usato da Google, Microsoft, Stripe e altre grandi piattaforme per dimostrare la titolarità di un dominio. Consultiamo i record DNS pubblici: non vengono utilizzate credenziali sensibili.

Certamente. Ripeti la procedura per ogni dominio che vuoi collegare a Chatgram. Ogni dominio deve avere il proprio record TXT _chatgram-verify. La dashboard di Chatgram gestirà tutti i domini verificati in un unico posto.

Pronto per iniziare?

Aggiungi il record.
Verifica. Vai online.

I tuoi clienti ti aspettano. Configura il record DNS, verifica il dominio e inizia a ricevere le richieste di assistenza direttamente su Telegram.

🔒Verifica secondo gli standard del settore
⚡Configurazione in 5 minuti
💬Assistenza tramite Telegram