How oyekamal/maps2whatsapp works
maps2whatsapp is a local web app for finding Google Maps businesses and sending them personalized WhatsApp outreach. The main workflow is search leads, draft and personalize editable messages, connect a WhatsApp account by QR code, then send selected messages with safeguards. The graph also shows CSV export and live status updates. Relationships are based on the README and sampled source; the UI implementation itself was not sampled, so its interactions are documented at the product level.
Main entry points: server.js HTTP server · whatsapp.js WhatsApp connection · llm.js Message drafting · scraper.js Lead search
Components 18
Web app
- Web interface
public/index.html - HTTP server
server.js - Live updates
server.js
Lead discovery
- Lead search
lib/scraper.js - Location geocoding
lib/scraper.js - Lead results
server.js - CSV export
lib/util.js
Message drafting
- Message drafting
lib/llm.js - Lead and message utilities
lib/util.js
WhatsApp outreach
- WhatsApp connection
lib/whatsapp.js - WhatsApp session
lib/whatsapp.js - Send job
server.js - Sent history
lib/whatsapp.js
Other components
- Freelancer
- OpenStreetMap Nominatim
- Google Maps scraper
- Ollama
- WhatsApp Web
Connections 21
- Freelancer → Web interface: uses
README.md - Web interface → HTTP server: requests actions
README.md - HTTP server → Lead search: searches leads
server.js - Lead search → Location geocoding: geocodes location
lib/scraper.js - Location geocoding → OpenStreetMap Nominatim: queries
lib/scraper.js - Lead search → Google Maps scraper: runs query
lib/scraper.js - HTTP server → Lead results: stores results
server.js - HTTP server → CSV export: exports leads
server.js - HTTP server → Message drafting: drafts message
server.js - HTTP server → Message drafting: personalizes leads
server.js - Message drafting → Ollama: generates text
lib/llm.js - Message drafting → Lead and message utilities: renders fallback
lib/llm.js - HTTP server → WhatsApp connection: connects account
server.js - WhatsApp connection → WhatsApp Web: connects and sends
README.md - WhatsApp connection → WhatsApp session: saves session
lib/whatsapp.js - HTTP server → Send job: starts send job
server.js - Send job → WhatsApp connection: sends messages
server.js - Send job → Lead and message utilities: renders template
server.js - WhatsApp connection → Sent history: records sends
lib/whatsapp.js - HTTP server → Live updates: emits events
server.js - Live updates → Web interface: streams status
README.md