Лимиты и ошибки

Обновлено 7 сентября 2026 г.

Лимит — 120 запросов в минуту на ключ. Этого хватает на синхронизацию даже крупных аккаунтов, если не опрашивать список диалогов чаще пары раз в минуту и использовать вебхуки для событий.

Заголовки лимитов

Ответные заголовки

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1757232360

При превышении лимита API отвечает 429 с заголовком Retry-After — количество секунд до следующего разрешённого запроса.

Формат ошибок

Пример ошибки

{"error": {"code": "rate_limited", "message": "Retry after 30s"}}

HTTP	Код	Причина
400	bad_request	Невалидные параметры или тело запроса
401	unauthorized	Ключ отсутствует, отозван или неверен
403	forbidden	Тариф без доступа к API или чужая компания
404	not_found	Диалог, контакт или вебхук не найден
409	conflict	Вебхук с таким URL уже существует
429	rate_limited	Превышен лимит запросов, см. Retry-After
500	internal	Ошибка на нашей стороне — повторите с паузой

Для повторов используйте экспоненциальную паузу: 1 с, 2 с, 4 с. Для 429 всегда ждите Retry-After — это быстрее, чем угадывать.

← Вебхуки →OpenAPI