bot.ru.net

API bot.ru.net: чат на сайте, демо-боты, вебхуки

Открытый API на api.bot.ru.net: встройте бота в свой сайт или приложение, создавайте демо-ботов из своей CRM.

Всё, что умеет бот, можно подключить из вашего кода. Адрес API — https://api.bot.ru.net, интерактивная документация со всеми запросами и схемами — api.bot.ru.net/api-docs.

💬 Чат на вашем сайте или в приложении

Самый простой способ — готовый виджет: в кабинете откройте Каналы → Чат на сайте и вставьте код на сайт:

<script src="https://api.bot.ru.net/widget.js" data-channel="ID-КАНАЛА" async></script>

Нужен свой интерфейс (мобильное приложение, мини-приложение, встроенный чат)? Используйте запросы напрямую, ID-КАНАЛА берётся в кабинете. Разрешённые сайты задаются там же — чужие сайты получат 403.

  • POST /api/web/{ID-КАНАЛА}/send — отправить сообщение: {"session": "…", "mid": "уникальный-id", "text": "Здравствуйте"} (payload — нажатая кнопка, start: true — приветствие). Ответ {"ok": true}.
  • GET /api/web/{ID-КАНАЛА}/poll?session=…&after=0 — забрать ответы бота; в after передавайте номер последнего полученного.
  • GET /api/web/{ID-КАНАЛА}/info — название бота для шапки чата.
  • session — любая случайная строка 8–64 символов (сохраните у посетителя, чтобы диалог продолжался).

Лимиты: 20 сообщений в минуту на посетителя; повтор того же mid не создаёт дубль.

🤝 Партнёрский API: демо-боты из вашей CRM

Студиям, агентствам и сервисам лидогенерации: бот под сайт клиента создаётся из вашей системы за минуты. Ключ выдаём по запросу в поддержке. Он передаётся в заголовке X-API-Key.

  • POST /api/partner/v1/demos — создать демо по сайту: {"url": "https://site.ru", "external_ref": "lead-42", "wishes": "акцент на запись"}. Повтор с тем же external_ref вернёт то же демо.
  • GET /api/partner/v1/demos/{id} — статус и ссылка на демо, замечания проверки качества.
  • POST /api/partner/v1/demos/{id}/promote — превратить демо в боевого клиента: {"email": "owner@site.ru", "plan": "start"}.
curl -X POST https://api.bot.ru.net/api/partner/v1/demos \
  -H "X-API-Key: ВАШ-КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"url":"https://site.ru","external_ref":"lead-42"}'

🔔 Вебхуки и n8n

Из бота в ваши системы — «действия» и n8n (см. Интеграции). Из ваших систем в бота — входящий вебхук в настройках бота: можно присылать заявки и события, чтобы бот написал клиенту первым.

💡 Подсказки на сайте и в приложении

Виджет-гайды из кабинета («Подсказки на сайте») тоже отдаются с этого адреса: https://api.bot.ru.net/tourwidget.js, готовая вставка — в редакторе.

Вопросы по API и ключи — в поддержку. Старый адрес bot.ru.net/api/… продолжает работать.