Error Codes Reference
Decode common error messages and understand what they mean.
- Access to WhatSnap Manager logs
Overview
When a message fails to send, WhatSnap records a specific error code in the Manager Dashboard. Understanding these codes allows you to distinguish between a simple internet flicker and a serious carrier block.
Common Error Codes Reference
Use this table to diagnose your failures:
| Code | Meaning | Fix |
|---|---|---|
| `401` | Unauthorized | Token expired. Re-authenticate the line. |
| `403` | Device Offline | Check phone WiFi and power settings. |
| `429` | Too Many Requests | Rate limited. Increase your pacing. |
| `500` | GHL API Error | GHL webhooks are down. Wait and retry. |
| `SIM_REJECTED` | Carrier Block | SIM is suspended. Contact your carrier. |
| `INVALID_TAG` | Routing Error | Contact has wrong Account Tag. |
Error Categories
Follow this anchor link to deep-dive into specific issues:
1. Authentication Errors (400 - 401)
These happen when the WhatSnap Bridge software on your phone or Mac is no longer "talking" to the Manager.
- Solution: Open the WhatSnap app, sign out, and scan a Fresh QR Code.
2. Physical Connection Errors (403 - 404)
The Manager is trying to send a command, but the hardware is not listening.
- Solution: Verify the phone has at least 3 bars of WiFi and the app is not being "Optimized" by the battery settings.
3. Carrier Rejection (SIM_REJECTED / CARRIER_FAIL)
The command reached the phone, the phone tried to send, but the mobile network said "No".
- Solution: Check your SIM balance. If you have credit, your number is likely blocked for spam.
Log Expiry: WhatSnap logs are kept for 30 days. If you are investigating a historical campaign failure, export your logs before they are cycled.
Troubleshooting Steps
Copy Error Code
Identify the code next to the red dot in the Manager `Activity` tab.
Verify Contact Info
Ensure the recipient phone number is in the correct International Format (e.g., `+1...`).
Manual Override
Try using a Switch Command to send the same message through a different line. If it works there, the issue is line-specific.
Check Webhook URL
Ensure your GHL `Custom Provider` webhook hasn't been changed or deleted.
Common Questions
What does “Webhook Timeout” mean?
It means WhatSnap sent the message successfully, but GoHighLevel did not confirm receipt within 10 seconds. This is usually a temporary GHL system delay.
Why do I see “Empty Message” errors?
Check your GHL Workflow Actions. This happens if you used a custom field variable that was blank for that specific contact.
Related
Last updated on January 18, 2026