Термопринтери та етикетки стріму

Налаштуйте за 6 кроків

Перед початком: потрібен окремий застосунок Windows. Принтер має відображатися як звичайний принтер Windows. Social Stream друкує через драйвер Windows і не надсилає сирі команди ESC/POS, ZPL або SDK виробника.

Підключіть принтер через USB, увімкніть його й установіть драйвер Windows. Надрукуйте тестову сторінку Windows для перевірки.
У Social Stream відкрийте Загальні налаштування й інструменти → Механіка — З'єднання та інтеграції → Керування принтером.
Натисніть Знайти принтери. Виберіть принтер за назвою у Windows.
Уведіть Ширина паперу (мм). Зазвичай це 58, 80, або 62.
Залиште Фіксована довжина етикетки на 0 для чекового паперу. Для висічних етикеток уведіть довжину в мм за напрямком подавання паперу.
Натисніть Тестовий друк. Якщо край обрізано, збільште безпечний відступ із цього боку й перевірте знову.

Безпечні відступи по 2 мм ліворуч і праворуч підходять багатьом недорогим чековим принтерам 58 мм. Реальну область друку визначає драйвер, тож залиште Використовувати область друку (Use printable area) вибраним, якщо ви не перевірили інший варіант.

Друкуйте етикетку після пожертви

💰 Донат / чайовіМінімальна сума: 10

🖨️ Надрукувати термоетикетку

{username}
{donation}

24 пт · жирний · по центру

Відкрийте Редактор потоків подій і створіть новий потік.
Додайте Донат / чайові тригер. Установіть Мінімальна сума якщо друкувати потрібно лише великі пожертви.
Додайте Надрукувати термоетикетку (Print Thermal Label) (у розділі інтеграцій) і підключіть до нього тригер.
Введіть {username}, новий рядок, а потім {donation}. Виберіть розмір і товщину шрифту, вирівнювання й кількість копій.
Залиште перевизначення принтера й фіксованої довжини в дії порожніми або 0. Буде використано ваші налаштування Printer Control.
Натисніть Перевірити потік (Test Flow). Уведіть назву й увімкніть Містить донат (Has Donation), додайте суму й запустіть. Буде надруковано справжню етикетку.

Інші корисні підстановки: {message}, {source}, {donationAmount}, і {counterValue}. Значення, створені попередніми кроками потоку, також працюють.

Друкуйте продажі, подарунки й номери замовлень

Я хочу друкувати…	Що зробити
Продажі	Використовуйте Тип події з `purchase`. Донат / чайові потребує `hasDonation`тому пропускає більшість продажів.
Завершені подарунки	Використовуйте `gift` або `giftfunded`. За потреби відфільтруйте за постачальником.
Послідовний номер замовлення	Додайте Лічильник (Counter) перед дією друку.

Дивіться поля торгових подій для складу даних кожного продажу.

Покупця — жирним, товар — звичайним

Установіть Товщина до Виділений текст.
Уведіть цей текст етикетки:

**{username}**
{subtitle}

Лише текст усередині ** стає жирним. HTML і JavaScript не потрібні.
Використовуйте одинарні фігурні дужки. У продажах назва товару міститься в {subtitle}. Кількість може бути в {meta.commerce.quantity}.
Якщо попередній крок створює buyer, використовуйте **{buyer}** натомість.
Shopify та eBay не передають ім'я покупця. Використовуйте для них лічильник замовлень або етикетку лише з товаром.
Етикетки з налаштуванням «Усе жирним» або «Звичайний» зберігають вигляд.

Для авторів потоків: результати друку й номери покупців

Дія додає meta.thermalPrintResult.successа в разі збою — помилку або код для наступних кроків. Успіх означає надсилання завдання до Windows, а не вихід паперу. Перед повтором перевірте чергу друку Windows, інакше можливі дублікати етикеток.

Лічильник нумерує покупки, а не унікальних покупців. Щоб усі покупки однієї людини отримували однаковий номер, потрібен окремий список покупець–номер зі скиданням на початку кожного ефіру. Поле причини в User Memory — звичайний текст, а не лічильник номерів покупців.

Етикетки товарів Whatnot

Завантажити приклад потоку Whatnot. Друкує ім'я покупця жирним, назву товару й ID замовлення, якщо він є. У разі збою оплати друкує окрему ОПЛАТА НЕ ВДАЛАСЯ етикетку з тими відомостями, які є в сповіщенні.

В окремому застосунку налаштуйте Керування принтером (Printer Control) і виконайте тестовий друк.
Відкрийте Редактор потоків подій, натисніть Імпортуватиі виберіть завантажений файл.
Виберіть Whatnot: етикетки товарів + попередження про оплату. Перевірте обидві дії друку. Вони використовують принтер і довжину етикетки з Printer Control.
Увімкніть потік і збережіть. Після імпорту він вимкнений.
Залиште джерело Whatnot відкритим з увімкненим захопленням подій ефіру.

Етикетка продажу не означає оплату. Кожне сповіщення друкується після отримання. Потік не чекає оплати, не виправляє стару етикетку й не видає номери покупців. Відсутні поля залишаються порожніми. Сповіщення про помилку без покупця, товару чи даних замовлення не дає визначити потрібну етикетку.

Як працює приклад потоку

Використовує Event Type (Advanced) → Custom Event для product_sold і payment_failedіз фільтром Whatnot. Ставки й сповіщення про завершення аукціону не друкуються. Див. поля подій Whatnot.

Виберіть папір

Рулон чеків

Для квитанцій покупок, талонів черги й чеків будь-якої довжини. Залиште фіксовану довжину етикетки рівною 0.

Безперервний рулон наліпок

Для клейких смужок з ім'ям будь-якої довжини. Працює як чековий папір, але різання має виконувати принтер або драйвер.

Висічені етикетки

Для однакових бейджів і товарних етикеток. Задайте точну фіксовану довжину й виберіть той самий матеріал у налаштуваннях друку Windows.

Етикетка покупки

ПОКУПЕЦЬ №12

Inky
Синя чашка Ninja

Чековий папір 58 мм. Довжина зростає разом із текстом.

Дякуємо

INKY

$25.00 CAD

Висічна етикетка фіксованого розміру: ім'я й пожертва.

Видача

A-037

Худі Ninja
Розмір L

Етикетка мерчу або видачі з даними події й лічильником.

Приклади принтерів

Принтер	Підходить для	Примітки
Універсальний «POS-58»	Недорогі чеки 58 мм	Зазвичай USB. Назви й драйвери залежать від продавця. Для перевірки Social Stream використовувався базовий POS-58.
Epson TM-T20III	Надійніший чековий принтер	USB. Папір 80 мм або 58 мм із комплектним адаптером.
Brother QL-800	Наліпки й іменні етикетки	USB. До 62 мм, висічні або суцільні, з автоматичним різаком.
Brother QL-820NWB	Спільна або мережева станція етикеток	USB, Ethernet, Wi-Fi та Bluetooth.
Zebra ZD220	Ширші товарні, адресні етикетки або браслети	USB. Матеріал приблизно 25–112 мм. Версії прямого термодруку й термотрансферного друку.

Це приклади, а не список перевірених пристроїв. Перед купівлею переконайтеся, що конкретна модель має актуальний драйвер Windows, підтримує розмір етикетки й відображається як звичайний принтер Windows.

Правильно налаштуйте етикетки фіксованого розміру

Етикетки 3 × 1 дюйм (зокрема Munbyn BT320): задайте ширину 76.2 мм, а фіксовану довжину на 25.4 мм, якщо першою подається сторона 1 дюйм. Виберіть той самий матеріал і напрямок у налаштуваннях друку Windows. Почніть із тексту 12–14 пт.

Правило	Чому
Вимірюйте в напрямку подавання	Етикетка 62 × 29 мм зазвичай має ширину 62 мм і фіксовану довжину 29 мм.
Узгодьте налаштування Windows	У налаштуваннях друку драйвера задайте той самий матеріал, напрямок, розпізнавання проміжку/мітки й різак.
Фіксована довжина не змінюється	Додаткове протягування не додається. Зависокий текст може обрізатися або перейти на наступну сторінку залежно від драйвера.
Перевірте найдовший текст	Довгі імена, варіанти товару й додаткові рядки потребують більше місця або меншого шрифту.
Дуже короткі етикетки можуть не працювати	Social Stream запитує щонайменше 20 мм. Драйвер усе одно може обмежувати короткі сторінки.

Бічні межі тестового друку показують безпечну ширину. Висота залежить від тестового тексту. Контур усієї етикетки не малюється.

Ідеї для ефіру

Наліпки з іменами тих, хто підтримав, для стіни, реквізиту, карти або дошки прогресу.
Етикетки мерчу, індивідуальних замовлень, напоїв або видачі після надходження замовлень.
Лотерейні квитки. Перед друком додайте обмеження частоти й перевірки права участі.
VIP-бейджі, вибір команд, жетони завдань або етикетки етапів.
Короткий список завдань для продюсера поруч із вами.

Не друкуйте особисті дані. Не включайте адреси, email, платіжні дані й приватні повідомлення. Термопапір також вицвітає від тепла, світла й з часом.

Усунення несправностей

Проблема	Що спробувати
Принтер не відображається	Переконайтеся, що Windows друкує тестову сторінку. Перезапустіть Social Stream і знову натисніть «Знайти принтери».
Повідомляється про успіх, але друку немає	Відкрийте чергу принтера у Windows. Перевірте паузу, автономний режим, помилки паперу, драйвера або порту.
Край обрізається	Залиште використання області друку ввімкненим. Збільште безпечний відступ із цього боку.
Забагато порожнього паперу	Для чеків задайте фіксовану довжину 0. Зменште нижнє поле й додаткове протягування. Для етикеток задайте точну довжину.
Одна етикетка друкується на двох	Текст вищий за етикетку або у Windows задано неправильний розмір матеріалу. Зменште текст, шрифт, інтервали чи поля.
Тест потоку використовує не той принтер	Виберіть перевизначення принтера в кроці друку термоетикетки. Якщо поле порожнє, тест у редакторі використовує типовий принтер Windows.