Setup першого tenant

Цей walkthrough проведе вас від свіжої реєстрації до першого welcome bonus journey приблизно за 15 хвилин.

1. Реєстрація + створення tenant

Перейдіть на app.casinocrm.io/sign-up. Auth обробляє Clerk — виберіть назву workspace; вона стане вашим tenant.

2. Конфігурація вашого tenant

Перейдіть до Settings → Tenant configuration. Три речі для встановлення:

Поле	Що робить
License jurisdiction	Авто-пропонує verticals + KYC model + RG features для вашої ліцензії. Виберіть найближчу до вашої; перевизначте нижче.
Verticals	Які продукти ви запускаєте — casino, sportsbook, lottery, poker, esports, virtual_sports, bingo. Вимкнені verticals приховують їхні reports + segments + journeys з UI.
KYC model	platform_owns (ваша платформа обробляє KYC, CRM mirroруje webhooks) / crm_owns (CRM ініціює, платформа слухає) / dual (mixed по KYC level) / none (KYC не tracking).

Натисніть Save configuration — capabilities cache invalidates у секунди.

3. Налаштування першого проекту

Проект — це логічне середовище в межах tenant (production / staging / dev). Кожен API виклик несе ключ API проекту. Більшість операторів запускають один проект; multi-project має сенс, коли потрібна сувора відокремленість staging від production.

Перейдіть до Settings → Projects → Create project. Запишіть API key — він знадобиться у кроці 5.

4. Додайте messaging provider

Перейдіть до Providers → Add provider. Виберіть channel + provider:

• Email → Postmark (server token + from address)
• SMS → Twilio (Account SID + Auth Token + from number or Messaging Service SID)
• Push → FCM (project_id + service-account JSON)
• Telegram → Grammy (bot token)

Save. Credentials шифруються at rest з project key.

5. Надішліть першу подію

Замініть YOUR_API_KEY ключем проекту з кроку 3.

curl -X POST https://api.casinocrm.io/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "signup",
    "external_id": "demo_player_001",
    "anonymous_id": "anon_abc",
    "timestamp": "2026-05-08T10:00:00Z",
    "properties": {}
  }'

Ви маєте побачити {"data":{"ingestion_id":"..."}}.

Подія потрапляє у ClickHouse + гравець upserted у Postgres. Відкрийте Players в адмінці — побачите його за ~5 секунд.

6. Ідентифікуйте гравця

Скажіть UCRM "цей anonymous_id насправді player+demo01@example.com":

curl -X POST https://api.casinocrm.io/v1/players/identify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "demo_player_001",
    "anonymous_id": "anon_abc",
    "traits": {
      "email": "player+demo01@example.com",
      "phone": "+15551234567"
    }
  }'

Тепер у гравця є email + phone + він може отримувати кампанії.

7. Створіть перший сегмент

Перейдіть до Segments → New segment → назвіть "All players" → залишіть умову порожньою (matches everyone) → Save. UCRM матеріалізує membership; GIN index на players.segment_ids[] робить campaign fan-out швидким навіть на 1M-player tenant.

8. Складіть свій перший шаблон

Перейдіть до Templates → New template → виберіть channel email, вставте:

<p>Welcome, {{first_name | default: "player"}}!</p>
<p>Ось ваш free spin code: <strong>WELCOME10</strong></p>

Змінні в {{double-curlies}} відображаються через Mustache відносно traits гравця.

9. Побудуйте свій перший journey

Перейдіть до Journeys → New journey → trigger signup → drop wait 24h node → drop send_message (виберіть свій template + provider) → connect to end.

Натисніть Activate — UCRM слухає signup події на цьому проекті; кожен новий signup проходить graph.

10. Перевірте у роботі

Trigger ще один signup event для demo_player_002. У секунди ви побачите:

• Новий player row у Players list
• Journey run починається у Journeys → Runs
• Через 24 години wait, email надсилається; Campaigns → Recipients показує delivery status

Ви в робочому стані. Наступні кроки:

• Bonus engine — видавайте match бонуси з wagering правилами.
• VIP tiers — авто-просувайте whales до Gold.
• Adapter integration — підключіть webhooks вашої казино-платформи.