Для разработчиков

API-first платформа с 290+ эндпоинтами

REST API, JWT-аутентификация, SDK для трекинга событий, вебхуки и Celery-задачи. Всё, чтобы встроить маркетинговую автоматизацию в ваш продукт за часы, а не месяцы.

Получить API-ключ Тарифы

Начните за 5 минут

1. Получите JWT-токен

curl -X POST https://api.trigly.ru/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dev@company.ru",
    "password": "your-password"
  }'

# Response:
# {
#   "access_token": "eyJhbGciOiJIUzI1NiIs...",
#   "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
#   "token_type": "bearer"
# }
# JWT payload: { sub, org_id, role, type, jti }

2. Отправьте событие через SDK

curl -X POST https://api.trigly.ru/api/v1/sdk/track \
  -H "X-API-Key: your-sdk-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_abc123",
    "event_type": "purchase",
    "event_name": "Оформление заказа",
    "properties": {
      "order_id": "ORD-5521",
      "amount": 4200,
      "items": ["SKU-101", "SKU-205"]
    },
    "revenue": 4200.00
  }'

3. Создайте и запустите кампанию

curl -X POST https://api.trigly.ru/api/v1/campaigns \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome-серия",
    "channel": "email",
    "campaign_type": "triggered",
    "segment_id": "seg_uuid",
    "template_id": "tpl_uuid",
    "subject": "Добро пожаловать, {{ first_name }}!"
  }'

# Запуск кампании:
# POST /api/v1/campaigns/{id}/launch

4. Получайте вебхуки о событиях

# Trigly отправляет POST на ваш URL с HMAC-SHA256 подписью:
# X-Trigly-Signature: sha256=a1b2c3...

{
  "event": "message.delivered",
  "campaign_id": "camp_uuid",
  "customer_id": "cust_abc123",
  "channel": "email",
  "timestamp": "2026-03-20T14:30:00Z"
}

Проблемы при самостоятельной разработке

Месяцы на разработку CDP

Построить CDP с сегментацией, RFM-анализом и 360° профилем клиента — это 6-12 месяцев разработки и 3+ инженера.

Сложность омниканальности

Интеграция с Email, SMS, Telegram, WhatsApp и Push — разные API, разные форматы, разная обработка ошибок.

Масштабирование очередей

Рассылка на 100K+ контактов требует очередей, батчинга, rate limiting и retry-логики. Это не тривиальная задача.

AI и ML-модели

Предиктивный скоринг, оптимизация времени отправки, AI-копирайтинг — каждая фича требует отдельной ML-инфраструктуры.

Полный API для маркетинговой автоматизации

290+ REST-эндпоинтов, покрывающих все аспекты маркетинга. Async Python, PostgreSQL, ClickHouse, Redis, Celery.

CDP API — 76 эндпоинтов

CRUD контактов, сегменты (статические и динамические), импорт/экспорт CSV, теги, RFM-анализ, merge дубликатов, bulk-операции, lifecycle, identity resolution.

Документация →

Campaigns API — 80 эндпоинтов

Кампании, шаблоны с Jinja2, Journey Builder (DAG), A/B-тесты, триггеры, tracking (pixel, click, unsubscribe), вебхуки с HMAC.

Документация →

SDK — публичные эндпоинты

Трекинг событий, batch-отправка, identify. Аутентификация по API-ключу (X-API-Key). Rate limit 1000 req/min. ClickHouse для хранения.

Документация →

AI API — 26 эндпоинтов

Генерация текстов (GPT-4o-mini), скоринг 0-100, K-Means сегментация, предсказание оттока/LTV, Bayesian A/B-тесты, рекомендации, embeddings.

Документация →

Channels API — 38 эндпоинтов

Конфигурация каналов (SMTP, Unisender, Telegram, SMS.ru, WhatsApp, WebPush), аналитика доставки, smart channel selection, бюджеты.

Документация →

Технический стек

Компонент	Технология	Назначение
API	FastAPI + Python 3.12	290+ async REST-эндпоинтов
ORM	SQLAlchemy 2.0 (async)	33 таблицы, миграции Alembic
OLTP	PostgreSQL 16	Метаданные, CRUD, связи
OLAP	ClickHouse	События, аналитика, heatmaps
Очереди	Celery 5 + Redis	Рассылки, ML-обучение, cron
AI/ML	OpenAI GPT-4o-mini + scikit-learn	Копирайтинг, скоринг, предсказания
Авторизация	JWT (access + refresh)	Мультитенантность, роли (owner/admin/member)
Каналы	6 адаптеров	Email, SMS, Telegram, WhatsApp, Push, Unisender

Протоколы и форматы

Стандартные протоколы для бесшовной интеграции

REST API

JSON

JWT (HS256)

HMAC-SHA256

WebSocket

SMTP

CSV/JSON Export

OpenAPI 3.0

Документация API →

Частые вопросы

Какой rate limit у API?

SDK-эндпоинты (/api/v1/sdk/*) — 1 000 запросов/минуту. Auth-эндпоинты — 200/мин. Остальные — 500/мин. Rate limiting реализован через Redis sliding window. Для увеличения лимитов свяжитесь с нами.

Как устроена аутентификация?

JWT с access + refresh токенами. Payload содержит sub (user_id), org_id, role и jti. Access-токен живёт 30 минут, refresh — 7 дней с автоматической ротацией. Публичные SDK-эндпоинты используют API-ключ (X-API-Key header).

Можно ли развернуть Trigly on-premise?

Да, Trigly поставляется как Docker Compose из 8 сервисов: app, PostgreSQL, ClickHouse, Redis, MinIO, Celery worker, Celery beat и Mailpit (для dev). Всё запускается одной командой docker compose up.

Готовы интегрировать маркетинг в свой продукт?

Получите API-ключ бесплатно — до 1 000 контактов и все 290+ эндпоинтов.

Получить API-ключ Документация