Troubleshooting

401 / 403 API Auth Errors

• Validate the customer API key from /api-keys.
• Use Authorization: Bearer YOUR_API_KEY.
• Retest with this command:

Dashboard > API Keys > Create or rotate key

404 Route Not Found

• Verify you are calling the documented WhatsApp Gateway route.
• Check that your account and instance IDs match the customer dashboard.
• Check web server routing for unwanted path prefixes or rewrites.
• Confirm you are hitting https://evoapi.faisak.com and not stale DNS.

500 + DB Access Denied (1045)

• Symptom: SQLSTATE[HY000] [1045] Access denied for user ...
• Fix DB credentials in app env/config for MySQL user, password, and database.
• Verify MySQL grants include host localhost and required schema rights.
• Restart PHP-FPM / Apache worker after credential updates.

registration_enabled Fallback Log

• Symptom: registration_enabled fallback used appears in error log.
• This means settings DB read failed and fallback path was activated.
• Resolve database availability first, then confirm registration toggle in CMS.
• After DB is healthy, reload /login and /register.

Send Works But No Webhooks

• Verify webhook settings in the customer portal instance manager.
• Confirm receiver endpoint is public and returns HTTP 200 quickly.
• Confirm subscribed events include message.received and message.status_updated.
• Inspect TLS chain and firewall rules on receiver domain.

Connection Never Reaches Open

• Request a fresh QR from the customer portal instance manager.
• Logout stale sessions then reconnect.
• Try restart endpoint before requesting new QR.
• Check WhatsApp account session limits or device-side restrictions.