{"id":34912769,"url":"https://github.com/voscarmv/santabot","last_synced_at":"2026-04-19T23:34:21.978Z","repository":{"id":329882843,"uuid":"1120796343","full_name":"voscarmv/santabot","owner":"voscarmv","description":"Secret Santa Bot for WhatsApp","archived":false,"fork":false,"pushed_at":"2025-12-22T04:58:31.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-23T16:12:38.073Z","etag":null,"topics":["bot","chatbot","christmas","match","matching","santa","secret","secret-santa","sort","whatsapp","wwebjs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voscarmv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-22T00:34:56.000Z","updated_at":"2025-12-22T05:03:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/voscarmv/santabot","commit_stats":null,"previous_names":["voscarmv/santabot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/voscarmv/santabot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voscarmv%2Fsantabot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voscarmv%2Fsantabot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voscarmv%2Fsantabot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voscarmv%2Fsantabot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voscarmv","download_url":"https://codeload.github.com/voscarmv/santabot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voscarmv%2Fsantabot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32026708,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","chatbot","christmas","match","matching","santa","secret","secret-santa","sort","whatsapp","wwebjs"],"created_at":"2025-12-26T11:56:48.203Z","updated_at":"2026-04-19T23:34:21.970Z","avatar_url":"https://github.com/voscarmv.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎅 SantaBot – WhatsApp Secret Santa Bot\n\nUn bot de WhatsApp construido con **whatsapp-web.js** que organiza automáticamente un **intercambio de regalos (Secret Santa)** cuando es agregado a un grupo.\n\nCuando el bot entra al grupo:\n\n* Saluda a todos 🎄\n* Realiza el sorteo de manera automática 🎲\n* Envía a cada participante un **mensaje privado** con la persona a la que le toca regalar 🎁🤫\n* Se despide y **abandona el grupo** 👋\n\nIdeal para grupos de amigos, familia o trabajo.\n\n---\n\n## ✨ Características\n\n* 🤖 Automatización total del sorteo\n* 🔒 Asignaciones **secretas** por mensaje privado\n* 🚫 Evita que alguien se regale a sí mismo\n* 🎄 Mensajes navideños listos para usar\n* 👋 Sale del grupo automáticamente al finalizar\n* ♻️ Autenticación persistente con `LocalAuth`\n\n---\n\n## 🧠 Cómo funciona\n\n1. El bot es agregado a un grupo de WhatsApp\n2. Detecta el evento `group_join`\n3. Obtiene la lista de participantes del grupo\n4. Ejecuta el algoritmo de Secret Santa usando [`@voscarmv/secret-santa`](https://www.npmjs.com/package/@voscarmv/secret-santa)\n5. Envía a cada usuario su asignación **en privado**\n6. Envía un mensaje final al grupo\n7. Abandona el grupo\n\n---\n\n## 🛠️ Tecnologías usadas\n\n* **Node.js**\n* **whatsapp-web.js**\n* **Puppeteer**\n* **qrcode-terminal**\n* **@voscarmv/secret-santa**\n\n---\n\n## 📦 Instalación\n\nClona el repositorio:\n\n```bash\ngit clone https://github.com/voscarmv/santabot.git\ncd santabot\n```\n\nInstala dependencias:\n\n```bash\nnpm install\n```\n\nAsegúrate de tener Google Chrome instalado:\n\n```bash\n/usr/bin/google-chrome-stable\n```\n\n---\n\n## ▶️ Uso\n\nEjecuta el bot:\n\n```bash\nnode index.js\n```\n\n1. Escanea el **QR** desde WhatsApp\n2. Agrega el bot a un grupo\n3. Disfruta del intercambio 🎁🎄\n\n\u003e ⚠️ El bot **debe ser agregado**, no funciona si ya estaba en el grupo.\n\n---\n\n## 📁 Estructura básica\n\n```text\nsantabot/\n├── index.js\n├── package.json\n├── node_modules/\n└── .wwebjs_auth/\n```\n\n---\n\n## 🔐 Notas importantes\n\n* El bot **no necesita ser admin**\n* No puede volver a entrar al grupo sin invitación\n* WhatsApp puede limitar bots en cuentas nuevas\n* Uso bajo tu propia responsabilidad\n\n---\n\n## 🎁 Personalización\n\nPuedes modificar fácilmente:\n\n* 📝 Mensajes del bot\n* ⏱️ Tiempos de espera (`sleep`)\n* 🧑‍🎄 Idioma y tono\n* 📛 Mostrar nombres en vez de números\n\n---\n\n## 📜 Licencia\n\nGPL-3-or-latest\n\n---\n\n## 👤 Autor\n\n**Oscar Mier**\n\n* GitHub: [https://github.com/voscarmv](https://github.com/voscarmv)\n* NPM: @voscarmv\n\n---\n\n🎄✨ ¡Feliz intercambio y felices fiestas! ✨🎄\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoscarmv%2Fsantabot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoscarmv%2Fsantabot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoscarmv%2Fsantabot/lists"}