wa-otp
Gateway de autenticación OTP autoalojable para WhatsApp y Telegram. Permite verificar números de teléfono sin intermediarios SaaS. Incluye backend en FastAPI, frontend en Next.js y base de datos PocketBase.
Ficha actualizada 22 sept 2026, 16:11 · upstream 18 sept 2026, 4:24 · release sin release detectada
Qué es wa-otp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
WA OTP es una pasarela de entrega de códigos de un solo uso (OTP) diseñada para ser autoalojada y gratuita. El proyecto conecta credenciales propias de la API Cloud de WhatsApp de Meta y la API de Telegram, permitiendo a los desarrolladores poseer sus datos sin depender de servicios SaaS intermedios. La arquitectura separa el plano caliente (FastAPI en puerto 8000) del plano de control (PocketBase en 8090), garantizando que la base de datos nunca esté expuesta directamente a los clientes, solo accesible mediante autenticación de superusuario desde el backend o el navegador.
El canal de Telegram es completamente gratuito e ilimitado, ideal para pruebas y flujos de alto volumen sin fricción corporativa. El canal de WhatsApp soporta la API Cloud oficial con plantillas de autenticación personalizadas, aunque requiere un registro empresarial verificado (GST, tarjeta internacional) para producción pública. El sistema gestiona automáticamente cuotas mensuales, límites por teléfono y claves API, con una lógica de límites implementada en el backend para evitar fallos opacos.
El proyecto incluye 61 pruebas automatizadas pasando y soporta desarrollo con variables de entorno como WAOTP_MOCK_DELIVERY para simular entregas sin credenciales reales. El frontend (Next.js) es opcional; la API funciona independientemente del dashboard, aunque este facilita la gestión de claves y cuotas. La configuración de PocketBase permite compartir una instancia entre proyectos mediante prefijos de colección, manteniendo el aislamiento de datos.
- Verificación de usuarios en aplicaciones móviles pequeñas sin costes de SMS ni DLT
- Pruebas de flujos de autenticación con Telegram sin coste alguno para desarrolladores
- Gestión centralizada de claves API y cuotas mensuales mediante panel administrativo
- Implementación de verificación telefónica en proyectos India-centricos donde el email no es viable
- Despliegue compartido de PocketBase para múltiples microservicios con aislamiento de datos
- Telegram OTP ilimitado y gratuito sin KYC ni tarjeta de crédito requerida
- 61 pruebas automatizadas pasando, indicando estabilidad del backend y frontend
- Arquitectura desacoplada: FastAPI maneja lógica y límites, PocketBase solo almacenamiento
- Soporte para WAOTP_MOCK_DELIVERY para integración completa sin credenciales reales
- Gestión de cuotas y throttling implementada en Python (FastAPI), no en JSVM
- WhatsApp requiere registro empresarial Meta oficial (GST, tarjeta internacional) para producción pública
- No incluye Dockerfile ni Compose; se debe descargar el binario de PocketBase manualmente
- El canal de Telegram requiere que el usuario interactúe con el bot antes de recibir OTPs
- Las tarjetas RuPay o débito locales fallan en la suscripción recurrente para WhatsApp (RBI)
- No soporta despliegue one-click; requiere configuración manual de entornos y binarios
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Descargar PocketBase v0.40.x manualmente y colocar en backend/pocketbase. Activar entorno virtual Python e instalar dependencias. Configurar variables de entorno para Meta (token cifrado) y Telegram. Usar WAOTP_MOCK_DELIVERY=1 solo en desarrollo. Para producción, establecer DASHBOARD_ORIGIN para evitar errores CORS. Ejecutar un único worker uvicorn con locks concurrentes para evitar doble gasto de cuotas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.