Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

PerGo

Plataforma CPaaS omnicanal auto-alojada escrita en Go que unifica WhatsApp (Web y Cloud API) y Telegram bajo una única REST API, priorizando eficiencia de recursos y soberanía de datos.

Ficha actualizada 22 sept 2026, 15:03 · upstream 22 sept 2026, 13:51 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es PerGo

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

PerGo es una plataforma de comunicación omnicanal auto-alojada desarrollada en Go, diseñada para abstraer la fragmentación de proveedores mediante una única API REST unificada. Permite enrutar mensajes a través de WhatsApp Web (vía whatsmeow), WhatsApp Cloud API (WABA) y Telegram Bot API bajo un contrato JSON estandarizado con pipelines de fallback automáticos.

El sistema se basa en una arquitectura de separación de preocupaciones donde las solicitudes HTTP y eventos externos se ingieren y colorean inmediatamente en colas duraderas de NATS JetStream. Esto aísla a los consumidores de la API y a las redes externas de picos transitorios, garantizando una entrega robusta con límites estrictos de sesión.

La plataforma incluye un panel de operador en tiempo real para monitorear el rendimiento de entrega, gestión de conexiones de dispositivos y métricas del espacio de trabajo. Ofrece documentación interactiva mediante Scalar OpenAPI 3.1 integrada y descubrimiento de agentes a través de /llms.txt.

CASOS DE USO
  • Integración de mensajería en sistemas críticos como CRMs, ERPs o flujos de trabajo de IA autónomos.
  • Gestión de campañas de broadcast segmentadas con filtrado por etiquetas y control de ritmo mediante token bucket.
  • Unificación de múltiples canales (WhatsApp Web, WABA, Telegram) en una sola interfaz de inbox para atención al cliente.
  • Despliegue auto-alojado para garantizar soberanía de datos y cumplimiento estricto de GDPR/LGPD sin costes por mensaje.
PUNTOS DESTACADOS
  • Extrema eficiencia de recursos: consumo inferior a 50MB RAM con un único binario compilado en Go.
  • Almacenamiento durable mediante NATS JetStream para colas de trabajo con entrega al menos una vez y control de backpressure.
  • Seguridad de datos on-premise con cifrado AES-256-GCM (KEK/DEK) y almacenamiento seguro de sesiones de dispositivo.
  • API unificada que soporta fallback automático entre canales (ej. Telegram a WABA) bajo un contrato JSON estandarizado.
  • Documentación interactiva OpenAPI 3.1 integrada en /docs sin dependencias externas.
PRECAUCIONES
  • Dependencia de APIs oficiales de Meta (WABA) para WhatsApp, lo que implica costes por mensaje y configuración manual de usuarios del sistema.
  • WhatsApp Web requiere IP estática o gestión manual de proxies residenciales para mitigar riesgos de suspensión.
  • No incluye soporte multi-tenencia ni facturación en la edición comunitaria auto-alojada.
  • La actualización de dependencias y migraciones de base de datos deben gestionarse manualmente en el despliegue self-hosted.
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO30 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Docker Compose detectado

Para producción, utilice el script de instalación automatizado con Traefik v3 para SSL/TLS automático. Para desarrollo local, ejecute docker compose up -d. Asegure la contraseña del admin y configure las variables de entorno de PostgreSQL y NATS antes de iniciar.

✓Dockerfile
✓Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsGo
SERVICIOS
PostgreSQLRedisS3/MinIONATS
BASES DE DATOS
PostgreSQLRedis
PUERTOS
8080543342226060
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.