Skip to main content

Common Issues

Here are the most common problems people run into and how to fix them.

WhatsApp Won't Connect​

  • Make sure your phone has internet access. The initial connection requires your phone to be online.
  • For Baileys connections, scan the QR code within 60 seconds — it expires quickly. If it expires, click to refresh and scan again.
  • Try removing and re-adding the account. Go to the sidebar, remove the account, and add it again from scratch.
  • Check if WhatsApp is linked to too many devices. WhatsApp allows a maximum of 4 linked devices. Remove an old one from WhatsApp on your phone (Settings > Linked Devices) if needed.

Messages Not Sending​

  • Check your WhatsApp connection status. A green dot next to the account means it's connected. If it's not green, reconnect the account.
  • Check your rate limits in Settings. You may have hit your daily message limit.
  • Check if the contact has opted out. Opted-out contacts are automatically skipped.
  • For Cloud API connections, verify your access token hasn't expired. Meta access tokens need to be refreshed periodically.

Flow Not Running​

  • Make sure the flow is Active (the toggle should be on). Inactive flows don't run.
  • Check that a WhatsApp account is selected in the flow's trigger node.
  • For scheduled flows, verify your timezone is correct in Settings. A wrong timezone means the flow fires at the wrong time.
  • Check the execution logs for error messages. Open the flow editor and look at the log panel for details on what went wrong.

Screenshot placeholder

AI Not Working​

  • Verify your API key in Settings > AI Provider. Make sure it's entered correctly with no extra spaces.
  • Check that your provider account has credits or balance. Many providers require prepaid credits.
  • Try selecting a different model. Some models may be temporarily unavailable.
  • Check the execution logs for specific error messages — they usually include the exact error from the AI provider.

Scheduled Flow Fires at Wrong Time​

Check your timezone in Settings > Timezone. The time you set in a schedule trigger is interpreted in your configured timezone. If the timezone is wrong, the flow will fire at the wrong time.

For example, if you schedule a flow for 9:00 AM but your timezone is set incorrectly, it could fire hours early or late.

"No Contacts Matched" in Execution​

This usually happens with schedule triggers that use date fields:

  • Make sure dates in your contact table are in DD-MM-YYYY format.
  • For anniversary mode (e.g., birthday reminders), only the day and month matter — the year is ignored.
  • If you see a date/time format warning, click "Fix All" to automatically convert dates to the correct format.

Campaign Paused Automatically​

Campaigns have a failure threshold setting. If too many messages fail (e.g., more than 10%), the campaign automatically pauses to protect your WhatsApp account from being restricted.

Check the campaign's error details to see why messages are failing, fix the issue, and then resume the campaign.

App Won't Start or Crashes​

Try deleting the app data folder and reinstalling. This resets all local data:

OSData Folder
Windows%APPDATA%/replywolf
macOS~/Library/Application Support/replywolf
Linux~/.config/replywolf

Warning: Deleting the data folder removes all your accounts, messages, contacts, flows, and settings.

Factory Reset​

As a last resort, you can do a full factory reset from Settings > Danger Zone > Factory Reset. This deletes ALL data — accounts, messages, contacts, flows, and settings — and returns the app to its original state. Only use this if nothing else works.