📊 Message sending statuses
What is a status
A status is information about what happened to a message at each stage of sending and delivery.
Statuses are displayed in the “Sending Status” column of the table and update automatically.
🎨 Color indicators
Status colors help quickly assess results:
- 🟢 Green — success (sent, delivered, read, completed)
- 🔴 Red — error (error, chat_open_error, sending_failed, etc.)
- 🔵 Blue — in progress (typing)
- 🟠 Orange — waiting/paused (sending, paused)
- ⚪ Gray — not started yet (pending)
📋 Main statuses
Sending process
pending (gray)
Message is waiting in queue for sending
typing (blue)
Simulating typing before sending
sending (orange)
Message is being sent
sent (green)
✅ Message successfully sent
Delivery statuses
delivered (dark green)
✅ Message delivered to recipient (one checkmark in WhatsApp)
read (dark blue)
✅ Message read by recipient (two blue checkmarks in WhatsApp)
General errors
error (red)
❌ General sending error
paused (orange)
⏸️ Mailing paused by user
completed (green)
✅ Mailing completed
Specific errors
chat_open_error (brown)
❌ Failed to open chat with recipient
whatsapp_not_found (brown)
❌ Number not registered in WhatsApp
group_not_found (brown)
❌ Group not found (when sending to group)
conversation_required (dark green)
⚠️ Conversation required (safe mode enabled)
input_field_error (dark red)
❌ Error inserting message into WhatsApp field
sending_failed (crimson)
❌ Failed to send message
api_timeout (indigo)
❌ Response timeout exceeded
🔄 Retry logic
When starting a mailing, the program checks each row’s status:
✅ Will be sent again:
- Empty status — message hasn’t been sent yet
- error — there was an error, need to retry
- sending — sending was interrupted, retrying
- api_timeout — timeout exceeded, retrying
- conversation_required — conversation needed
❌ Will NOT be sent again:
- sent — already successfully sent
- delivered — delivered to recipient
- read — read by recipient
- completed — task completed
💡 This allows:
- Continue interrupted mailing
- Retry only failed sends
- Avoid duplicating successfully delivered messages
📊 Combined statuses
Format: current:previous
The program remembers the status of the previous message to this chat and displays it after a colon.
Examples:
sent:delivered
Current message sent, previous was delivered
error:sent
Current message failed, but previous was successful
sent:read
Current sent, previous read
Colors in combined statuses
- First part (current) — status color (green/red)
- Colon — black
- Second part (previous) — gray color
Display example:
sent:delivered
Retry logic for combined statuses
Decision is made only by the first part (current status):
sent:delivered→ ❌ Will NOT send (current = sent)error:sent→ ✅ Will send (current = error)sending:read→ ✅ Will send (current = sending)
💾 Saving statuses
Auto-save
Statuses are saved automatically:
- ✅ After each send
- ✅ When pausing mailing
- ✅ When closing browser
- ✅ In local storage
Export results
To save mailing report:
- Click the “Export” button after completion
- Excel file downloads with:
- All numbers
- Current statuses
- Sender numbers
- Recipient names
- Use this file for:
- Analyzing results
- Reporting
- Resending failed messages
💡 Practical tips
Quick result assessment
After mailing, look at the table:
- Lots of green → excellent, most sent
- Lots of red → check numbers and settings
- Mixed colors → normal, some need attention
Working with common errors
whatsapp_not_found
- Check number correctness
- Make sure number is registered in WhatsApp
- Remove from list or fix
conversation_required
- Disable “Safe mode”
- Or start conversation with number manually
- Then retry sending
api_timeout
- Increase delays between messages
- Check internet speed
- Try sending again
chat_open_error
- Check if WhatsApp Web is open
- Refresh WhatsApp page
- Check internet connection
Process optimization
- Before mailing:
- Verify all numbers
- Use “Preview” to check text
- Set adequate delays
- During mailing:
- Watch colors in table
- If many errors — stop and check
- After mailing:
- Export results
- Analyze errors
- Fix issues and retry for failed ones
Progress bar
The green progress bar shows:
- How many messages sent
- How many remaining
- At 100% — mailing completed
🔍 Interface tooltips
Hover cursor over status cell — see tooltip:
“Current message status : Previous message status”
This is a reminder about combined status format.