LocalizadosVzlaBot — Asistente de Ayuda Sismo (WhatsApp & Telegram)

Chatbots para WhatsApp y Telegram diseñados para centralizar la búsqueda de personas, centros de acopio y necesidades de insumos tras el terremoto en Venezuela.

• WhatsApp: wa.me/573243552073
• Telegram: @localizadosvzla2026_bot

¿Qué hace el proyecto?

En una emergencia de gran escala, la información de ayuda suele dispersarse en múltiples plataformas web. Este proyecto conecta y unifica en un chat simple de WhatsApp y Telegram los datos de las principales herramientas activas en el terreno: Localizados Venezuela, SOS Venezuela, AcopioVE y ResponseGrid.

El sistema funciona de forma directa mediante APIs, lo que significa que no almacena chats ni datos personales en un servidor propio, garantizando velocidad y total privacidad.

Características Técnicas

1. Búsqueda y Limpieza de Datos (Smart Fusion)

• Consulta Paralela: Al buscar a alguien por nombre o cédula, el bot consulta al mismo tiempo la base de datos oficial (LocalizadosVE) y el registro comunitario (SOSVE).
• Limpieza de Duplicados: Compara los nombres recibidos normalizando el texto (quita acentos, mayúsculas y espacios extras) para entregar una respuesta limpia y evitar confusión.
• Protección de Menores: El bot detecta automáticamente menores de edad y enmascara su ubicación exacta o datos clínicos sensibles para proteger su seguridad.

2. Centros de Donación y Solicitudes de Insumos

• Acopio Unificado: Al escribir acopio [ciudad] (ej. acopio Valencia), el bot busca centros en AcopioVE y ResponseGrid a la vez, quitando duplicados y mostrando la dirección de entrega, contacto, estado del centro y el mapa de origen.
• Filtros de Necesidad: Puedes escribir necesidad agua caracas o necesidad comida y el bot comprenderá la categoría y la prioridad para traer solo los datos relevantes desde ResponseGrid.
• Estadísticas de la Emergencia: Al escribir resumen o estadísticas obtienes un conteo en vivo de los insumos más requeridos y la cantidad total de centros registrados.

3. Rendimiento y Seguridad

• Caché en Memoria: Guarda los resultados de las consultas por unos minutos (de 1 a 5 min según la consulta) para responder rápido a los usuarios y no saturar las APIs externas con peticiones repetidas.
• Control de Spam (Rate Limiting): WhatsApp tiene límite a nivel de servidor HTTP y Telegram cuenta con un limitador en memoria para evitar que usuarios maliciosos saturen el servicio.
• Autenticación de Webhooks: Se valida la firma del webhook con clave secreta y el puerto público en producción se configuró restringido a localhost, evitando llamadas falsas de terceros.

Stack

• Node.js (Express, Axios, Helmet)
• FZap API para WhatsApp
• Long Polling para Telegram
• Docker & Docker Compose (Imágenes seguras sin privilegios de root)
• Telemetría anónima de uso con PostHog