WhatsApp Agent — troubleshooting

Common issues with the WhatsApp Agent and how to resolve them.

Bot does not respond at all

1. Confirm your number is verified in Dashboard → Integrations. If the card shows Pending or Not connected, complete the verification flow.
2. Make sure you are texting the correct bot number. The exact number is shown on the Integrations card — copy it directly to avoid typos.
3. Check that the bot number is not blocked in your phone's contacts or WhatsApp settings. Tap the bot number → Unblock if needed.
4. WhatsApp may have delivered the message but the webhook timed out. Wait 10 seconds and try again. If the issue persists, check the Status page for any active incidents affecting the WhatsApp Agent component.

Bot replies "Profile not found"

This means your WhatsApp number is registered but has no active profile. Go to Dashboard → Profiles and ensure at least one profile exists. Then send switch <profile name> via WhatsApp to activate it.

Bot replies "No accounts connected"

Your active profile has no connected social accounts. Go to Accounts and connect at least one platform. Then retry the command.

Posts scheduled via WhatsApp are not going live

1. Check that the scheduled time has passed — the bot uses UTC internally and converts to your profile's configured time zone.
2. Verify the connected account token is still valid. Open Accounts and look for any account showing Expired or Revoked. Reconnect the account and reschedule.
3. Check the Posts page for the post status and any error messages from the platform.

Bot replies with a plan-limit error

You have reached a limit on your current plan (posts, profiles, or accounts). The bot message includes the specific cap you hit and a link to upgrade. Visit Billing to upgrade your plan.

"WhatsApp integration requires a Pro plan"

The WhatsApp Agent is available on Pro and Max plans only. Upgrade at /dashboard/billing.

Duplicate messages

If you see the same reply sent twice, this is typically caused by your phone sending the same WhatsApp message twice due to a poor connection. The LetsPost server deduplicates inbound webhooks, but a small duplicate window (~5 s) exists. This is harmless — the post will only be created once.

Getting additional help

If none of the above resolves your issue, open a support ticket from Dashboard → Support and include the following:

• The exact message you sent to the bot
• The reply the bot returned (or "no reply")
• The approximate time (UTC) of the attempted command
• Your registered WhatsApp number (last 4 digits only)