Accesso Telegram

​

Cosa viene fornito

• Il grant viene creato in Pending. Rimane Pending dopo che il cliente collega il proprio account Telegram e il bot emette il link per la richiesta di partecipazione.
• Nel Customer Portal, il cliente fa clic su Connetti, invia /start al bot Dodo Payments per ottenere il proprio ID utente Telegram, lo inserisce e fa clic su Collega account.
• Il bot invia al cliente un link per la richiesta di partecipazione su Telegram. Quando il cliente richiede di partecipare, il bot approva la richiesta solo per l’account collegato.
• In caso di annullamento, rimborso o revoca manuale, il bot rimuove il cliente dalla chat e lo esclude. Se acquista nuovamente, il bot revoca l’esclusione prima di inviare un nuovo link.

​

Collegare Telegram

1

Open Entitlements

Nella dashboard di Dodo Payments, vai su Entitlements e fai clic su +, quindi scegli Telegram Access come integrazione. La dashboard richiede il tuo ID utente Telegram, che collega le chat a cui aggiungi il bot alla tua attività.

I due passaggi successivi avvengono in Telegram e puoi eseguirli in qualsiasi ordine: ottenere il tuo ID utente e aggiungere il bot alla chat come amministratore. Quando entrambi sono completati, torna alla dashboard per il passaggio finale.

2

Get Your Telegram User ID

In Telegram, invia /start a:

• @dodo_payments_bot se stai usando Modalità Live
• @DodoPaymentsTestBot se stai usando Modalità Test

Il bot risponde con il tuo ID utente Telegram numerico. Copialo. Lo incollerai nella dashboard nell’ultimo passaggio.

3

Add the Bot to Your Chat as an Admin

Dallo stesso account Telegram, apri il gruppo o canale a cui vuoi limitare l’accesso e aggiungi lo stesso bot come amministratore (@dodo_payments_bot per la modalità live, @DodoPaymentsTestBot per la modalità di test). Abilita queste due autorizzazioni:

• Ban Users: necessaria per rimuovere i membri in caso di revoca.
• Add Users: necessaria per invitare i clienti paganti.

Disattiva tutti gli altri permessi di amministrazione.

4

Connect Telegram and Pick the Chat

Tornato nella dashboard, incolla l’ID utente del passaggio 2 in Telegram User ID e fai clic su Connect Telegram. Il selettore Chat elenca i gruppi e i canali a cui hai aggiunto il bot da quell’account. Scegli la chat a cui vuoi limitare l’accesso, inserisci un Name per l’entitlement e fai clic su Create Entitlement.

​

Flusso del cliente

1. Il cliente completa il checkout.
2. Dodo Payments crea un grant Pending. Non esiste ancora alcun link di invito.
3. L’email di conferma del pagamento elenca l’entitlement come Action Required e contiene un link al Customer Portal. Nel portale, il cliente fa clic su Connect, invia /start al bot, inserisce il proprio ID utente Telegram e fa clic su Link account.
4. Il bot invia al cliente un link per richiedere di entrare su Telegram. Il cliente apre il link e richiede di entrare, quindi il bot approva la richiesta.
5. In caso di revoca, il bot rimuove il cliente dalla chat.

​

Configurazione necessaria

​

Creare via API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

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

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Premium Signals Group"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeTelegram),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigTelegramConfigParam{
      ChatID: dodopayments.F("-1001234567890"),
    },
  ),
})

​

Webhooks

​

Risoluzione dei problemi