Saltar al contenido principal

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.

El derecho de Telegram da a los clientes de pago acceso a un chat o canal privado. El bot de Telegram de Dodo Payments genera un enlace de invitación de un solo uso para cada cliente y los elimina en caso de cancelación.

​
Qué se entrega

  • La concesión se crea en pending mientras el bot prepara la invitación, luego se transfiere a delivered una vez que el enlace está listo.
  • El cliente recibe un enlace de invitación de Telegram de un solo uso en su correo de entrega y en el portal del cliente.
  • Tocan el enlace y el bot los agrega al chat configurado.
  • En caso de cancelación, reembolso o revocación manual, el bot los elimina del chat.
Los usos comunes incluyen canales alfa privados, grupos de señales pagados y beneficios de nivel comunitario.

​
Conectar Telegram

1

Open Entitlements

En tu panel de Dodo Payments, ve a Entitlements y haz clic en +, luego elige Telegram Access como la integración. El panel solicita tu ID de usuario de Telegram para que el bot pueda verificar la propiedad de los chats que gestiona.
Formulario de nuevo derecho de acceso a Telegram solicitando ID de usuario de Telegram y botón Conectar Telegram
Los siguientes dos pasos son tareas de configuración en Telegram y se pueden completar en cualquier orden: obtén tu ID de usuario y añade el bot a tu chat como administrador. Una vez que ambos estén listos, vuelve al panel para el paso final.
2

Get your Telegram user ID

En Telegram, envía un mensaje a /start a:
  • @dodo_payments_bot si estás usando Modo en vivo
  • @DodoPaymentsTestBot si estás usando Modo de prueba
El bot responde con tu ID de usuario numérico de Telegram. Cópialo — lo pegarás en el panel en el último paso.
3

Add the bot to your chat as an admin

En el grupo o canal de Telegram que deseas proteger, abre la lista de miembros y añade el mismo bot como administrador (@dodo_payments_bot para vivo, @DodoPaymentsTestBot para prueba) con estos dos permisos habilitados:
  • Ban Users — necesario para eliminar miembros en caso de revocación
  • Add Users — necesario para invitar a clientes de pago
Desactiva todos los demás permisos de administrador.
Pantalla de promoción a administrador de Telegram mostrando Ban Users y Add Users habilitados para el bot de Dodo Payments
4

Connect Telegram and pick the chat

De vuelta en el panel, pega el ID de usuario del paso 2 en Telegram User ID y haz clic en Connect Telegram. El selector de chat ahora lista cada grupo y canal donde el bot es administrador: elige el que deseas proteger, dale un nombre al derecho y haz clic en Create Entitlement.

​
Flujo del cliente

  1. El cliente completa la compra.
  2. Dodo Payments crea un pending de concesión y pide al bot que genere un enlace de invitación de un solo uso al chat configurado.
  3. Una vez que el enlace está listo, la concesión se mueve a delivered y el enlace se incluye en el correo de entrega y el portal del cliente.
  4. El cliente toca el enlace y es añadido al chat.
  5. En caso de revocación, el bot elimina al cliente del chat.
El enlace de invitación es de un solo uso y expira después de que el cliente se une. Si pierden el enlace antes de unirse, regénéralo volviendo a enviar el correo de entrega o revocando y recreando la concesión desde el panel.

​
Configuración requerida

CampoRequeridoDescripción
chat_idSíEl ID de chat de Telegram (numérico, a menudo negativo para grupos/canales). El selector del panel completa esto por ti.

​
Crear vía API

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

​
Webhooks

Consulta eventos de webhook de entitlement_grant.*. Los derechos de Telegram llegan pending y se trasladan a delivered una vez que el bot ha emitido el enlace de invitación.

​
Solución de problemas

El bot de Dodo Payments debe ser agregado al chat como administrador con Add Users habilitado. El selector lee el estado en vivo, por lo que el chat aparece tan pronto como el bot es administrador.
El bot necesita el permiso de administrador Ban Users para eliminar miembros. Abre la configuración del chat y confirma que ambos Ban Users y Add Users están marcados en el bot de Dodo Payments.
Last modified on May 14, 2026