Ошибки и лимиты

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

Любой ответ не из диапазона 2xx несёт тело ApiError:

{
  "code": "ERROR_CODE_FORBIDDEN",
  "message": "not available for bots",
  "field": "",
  "reason": "BOT_NOT_ALLOWED"
}

Полный список кодов — Коды ошибок.

Частые ошибки ботов#

Лимиты#

Запросов в секунду и сообщений в минуту хватает для интеграций, но не для массовых рассылок. На своём сервере оператор может поменять лимиты бота переменными BOT_RATE_PER_SEC и BOT_MESSAGES_PER_MIN. Все лимиты — Лимиты.

Повторы и идемпотентность#

• 429 — ждите Retry-After секунд и повторяйте. SDK делает это сам до maxRetries раз.
• 5xx и обрывы сети — повторяйте с экспоненциальной задержкой.
• Сообщения отправляйте с nonce: повтор с тем же nonce вернёт уже созданное сообщение (200) вместо дубля.
• Формы отправляйте с постоянным UUID-nonce: одинаковые отправки создают одну задачу.
• События (gateway, вебхук) могут прийти повторно — дедуплицируйте по id доставки, seq или id нажатия.
• 4xx кроме 429 не повторяйте без изменения запроса.

async function call(url, init, tries = 5) {
  for (let i = 0; ; i++) {
    const res = await fetch(url, init);
    if (res.status !== 429 && res.status < 500) return res;
    if (i === tries - 1) return res;
    const wait = Number(res.headers.get('Retry-After')) || 2 ** i;
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
}

import time, requests

def call(method, url, tries=5, **kw):
    for i in range(tries):
        r = requests.request(method, url, **kw)
        if r.status_code != 429 and r.status_code < 500 or i == tries - 1:
            return r
        time.sleep(float(r.headers.get("Retry-After", 2 ** i)))

Частые вопросы#

Бот не видит комнату или сообщения. Нет VIEW_ROOM: комната приватная, закрытая (только через переопределение на ней) или роль бота не даёт доступа. Проверьте роли и переопределения комнаты.

Бот не отвечает на /cmd. Команду никто не зарегистрировал, или её зарегистрировали несколько ботов комнаты — пишите /cmd@username. Сообщения ботов командами не бывают.

Нужен ли gateway, если есть вебхук? Нет. Бот на вебхуке работает через REST и вебхук и считается в сети, пока делает запросы. Но события голоса приходят только через gateway.

Два процесса с одним токеном? Нельзя — второй вытесняет первый. Для масштабирования — вебхук с обработкой по id или несколько ботов.

Слышит ли бот себя в звонке? Нет: LiveKit не отправляет участнику его собственные дорожки. SDK по умолчанию пропускает собственные сообщения и реакции бота (receiveOwn: true включает их).