---
title: "API tuk-tuk.online: REST API v1, коды подтверждения, Event Webhooks"
nav_title: "API для разработчиков"
url: https://docs.tuk-tuk.online/api
markdown: https://docs.tuk-tuk.online/api.md
description: "Три способа интеграции с tuk-tuk.online: REST API v1 с авторизацией по API-ключу (мессенджеры, контакты, история, медиа, отправка сообщений), вебхук для отправки кодов подтверждения по SMS и Email, Event Webhooks с подписью HMAC-SHA256."
keywords: ["API мессенджер", "REST API", "API-ключ", "отправка сообщений API", "Event Webhooks", "webhook события", "HMAC подпись", "API для разработчиков", "интеграция мессенджеров", "send message API"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Обзор способов интеграции с tuk-tuk.online для разработчиков: REST API v1 (ваш сервер вызывает платформу), вебхук кодов подтверждения (отправка кода по SMS или Email одним POST) и Event Webhooks (платформа присылает события на ваш сервер).
>
> - REST API v1: базовый URL `https://back.tuk-tuk.online/api/v1`, JSON, авторизация API-ключом в заголовке `Authorization: Bearer` или `X-Api-Key`.
> - API-ключи создаются в кабинете: Настройки проекта → API. Права задаются через scopes.
> - Коды подтверждения: POST на персональный вебхук, код уходит по SMS или Email, в тексте плейсхолдер `{{code}}`.
> - Event Webhooks: 50 типов событий, подпись HMAC-SHA256, настройка в Настройках проекта.
> - Вебхук отключается автоматически после 50 последовательных ошибок доставки.
> - Для ИИ-агентов: MCP-сервер `npx -y https://docs.tuk-tuk.online/mcp/tuktuk-mcp.tgz`, манифест возможностей `GET /api/v1/manifest`, спецификация `GET /api/v1/openapi.json`.
> - Справочники: все эндпоинты в /api/reference, все инструменты MCP в /api/mcp-tools, готовые сценарии в /api/recipes.
>
> Связанные страницы: https://docs.tuk-tuk.online/api/rest, https://docs.tuk-tuk.online/api/reference, https://docs.tuk-tuk.online/api/recipes, https://docs.tuk-tuk.online/api/agents, https://docs.tuk-tuk.online/api/mcp-tools, https://docs.tuk-tuk.online/api/verification, https://docs.tuk-tuk.online/api/webhooks

# API для разработчиков

tuk-tuk.online открывает три точки интеграции. REST API v1: ваш сервер сам вызывает платформу и отправляет сообщения. Коды подтверждения: один POST-запрос, и клиент получает код по SMS или Email. Event Webhooks: платформа сама присылает HTTP-уведомления о событиях на ваш сервер.

## Что выбрать

| Задача | Инструмент | Страница |
|---|---|---|
| Отправить сообщение клиенту, прочитать историю, получить контакт или медиа | REST API v1 | [REST API v1](https://docs.tuk-tuk.online/api/rest) |
| Отправить клиенту код подтверждения по SMS или Email | Вебхук верификации | [Коды подтверждения](https://docs.tuk-tuk.online/api/verification) |
| Узнавать о новых сообщениях, статусах диалогов, платежах в реальном времени | Event Webhooks | [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks) |
| Подключить платформу к нейросети: MCP-сервер, манифест возможностей, отложенные действия | MCP и API для агентов | [Для нейросетей и MCP](https://docs.tuk-tuk.online/api/agents) |
| Найти нужный адрес среди всех эндпоинтов | Справочник | [Справочник эндпоинтов](https://docs.tuk-tuk.online/api/reference) |
| Узнать, какие инструменты увидит нейросеть и с какими параметрами | Справочник MCP | [Инструменты MCP](https://docs.tuk-tuk.online/api/mcp-tools) |
| Повторить готовый сценарий целиком: ответ клиенту, рассылка, подписка на входящие | Сценарии | [Сценарии для агента](https://docs.tuk-tuk.online/api/recipes) |

## 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](https://docs.tuk-tuk.online/api/rest).

## Для нейросетей

Платформу можно подключить к ИИ-агенту как готовую инфраструктуру: подключения к мессенджерам, доставка, отложенные действия и память о переписке остаются на нашей стороне. Есть MCP-сервер `@tuktuk/mcp`, манифест возможностей `GET /api/v1/manifest` и спецификация OpenAPI.

Подробности: [Для нейросетей и MCP](https://docs.tuk-tuk.online/api/agents).

## Коды подтверждения

Один POST-запрос на персональный вебхук, и клиент получает код верификации по SMS или Email. Можно прислать свой текст сообщения (в том числе HTML-письмо) с плейсхолдером `{{code}}`.

Подробнее: [Коды подтверждения](https://docs.tuk-tuk.online/api/verification).

![Вебхуки и ключи API](https://lk.tuk-tuk.online/help/settings-api.webm "Отдача событий во внешнюю систему и выпуск ключа с ограниченными правами.")

## Event Webhooks

- 50 типов событий: сообщения, диалоги, каналы, AI, цепочки, платежи, интеграции, файлы и другие.
- Каждый запрос подписан HMAC-SHA256.
- Вебхуки создаются в [Настройках проекта](https://lk.tuk-tuk.online/settings).
- После 50 последовательных ошибок доставки вебхук отключается автоматически.

Заголовки, формат тела, проверка подписи и полный список событий: [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks).