Developer Platform v1

Whisper Bot API

Создавайте ботов для автоматизации: ответы, уведомления, интеграции с CRM и AI. API совместим по духу с Telegram Bot API — быстрый старт для разработчиков.

1. Создайте бота

В приложении WhisperChat: Настройки → Разработчикам → Создать бота. Вы получите токен whbot_....

2. Подключите webhook или polling

Для production — setWebhook. Для разработки — getUpdates с long polling.

3. Отправляйте сообщения

sendMessage с chat_id пользователя (ID из входящего update).

Базовый URL

POST https://whisper-chat-api.ru/api/v1/bot/{TOKEN}/{method}

Методы

getMe — информация о боте
getUpdates — long polling (offset, limit, timeout)
sendMessage — отправка текста (chat_id, text)
setWebhook — URL + secret_token
deleteWebhook — отключить webhook
getWebhookInfo — статус webhook

Пример: sendMessage

curl -X POST "https://whisper-chat-api.ru/api/v1/bot/whbot_YOUR_TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":"USER_ID_FROM_UPDATE","text":"Привет из Whisper Bot!"}'

Webhook

Whisper отправляет POST на ваш URL с JSON update. Заголовки:

X-Whisper-Bot-Secret — ваш secret
X-Whisper-Bot-Signature — SHA256(secret:body)

Примеры скриптов

Репозиторий: developers/examples/python_bot.py, node_bot.js — echo-боты на long polling.

Безопасность

Токен бота = полный доступ к отправке от имени бота. Храните в секретах, не коммитьте в git.
Лимит: 10 активных ботов на аккаунт.
Личные чаты пользователей остаются E2E — боты работают в диалоге с ботом (не E2E).
Контент проходит модерацию Whisper.

Скачать WhisperChat