Telegram Mini App: рух даних

Що ми отримуємо від Telegram.

Чорнова редакція. Цей документ описує, які саме дані Nashé отримує від Telegram при відкритті нашого Mini App і при оформленні замовлення. Фінальну юридичну редакцію ми додамо до повноцінного запуску DTC через Telegram.

Що Telegram нам передає

Коли ти відкриваєш наш Mini App у Telegram, платформа автоматично надсилає нашому серверу пакет даних під назвою initData:

• user.id — твій числовий Telegram-ID (стабільний між сесіями).
• Опціонально: first_name, last_name, username — те, що видно у твоєму профілі Telegram. username з’являється тільки якщо ти його встановив; id присутній завжди.
• auth_date — Unix-таймстемп моменту відкриття; ми використовуємо його лише для перевірки актуальності initData (свіжість запиту, вікно — 24 години). Не зберігаємо поза життєвим циклом запиту.
• query_id — ідентифікатор сесії; не зберігається довгостроково.
• hash — підпис HMAC-SHA256, який ми перевіряємо.

Що Telegram нам НЕ передає

Через стандартний механізм WebApp ми не отримуємо від Telegram: твій номер телефону, email, GPS-локацію, список контактів, фото, вміст хмарного сховища. Якщо ти оформлюєш замовлення — ім’я, телефон і адресу доставки ти вводиш сам у формі чекауту (email на TG-частині не запитуємо).

Перевірка автентичності (HMAC)

На кожен POST-запит на наш сервер з Mini App ми перераховуємо HMAC-SHA256 підпис від твого initData з нашим bot-токеном. Якщо підпис не співпадає — запит відхиляється. Це підтверджує походження запиту (він дійсно надійшов з Telegram, а не від зовнішнього клієнта). HMAC — це підпис автентичності, а не шифрування: дані всередині initData залишаються відкритими у самому HTTP-запиті, але їх не можна змінити чи підробити без нашого bot-токена.

Куди йдуть дані при замовленні

Перевірені initData-поля + дані, які ти вводиш у чекауті (ім’я, телефон, адреса доставки Нової Пошти, склад замовлення, опціональні нотатки) → менеджеру у приватну Telegram-групу через нашого бота → опційно лист з підтвердженням на email через Mailgun EU (якщо email був вказаний у іншому каналі замовлення). Жодних інших отримувачів. Платіжні дані через цей шлях не проходять — оплата живе в окремому процесі поза цим документом.

Які дозволи Telegram ми не запитуємо

Ми НЕ викликаємо API getContact, requestPhoneNumber, гео-локацію чи будь-які додаткові дозволи Telegram. Стандартний WebApp-handshake — і нічого більше. Mini App — у власному каналі/групі власника, тобі НЕ потрібно бути учасником жодної групи, щоб ним користуватись.

Скільки зберігаємо

Записи замовлень — 36 місяців (українське комерційне право). Логи серверу — до 30 днів (ротація Docker compose). Деталі — в Політиці конфіденційності.

Як відмовитись

Заблокуй нашого бота в Telegram — більше не отримуватимеш від нас повідомлень. Існуючі записи замовлень залишаються в межах термінів зберігання. Запит на видалення даних — на пошту [email protected] (твої права описані в Політиці конфіденційності).

Контакти

Питання щодо Telegram-частини — на пошту [email protected]. Загальні умови — в Умовах використання.