SoChatSoChat

Reference

Errors & troubleshooting

The status codes you will actually hit.

  • 401: token not sbot_, revoked, unapproved, or bot disabled
  • 409: getUpdates while webhook is active → call deleteWebhook first
  • 429: quota — read Retry-After, X-BotRateLimit-Remaining, X-BotRateLimit-Bot-Remaining
  • 503: bot missing system_user_id binding after approval
  • Webhook signature fails if JSON was parsed before verify, or if V1 body-only HMAC is used (platform ships V2: timestamp + "." + rawBody)
  • No group messages: check privacy mode and whether the message is a command / @mention / reply

Use console Delivery logs for failures and dead_letter retries.