Droit Telegram

Ce qui est fourni

• L’attribution est créée dans Pending. Elle reste Pending après que le client a associé son compte Telegram et que le bot a émis le lien de demande d’adhésion.
• Dans le Customer Portal, le client clique sur Connect, envoie /start au bot Dodo Payments pour obtenir son identifiant utilisateur Telegram, le saisit, puis clique sur Link account.
• Le bot envoie au client un lien de demande d’adhésion dans Telegram. Lorsque le client demande à rejoindre le chat, le bot approuve uniquement la demande pour le compte associé.
• En cas d’annulation, de remboursement ou de révocation manuelle, le bot retire le client du chat et le bannit. S’il achète à nouveau, le bot lève le bannissement avant d’envoyer un nouveau lien.

Connecter Telegram

1

Open Entitlements

Dans le tableau de bord Dodo Payments, accédez à Entitlements et cliquez sur +, puis choisissez Telegram Access comme intégration. Le tableau de bord vous demande votre identifiant utilisateur Telegram, qui associe les discussions auxquelles vous ajoutez le bot à votre entreprise.

Les deux étapes suivantes se déroulent dans Telegram et peuvent être effectuées dans n’importe quel ordre : obtenir votre identifiant utilisateur et ajouter le bot à votre discussion en tant qu’administrateur. Une fois les deux étapes terminées, retournez au tableau de bord pour effectuer la dernière étape.

2

Get Your Telegram User ID

Dans Telegram, envoyez /start à :

• @dodo_payments_bot si vous utilisez Mode Direct
• @DodoPaymentsTestBot si vous utilisez Mode Test

Le bot répond avec votre identifiant utilisateur Telegram numérique. Copiez-le. Vous le collerez dans le tableau de bord lors de la dernière étape.

3

Add the Bot to Your Chat as an Admin

Depuis le même compte Telegram, ouvrez le groupe ou le canal que vous souhaitez protéger et ajoutez le même bot en tant qu’administrateur (@dodo_payments_bot pour le mode live, @DodoPaymentsTestBot pour le mode test). Activez ces deux autorisations :

• Ban Users : nécessaire pour supprimer les membres lors de la révocation.
• Add Users : nécessaire pour inviter les clients payants.

Laissez toutes les autres autorisations d’administrateur désactivées.

4

Connect Telegram and Pick the Chat

De retour dans le tableau de bord, collez l’identifiant utilisateur de l’étape 2 dans Telegram User ID, puis cliquez sur Connect Telegram. Le sélecteur Chat répertorie les groupes et canaux auxquels vous avez ajouté le bot depuis ce compte. Sélectionnez la discussion que vous souhaitez protéger, saisissez un Name pour l’entitlement, puis cliquez sur Create Entitlement.

Parcours client

1. Le client finalise le checkout.
2. Dodo Payments crée un grant Pending. Aucun lien d’invitation n’existe encore.
3. L’e-mail de confirmation du paiement répertorie l’entitlement comme Action Required et contient un lien vers le Customer Portal. Dans le portail, le client clique sur Connect, envoie /start au bot, saisit son identifiant utilisateur Telegram, puis clique sur Link account.
4. Le bot envoie au client un lien de demande d’adhésion dans Telegram. Le client ouvre le lien et demande à rejoindre la discussion, puis le bot approuve la demande.
5. Lors de la révocation, le bot supprime le client de la discussion.

Configuration requise

Créer via l’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

Dépannage