FAQ

Где взять SDK?

Python пакет доступен в PyPI (pip install botads-sdk). Исходники и примеры лежат в sdks/python (репозиторий: https://gitlab.com/botads/sdks/python). JS/Go версии в разработке — следите за обновлениями в разделе SDK.

Как проверить подпись вебхука?

Все события подписываются HMAC SHA-256 (X-Signature в формате sha256=<hex>). В Python SDK используйте botads.verify_signature(body, signature, api_token) и затем parse_webhook_payload(body). Передавайте заголовок целиком (sha256=...), как получаете его от сервера.

Как протестировать интеграцию?

  1. Вызовите POST /client/v1/codes (или метод SDK create_code).

  2. Симулируйте переход пользователя по выдаваемому direct_link — платформа отправит вебхук.

  3. Сверьте user_tg_id и подпись, обработайте событие в своей системе.

Что делать при ошибке FORBIDDEN?

Код возвращается, если bot_id не совпадает с api_token. Убедитесь, что в запросе верные значения. При повторяющихся ошибках напишите в поддержку: t.me/BotAdsTechSupport.

Что делать при ошибке BOT_NOT_FOUND?

Бот не зарегистрирован или выключен. Проверьте, что бот активирован на стороне central API/аккаунта. При необходимости обратитесь в поддержку.

ПредыдущаяОшибки и лимиты

Последнее обновление