Requisitos previos
Antes de comenzar, tenga en cuenta que debe contar con:- Una cuenta de Telegram
- Cuenta y acceso al Panel de Cloudflare
Pasos de integración
1
Cree un Bot de Telegram con BotFather
- Abra Telegram y busque “@BotFather”
- Inicie una conversación haciendo clic en “Start” o escribiendo
/start
- Cree un nuevo bot escribiendo
/newbot
- Siga las indicaciones:
- Ingrese un nombre para su bot
- Elija un nombre de usuario (debe terminar en ‘bot’)
2
Obtenga los tokens requeridos
Después de crear su bot, BotFather le proporcionará:
- Token del Bot (HTTP API Token)
- Nombre de usuario del Bot
Nunca comparta ni suba su token del bot. Trátelo como un secreto.
3
Instale y configure su proyecto
- Clone el proyecto inicial de Telegram de Sequence:
- Copie los archivos de ejemplo en la raíz de su proyecto:
.env
con VITE_PROJECT_ACCESS_KEY
y VITE_WAAS_CONFIG_KEY
usando sus llaves de Sequence Builder después de la configuración.- Instale las dependencias:
- Compile la aplicación:
- Actualice las
VARS
en el archivowrangler.toml
con un secreto proporcionado por el usuario paraBOT_SECRET
y el token del bot de BotFather paraBOT_TOKEN
.
4
Autentíquese con la cuenta de Cloudflare
Despliegue la app y la lógica de funciones en Cloudflare
- Ejecute
pnpm wrangler pages deploy
5
Registre el Webhook con Telegram
Ahora llamamos a nuestro endpoint
registerWebhook
en nuestra app para registrar la función webhook con la URL de su aplicación desplegada y habilitar el acceso para la API de Telegram.6
Actualice los orígenes permitidos
Asegúrese de haber agregado la URL de su aplicación desplegada como un origen permitido en la configuración de su wallet a través de la página de configuración en Sequence Builder.
7
¡Pruebe el Bot!
Envíe un mensaje a su bot en Telegram y vea si responde. Debería contestarle con la opción de compartir, jugar y obtener más información sobre el bot.
Llevando a producción
Para suBOT_TOKEN
, puede cifrarlo y almacenarlo en Cloudflare con el siguiente comando para evitar filtraciones de datos: