Інтеграції

Telegram-бот

Telegram-бот — це повноцінний канал замовлень для вашої студії. Клієнт надсилає .STL або .3MF файл прямо в чат, бот автоматично нарізає модель, розраховує ціну і проводить клієнта через усі кроки оформлення: матеріал, якість, доставка, контактні дані. Готове замовлення з'являється у Placraftic так само, як і оформлене через вебсайт.

Для підключення потрібен токен бота — унікальний ключ, який Telegram видає при створенні нового бота через @BotFather.

Крок 1. Створіть бота у @BotFather#

  1. 1

    Відкрийте Telegram і знайдіть бота @BotFather (офіційний, з синьою галочкою).

  2. 2

    Надішліть команду /newbot і дотримуйтесь інструкцій:

  3. 3
    • Введіть ім'я бота — публічна назва, що бачать клієнти (наприклад: Alpha Print)
    • Введіть username бота — унікальний ідентифікатор, повинен закінчуватись на bot (наприклад: alphaprint_bot)
  4. 4

    Після успішного створення @BotFather поверне токен у форматі:

  5. 5
    123456789:AABBCCDDEEFFaabbccddeeff-1234567890
  6. 6

    Скопіюйте токен — він знадобиться на наступному кроці.

Зберігайте токен у безпечному місці й нікому не передавайте. Той, хто має токен, має повний контроль над ботом. Якщо токен потрапив до чужих рук — відкличте його у @BotFather командою /revoke і підключіть новий.

Крок 2. Підключіть бота у Placraftic#

  1. 1

    Перейдіть до Налаштування → Студія у бічному меню.

  2. 2

    Відкрийте вкладку Telegram.

  3. 3

    Вставте скопійований токен у поле «Токен бота».

  4. 4

    Натисніть «Підключити бота». Якщо токен коректний — статус одразу зміниться на «Підключено» із зеленою позначкою.

Після підключення бот одразу починає приймати повідомлення. Надішліть /start у ваш бот і переконайтесь, що він відповідає.

Кожна студія підключає власного окремого бота. Якщо у вас кілька студій — для кожної потрібно створити окремий бот у @BotFather і ввести окремий токен.

Як клієнти оформлюють замовлення#

Після підключення клієнти можуть знайти вашого бота за username і почати замовлення прямо в Telegram. Ніякої реєстрації не потрібно — бот веде клієнта крок за кроком.

Кроки замовлення з боку клієнта#

  1. 1

    Клієнт надсилає «/start» або одразу завантажує .STL чи .3MF файл (до 20 МБ).

  2. 2

    Бот запитує технологію друку (наприклад: FDM або SLA) — клієнт обирає з кнопок.

  3. 3

    Клієнт обирає матеріал, якість друку та послуги постобробки (якщо є).

  4. 4

    Клієнт вказує кількість копій.

  5. 5

    Бот нарізає модель і повертає розрахунок вартості з розбивкою по позиціях. Клієнт може:

  6. 6
    • Додати ще один файл до того ж замовлення
    • Перейти до оформлення
  7. 7

    Клієнт обирає метод доставки — Нова Пошта (до відділення або кур'єром) або самовивіз. Для Нової Пошти бот запитує місто і відділення.

  8. 8

    Клієнт вводить контактні дані: ім'я, прізвище, номер телефону, email.

  9. 9

    Бот показує підсумок замовлення з усіма позиціями та ціною. Клієнт підтверджує — замовлення створюється.

Після підтвердження замовлення з'являється у Placraftic зі статусом «Нове» — так само, як і будь-яке інше замовлення студії.

Команди бота#

КомандаДія
/startПочати нове замовлення. Скидає стан розмови і пропонує завантажити файл
/restartСкасувати поточний сценарій і почати заново

Якщо клієнт надсилає файл без /start — бот автоматично починає новий сеанс. Але якщо клієнт застряг на якомусь кроці — /restart скидає стан і дозволяє почати з початку.

Підтримувані формати файлів#

ФорматРозширенняМакс. розмір
STL (ASCII і Binary).stl20 МБ
3MF.3mf20 МБ

Ліміт у 20 МБ встановлений Telegram і не залежить від Placraftic. Для великих файлів рекомендуйте клієнтам конвертувати модель у бінарний STL або 3MF — вони значно компактніші за ASCII STL.

Відключення бота#

Щоб відключити бота від студії:

  1. 1

    Перейдіть до Налаштування → Студія → Telegram.

  2. 2

    Натисніть «Відключити бота».

Після відключення бот перестає відповідати на нові повідомлення. Вже створені замовлення залишаються в Placraftic без змін. Повторне підключення можливе в будь-який момент з тим самим або новим токеном.

Якщо ви відкликали токен у @BotFather — спочатку відключіть бота у Placraftic, а потім отримайте новий токен і підключіть знову. Відкликання токена без відключення в Placraftic залишить інтеграцію в неробочому стані.

Часті питання#

Клієнт пише у бот, але немає відповіді#

Перевірте, що:

  • На сторінці Налаштування → Студія → Telegram відображається статус «Підключено»
  • Токен бота не був відкликаний у @BotFather
  • У каталозі студії є хоча б одна активна технологія та матеріал

Бот не розраховує ціну — «У студії ще немає налаштованих технологій»#

Заповніть каталог: додайте технологію, матеріал і профіль якості. Без цього бот не зможе показати варіанти та розрахувати вартість. Докладніше — у розділі Каталог.

Ціна розраховується, але замовлення не створюється при підтвердженні#

Перевірте, що в замовленні правильно введений номер телефону клієнта: бот приймає українські номери у форматах 0671234567, +380671234567 або 380671234567. Номери у форматах інших країн також підтримуються, якщо вони починаються з + і коду країни.

Чи можна змінити ім'я або username бота?#

Так — через @BotFather командами /setname (публічна назва) і /setusername (username). Токен при цьому не змінюється, тож переналаштування у Placraftic не потрібне.

Пов'язані розділи#