ClawContentbot

Bot de Telegram para convertir interés en inscripción con contenido guiado

---

Tabla de contenidos

• Resumen
• Características clave
• Arquitectura rápida
• Quickstart
• Configuración
• Uso
• Ejemplos
• Recursos del repositorio
• Contribuir
• Código de conducta y licencia

Resumen

ClawContentbot es un bot de Telegram orientado a talleres y campañas educativas. Expone menú interactivo, mensajes de información/precio, y endpoints de salud (/health, /ready) para despliegue en Railway u otros entornos compatibles con webhooks.

Características clave

🤖 Bot con menú guiado Flujo con botones inline para info del taller, precios/pago y contacto por WhatsApp.	🩺 Endpoints operativos /health y /ready para monitoreo de disponibilidad y configuración de pago.
⚙️ Configuración por JSON + ENV Contenido principal en workshop.config.json y secretos/valores sensibles vía variables de entorno.	✅ Validaciones incluidas Scripts de verificación para sincronía de landing/slides y pruebas con node --test.

Arquitectura rápida

Quickstart

cd claw-content-bot
npm install
cp .env.example .env
npm start

Requisito: Node.js 18+

Configuración

Variables de entorno principales (ver claw-content-bot/.env.example):

Variable	Requerida	Descripción
TELEGRAM_BOT_TOKEN	Sí	Token del bot de Telegram.
PORT	No	Puerto local (en Railway suele venir inyectado).
WEBHOOK_URL	No	URL completa del webhook (https://.../<TOKEN>).
RAILWAY_PUBLIC_DOMAIN	No	Dominio público cuando no se define WEBHOOK_URL.
TALLER_WHATSAPP	No	Número mostrado en mensajes de contacto.
PAYMENT_INFO_MARKDOWN	No	Bloque completo de datos de pago en Markdown.
PAYMENT_BANCO / PAYMENT_CUENTA / PAYMENT_CCI / PAYMENT_TITULAR	No (en conjunto)	Alternativa estructurada para datos de pago.

Uso

Scripts disponibles desde claw-content-bot/:

npm start           # Ejecuta bot + servidor Express
npm test            # Pruebas unitarias (node --test)
npm run verify      # Verifica sincronía de assets y slides
npm run verify:assets
npm run verify:slides

Ejemplos

Comandos útiles

curl http://localhost:3000/health
curl http://localhost:3000/ready

Vista del bot / UI

• Banner del proyecto: assets/banner-clawcontentbot.svg
• Diagrama técnico: assets/arquitectura-bot.svg
• Placeholder de captura de Telegram: pendiente de adjuntar screenshot real del chat en producción/local.

Recursos del repositorio

• claw-content-bot/ → código del bot, tests y scripts de verificación.
• docs/index.html → landing pública del taller.
• taller-mayo-2026/operacion/README.md → guías operativas (embudo, métricas, token, UTMs).
• taller-mayo-2026/promocion/copy-promocion.md → calendario/copy de contenidos.

Contribuir

1. Haz fork o crea una rama de trabajo.
2. Mantén los cambios acotados y con contexto.
3. Ejecuta, como mínimo:

cd claw-content-bot
npm test
npm run verify

4. Abre un PR describiendo objetivo, alcance y validación.

Código de conducta y licencia

• Código de conducta: actualmente no hay un CODE_OF_CONDUCT.md en el repositorio.
• Licencia: actualmente no hay archivo LICENSE en el repositorio.

Si deseas, se puede añadir ambos en un siguiente PR para formalizar gobernanza y términos de uso.