Rabt WhatsApp CRM

Troubleshooting

Connection Issues

This guide helps you resolve the most common WhatsApp connection issues on RabtCRM.


Problem 1 β€” Instance Shows "Disconnected" πŸ”΄

Likely causes:

  • Your phone was turned off or lost internet
  • Your WhatsApp session expired
  • You logged out of WhatsApp on your phone

Solution:

  1. Go to Instances in the left sidebar

Instances page

  1. Click the disconnected instance
  2. Click Reconnect or Re-scan QR Code
  3. On your phone: WhatsApp β†’ Linked Devices β†’ Link a Device β†’ scan the code

Problem 2 β€” QR Code Not Working

Causes:

  • The QR code expired (refreshes every 30 seconds)
  • Phone is too far from the screen

Solution:

  • Click the Refresh button under the QR code to get a new one
  • Scan immediately after it appears before it expires

Problem 3 β€” Customer Messages Not Appearing

Messages from customers aren't showing in conversations?

Check the following:

StepWhat to Verify
1Is the instance status 🟒 Connected?
2Does your phone have internet?
3Is WhatsApp open on more than one device?
4Is there a pending WhatsApp update on the phone?

Problem 4 β€” Connection Keeps Dropping

Common causes:

  • Phone enters battery saver mode and cuts WhatsApp's internet access
  • Unstable mobile internet connection

Solutions:

  • Disable battery optimisation for WhatsApp in your phone's settings
  • Consider a WhatsApp Business API plan for a more stable connection β€” contact our support team

Problem 5 β€” "Session not found" Error

Appears when trying to send from a deleted instance.

Solution:

  • Create a new instance and re-link it
  • Make sure the instance name used in your API calls or flows is correct

Problem 6 β€” Can't Log In to the Platform

CauseSolution
Forgot passwordClick "Forgot password" on the sign-in page
Wrong emailContact your account manager
Account suspendedContact the platform administrator

When to Contact Support

Reach out if:

  • The connection stays broken after multiple re-scan attempts
  • You see a 500 error or "Server Error" message
  • Messages are sent but customers aren't receiving them

Support channels:


Next Step

← Message Failure Causes