tuk-tuk.online открывает три точки интеграции. REST API v1: ваш сервер сам вызывает платформу и отправляет сообщения. Коды подтверждения: один POST-запрос, и клиент получает код по SMS или Email. Event Webhooks: платформа сама присылает HTTP-уведомления о событиях на ваш сервер.
#Что выбрать
| Задача | Инструмент | Страница |
|---|---|---|
| Отправить сообщение клиенту, прочитать историю, получить контакт или медиа | REST API v1 | REST API v1 |
| Отправить клиенту код подтверждения по SMS или Email | Вебхук верификации | Коды подтверждения |
| Узнавать о новых сообщениях, статусах диалогов, платежах в реальном времени | Event Webhooks | Event Webhooks |
| Подключить платформу к нейросети: MCP-сервер, манифест возможностей, отложенные действия | MCP и API для агентов | Для нейросетей и MCP |
| Найти нужный адрес среди всех эндпоинтов | Справочник | Справочник эндпоинтов |
| Узнать, какие инструменты увидит нейросеть и с какими параметрами | Справочник MCP | Инструменты MCP |
| Повторить готовый сценарий целиком: ответ клиенту, рассылка, подписка на входящие | Сценарии | Сценарии для агента |
#REST API v1
| Параметр | Значение |
|---|---|
| Базовый URL | https://back.tuk-tuk.online/api/v1 |
| Протокол | REST (HTTP), формат JSON |
| Авторизация | API-ключ в заголовке Authorization: Bearer или X-Api-Key |
| Права | scopes: чтение мессенджеров, контактов, сообщений, медиа; отправка |
| Управление ключами | Личный кабинет → Настройки → API |
Что умеет:
- список привязанных мессенджеров;
- карточка контакта по ID, поиск по телефону или email;
- история сообщений с контактом;
- ссылки на медиа (картинки, голосовые, файлы);
- отправка текста, голосовых, медиа и email по ID контакта, номеру телефона или email.
Все эндпоинты с примерами на JavaScript, PHP и Python: REST API v1.
#Для нейросетей
Платформу можно подключить к ИИ-агенту как готовую инфраструктуру: подключения к мессенджерам, доставка, отложенные действия и память о переписке остаются на нашей стороне. Есть MCP-сервер @tuktuk/mcp, манифест возможностей GET /api/v1/manifest и спецификация OpenAPI.
Подробности: Для нейросетей и MCP.
#Коды подтверждения
Один POST-запрос на персональный вебхук, и клиент получает код верификации по SMS или Email. Можно прислать свой текст сообщения (в том числе HTML-письмо) с плейсхолдером {{code}}.
Подробнее: Коды подтверждения.
#Event Webhooks
- 50 типов событий: сообщения, диалоги, каналы, AI, цепочки, платежи, интеграции, файлы и другие.
- Каждый запрос подписан HMAC-SHA256.
- Вебхуки создаются в Настройках проекта.
- После 50 последовательных ошибок доставки вебхук отключается автоматически.
Заголовки, формат тела, проверка подписи и полный список событий: Event Webhooks.