How lukasccb/bmms works
Project type and purpose
• This is a backend API service built with Laravel.
• Purpose: allow clients to register phone numbers in bulk (via .docx, CSV or JSON) and asynchronously dispatch WhatsApp messages to those numbers using the ZipWhats external API.
File structure
• Standard Laravel MVC layout:
– app/Http/Controllers (RegisterNumberController, BulkSendController)
– app/Jobs (SendMessageJob)
– app/Models (User, App, Number, SentHistory)
– routes/api.php, routes/web.php, etc.
• Configuration and environment: .env, config/*.php
• Storage of uploaded files: storage/app/private
• Database migrations/seeders under database/…
• Public entrypoint: public/index.php
• Queue processing: php artisan queue:work
README for additional insights
• Two endpoints:
– POST /api/add-bulk-number → parses uploaded file, persists Numbers in database
– POST /api/bulk-send-file → dispatches SendMessageJob jobs to the queue
• Worker processes the queue and calls the ZipWhats API for each number
• Uses Laravel’s built-in queue system, Eloquent ORM, and filesystem
Thoroughness
• Asynchronous paths and retry/failure flows if relevant.
• Notes for configuration points (e.g. .env values for queue connection, API keys).
• Don’t under-represent the Worker and external API – they are core to the bulk sending function.