Skip to main content
Errors return a stable JSON shape:

Plan restrictions

A valid, correctly signed request can still return 403 when a feature is unavailable on the company’s current plan.

State conflicts

Ticket mutations can return 409 if another request changes the chat or ticket while the operation is being processed. Refresh the ticket state before deciding whether to retry.

Embed sending restrictions

The iframe can prevent sending when a channel is disconnected, an account has sending restrictions or a cooldown, file storage is unavailable, or an attachment exceeds the channel’s limits. Capabilities grant access to an action; they do not guarantee that the action can complete in the channel’s current state. A send with an unresolved outcome is not a confirmed delivery failure. Avoid sending the same message again while its outcome remains unknown. See Telegram Account and attachment limits.