Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

L’accesso a Telegram offre ai clienti paganti l’accesso a una chat o canale privato. Il bot Telegram di Dodo Payments genera un link di invito unico per ciascun cliente e li rimuove in caso di cancellazione.

Cosa viene fornito

  • Il grant viene creato in pending mentre il bot prepara l’invito, e poi passa a delivered una volta pronto il link.
  • Il cliente riceve un link di invito unico per Telegram nella sua email di consegna e nel portale clienti.
  • Tocca il link e il bot lo aggiunge alla chat configurata.
  • In caso di cancellazione, rimborso o revoca manuale, il bot lo rimuove dalla chat.
Usi comuni includono canali alfa privati, gruppi di segnali a pagamento e vantaggi per livelli di comunità.

Collegare Telegram

1

Open Entitlements

Nel tuo dashboard di Dodo Payments, vai su Accessi e clicca +, quindi scegli Accesso Telegram come integrazione. Il dashboard richiede il tuo user ID Telegram in modo che il bot possa verificare la proprietà delle chat che gestisce.
Nuovo modulo di accesso Telegram con richiesta di user ID Telegram e pulsante Connect Telegram
I prossimi due passaggi sono attività di configurazione su Telegram e possono essere completati in qualsiasi ordine — ottieni il tuo user ID e aggiungi il bot alla tua chat come amministratore. Una volta fatto, torna al dashboard per l’ultimo passaggio.
2

Get your Telegram user ID

Su Telegram, invia un messaggio a /start:
  • @dodo_payments_bot se stai usando Modalità Live
  • @DodoPaymentsTestBot se stai usando Modalità Test
Il bot risponde con il tuo user ID numerico di Telegram. Copialo — lo inserirai nel dashboard nell’ultimo passaggio.
3

Add the bot to your chat as an admin

Nella chat o canale Telegram che vuoi proteggere, apri l’elenco dei membri e aggiungi lo stesso bot come amministratore (@dodo_payments_bot per live, @DodoPaymentsTestBot per test) con questi due permessi abilitati:
  • Ban Users — necessario per rimuovere i membri in caso di revoca
  • Add Users — necessario per invitare i clienti paganti
Disattiva tutti gli altri permessi di amministrazione.
Schermata di promozione a amministratore in Telegram che mostra Ban Users e Add Users abilitati per il bot di Dodo Payments
4

Connect Telegram and pick the chat

Torna al dashboard, inserisci lo user ID dal passaggio 2 in Telegram User ID e clicca Connect Telegram. L’elenco delle chat ora mostra ogni gruppo e canale dove il bot è un amministratore — scegli quello che vuoi proteggere, dai un nome al grant e clicca Create Entitlement.

Flusso del cliente

  1. Il cliente completa il checkout.
  2. Dodo Payments crea un grant pending e chiede al bot di generare un link di invito unico alla chat configurata.
  3. Una volta pronto il link, il grant passa a delivered e il link è incluso nell’email di consegna e nel portale clienti.
  4. Il cliente tocca il link ed è aggiunto alla chat.
  5. In caso di revoca, il bot rimuove il cliente dalla chat.
Il link di invito è monouso e scade dopo che il cliente si unisce. Se perde il link prima di unirsi, rigeneralo inviando nuovamente l’email di consegna o revocando e ricreando il grant dal dashboard.

Configurazione richiesta

CampoRichiestoDescrizione
chat_idL’ID della chat Telegram (numerico, spesso negativo per gruppi/canali). Il selettore del dashboard lo compila per te.

Creare via API

const entitlement = await client.entitlements.create({
  name: 'Premium Signals Group',
  integration_type: 'telegram',
  integration_config: {
    chat_id: '-1001234567890',
  },
});

Webhooks

Vedi eventi webhook entitlement_grant.*. I grant di Telegram arrivano pending e passano a delivered una volta che il bot ha emesso il link di invito.

Risoluzione dei problemi

Il bot di Dodo Payments deve essere aggiunto alla chat come amministratore con Add Users abilitato. Il selettore legge lo stato live, quindi la chat appare non appena il bot è un amministratore.
Il bot ha bisogno del permesso di amministratore Ban Users per rimuovere i membri. Apri le impostazioni della chat e conferma che sia Ban Users che Add Users siano attivati sul bot di Dodo Payments.
Last modified on May 14, 2026