Messages Not Sending

Messages failing? Three quick checks will pinpoint the issue in under 2 minutes.

Diagnose message delivery failures in under 2 minutes with these quick checks. Because WhatSnap is a bridge, the break can happen at the GoHighLevel, WhatSnap Manager, or Physical Carrier level—knowing which one saves troubleshooting time.

Before you start

Active Connected Line
Access to WhatSnap Dashboard Logs

The Diagnostic Flow

Follow this anchor link to identify the root cause:

Check GHL Status

In the GHL conversation, does the message bubble have a red ℹ️ icon? If so, the failure happened at the GHL webhook level. If it shows "Sent", the request reached WhatSnap.

Verify Dashboard Connection

Open the WhatSnap Manager. Is your line indicator 🟢 Connected? If it is 🔴 Disconnected, your physical device cannot receive the send command. See Device Disconnected.

Review Sending Logs

In the Manager, click on `Logs`. Look for error codes.

Error 403: Authentication invalid. Re-scan the QR code.
Error 500: System timeout. Wait 5 minutes and retry.
Rejected by Carrier: Your SIM is likely blocked.

Manual Hardware Test

Try sending a standard text message from the phone's native app. If it fails there, the issue is your Carrier Plan or cellular signal.

Common Causes and Fixes

1. Line Not Warmed Up

Brand new SIM cards and accounts need a 14-day warm-up period before sending at volume. Skipping this is the most common cause of blocks.

Solution: Follow the warm-up schedule and start with 10–20 messages per day.

2. Daily Volume Limits

Many carriers have a daily limit (e.g., 250 msgs). If you hit this, all WhatSnap messages will fail until the next day.

Solution: Connect multiple lines to distribute volume.

3. URL and Keyword Filtering

US carriers are extremely aggressive at filtering links.

Solution: Remove the URL from your initial message. Send it only after the lead replies.

4. Battery Optimization (Android)

If your phone is sleeping, WhatSnap cannot send.

Solution: Set the Gateway app to Unrestricted in battery settings. See hardware specifications.

Immediate Action: If you see a high number of "Failed" messages in a short period, Stop your workflows immediately. Continuing to send through a failing connection will lead to your account being permanently flagged.

Common Questions

Why do some messages show “Sent” but are never received?

This is a "Shadow Block". It happens when the carrier accepts the message but routes it to a spam folder or drops it entirely because of suspicious content patterns. Common triggers include links, identical messages sent to many recipients, or sending too fast without proper warm-up.

Can I retry failed messages automatically?

WhatSnap will attempt 3 retries over 10 minutes. If it still fails, you must manually trigger a resend in GHL or through a workflow.