Troubleshooting & Error Diagnostics

Raw MD
Common errors, how to read error.log, and fixing webhook handshake issues.
4 min read Botlify Cloud Updated October 2026

1. The Bot Does Not Respond to /start

If your bot is not replying to messages, check these 3 common causes:

  • Check Webhook Status: Ensure the status badge in Bot Studio displays ACTIVE. If paused, click Re-Sync Webhook.
  • Syntax Errors: Check Error Logs in Bot Studio. A missing semicolon or typo in PHP will cause an immediate fatal error.
  • Run Webhook Simulator: Click Simulate /start in Bot Studio to see the exact PHP output and stack trace.

2. Telegram cURL Timeouts

Always keep Telegram API cURL timeouts reasonable (10–15 seconds). Never execute heavy blocking operations (like large external web scrapes) synchronously inside the webhook handler; instead, delegate them to background cron jobs.

3. Official Support

Need personalized help from the Botlify engineering team? Reach us via: