TukTuk для нейросетей

Нейросеть умеет думать, писать текст и принимать решения. Она не умеет держать соединение с Telegram неделями, пережить собственный перезапуск, дождаться завтрашнего утра и гарантировать доставку сообщения.

TukTuk берёт это на себя. Агенту остаётся один секрет, ключ TukTuk, вместо своего сервера, токенов площадок и очереди задач.

#Что мы держим вместо агента

#Быстрый старт за четыре шага

1. Зарегистрируйтесь: https://lk.tuk-tuk.online/register. Есть бесплатный тариф.
2. Подключите канал в разделе «Каналы связи»: Telegram-бот, чат-виджет, Email, SMS-шлюз.
3. Выпустите ключ: Настройки проекта, вкладка API, «Создать ключ». Формат tuk_sk_..., показывается один раз.
4. Проверьте доступ:

curl https://back.tuk-tuk.online/api/v1/me -H "Authorization: Bearer $TUKTUK_API_KEY"

#MCP-сервер

Для клиентов с поддержкой Model Context Protocol (Claude Code, Claude Desktop, Cursor и другие) есть готовый сервер.

claude mcp add tuktuk --env TUKTUK_API_KEY=tuk_sk_... -- npx -y https://docs.tuk-tuk.online/mcp/tuktuk-mcp.tgz

Или в конфигурации клиента:

{
  "mcpServers": {
    "tuktuk": {
      "command": "npx",
      "args": ["-y", "https://docs.tuk-tuk.online/mcp/tuktuk-mcp.tgz"],
      "env": { "TUKTUK_API_KEY": "tuk_sk_..." }
    }
  }
}

Инструменты показываются по правам ключа: read-only ключ не увидит отправку. Без ключа сервер стартует и показывает один инструмент с инструкцией, как ключ получить.

Все инструменты с параметрами: Инструменты MCP. Что лежит в тарболе и какой он версии, показывает version.json.

#Манифест возможностей

Первый вызов, который стоит сделать агенту. Он отвечает, что доступно именно этому ключу, и избавляет от угадывания.

curl https://back.tuk-tuk.online/api/v1/manifest -H "Authorization: Bearer $TUKTUK_API_KEY"

В ответе: список ресурсов, каждый эндпоинт с нужным правом и признаком available, соглашения по формату ответа и ошибкам, ссылки на документацию, команда установки MCP и перечень того, чего в API нет намеренно.

Полная спецификация: GET https://back.tuk-tuk.online/api/v1/openapi.json в формате OpenAPI 3.1.

#Что агент может делать

Все эндпоинты с примерами: REST API v1.

#Отложенное действие

Главный сценарий для агента: поставить сообщение и завершиться. Момент отправки держит платформа.

curl -X POST https://back.tuk-tuk.online/api/v1/messages/schedule \
  -H "Authorization: Bearer $TUKTUK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dialogId":"f1e2...","text":"Напоминаю о встрече","sendAt":"2026-09-10T06:00:00Z"}'

Время указывается в ISO-8601, минимум на 30 секунд вперёд. Список отложенных: GET /messages/scheduled. Отмена до отправки: DELETE /messages/scheduled/{id}.

#Правила, которые берегут деньги пользователя

• Перед массовой отправкой считайте аудиторию через POST /broadcasts/preview. Отправка платная, ошибка в фильтре стоит денег.
• Проверяйте GET /account: при canSend: false отправка не пройдёт, там же указана причина.
• Если в аккаунте работает ИИ-ассистент, а переписку ведёте вы, заберите диалог: POST /assistants/pause-dialog с {"dialogId":"...","minutes":60}. Иначе клиент получит два ответа.
• При повторе запроса передавайте заголовок Idempotency-Key: повтор вернёт первый результат вместо второго сообщения.

#Справочники

#Машиночитаемая документация

Любая страница документации доступна как Markdown: тот же адрес плюс .md. Например, https://docs.tuk-tuk.online/api/rest.md.

#Границы

Через API нельзя выпускать и отзывать ключи, платить, менять тариф и управлять правами пользователей. Эти действия остаются за владельцем рабочего пространства в кабинете. Ключ видит только своё рабочее пространство: чужой идентификатор возвращает 404.

Модель прав, срок действия ключа, белый список IP и лимит запросов: REST API v1.