Подключите магазин. Покажите товары.

Уведомления от Fourthwall, Ko-fi и Buy Me a Coffee, а также товары с QR-кодами.

Подключите уведомления за 5 шагов

  1. Открыть Monetization → Fourthwall, Ko-fi & Buy Me a Coffee alerts («Монетизация → Уведомления Fourthwall, Ko-fi и Buy Me a Coffee») и выберите своего Провайдер.
  2. Нажмите Настройка приёмника и включите удалённое управление расширением через API.
  3. Вернитесь в раздел монетизации и нажмите Копировать URL вебхука.
  4. Вставьте его в настройки вебхука поставщика (шаги ниже).
  5. Не закрывайте Social Stream Ninja.
Выбор провайдера SSN, скрытый URL вебхука, настройка приёмника, руководство и элементы предпросмотра примера
Панель настройки поставщика. Закрытый URL скрыт. Нажмите для увеличения.
Работает ли подключение? «Приёмник подключён» означает лишь, что SSN слушает события. Строка последнего события обновляется при получении реального события и сбрасывается после перезапуска.
Не публикуйте URL вебхука. Это единственная защита этих уведомлений: секрет подписи не проверяется. Подходит для уведомлений, но не как подтверждение оплаты при отправке заказов. Никогда не публикуйте этот URL и не помещайте его в QR-код.

Предпросмотр примера уведомления показывает только внешний вид. Суммы, Event Flow и вебхук не затрагиваются.

Для NinjaBacker, Throne, Amazon и eBay см. руководство по монетизации. Для Shopify см. Настройка Shopify.

Fourthwall

  1. В Fourthwall откройте Settings → For Developers → Webhooks («Настройки → Для разработчиков → Вебхуки»).
  2. Создайте вебхук и вставьте URL Fourthwall из SSN.
  3. Отметьте нужные события (см. таблицу).
  4. Сохраните и не закрывайте SSN.
Событие FourthwallОтображается как
ORDER_PLACEDПокупка. Её стоимость по-прежнему добавляется к пожертвованиям для совместимости со старыми настройками.
GIFT_PURCHASEПодарок.
DONATIONПожертвование.
SUBSCRIPTION_PURCHASEDНовое участие.

Заказы подарочных карт не добавляют стоимость дважды. Тестовые события пропускаются.

Документация вебхуков Fourthwall · Предпросмотр примера покупки

Ko-fi

  1. Открыть Вебхуки Ko-fi.
  2. Вставьте URL Ko-fi из SSN в URL вебхука и сохраните.
  3. Не закрывайте SSN.

Публичные чаевые, участие, заказы магазина и индивидуальные заказы используют одну ссылку. Закрытые платежи пропускаются. Заказы магазина и индивидуальные заказы отображаются как покупки и не увеличивают суммы пожертвований. Ko-fi не сообщает об отмене участия.

Проверяйте через предпросмотр SSN. Тестовые платежи Ko-fi выглядят как настоящие и могут вызывать уведомления, изменять суммы и запускать действия. Не используйте их при включённых платных наградах.

Документация вебхуков Ko-fi · Предпросмотр примера поддержки

Buy Me a Coffee

  1. В панели автора откройте Интеграции и выберите New webhook («Новый вебхук»).
  2. Задайте имя и вставьте URL Buy Me a Coffee из SSN.
  3. Отметьте нужные события (см. таблицу).
  4. Сохраните и оставьте доставку включённой. При ошибке проверьте там историю доставки.
СобытиеОтображается как
donation.createdПожертвование.
extra_purchase.createdПокупка.
commission_order.createdПокупка.
wishlist_payment.createdВзнос на подарок.
membership.startedУведомление о новом участии (не отдельное списание).

Скрытые заметки и анонимные сторонники остаются скрытыми. Тесты из панели управления (live_mode: false) пропускаются. Возвраты не уменьшают суммы.

Документация вебхуков Buy Me a Coffee · Предпросмотр примера взноса

Импортировать товар Fourthwall

  1. В Fourthwall перейдите в Settings → For Developers («Настройки → Для разработчиков») и создайте Токен Storefront. Не используйте ключ API администратора.
  2. В SSN откройте Products & support links → Set up products and links → Import a Fourthwall product («Товары и ссылки поддержки → Настроить товары и ссылки → Импортировать товар Fourthwall»).
  3. Вставьте общедоступную ссылку товара и токен. Нажмите Загрузить данные товара.
  4. Проверьте название, изображение, цену и ссылку. Ссылка и токен должны относиться к одному магазину.
  5. Выберите назначение: Магазин, Подарок, Поддержка или Присоединиться.
  6. Нажмите Добавить товар или ссылку, включите Товары и ссылки поддержкии нажмите Сохранить настройку.
Элементы импорта Fourthwall и загруженные поля товара, готовые к проверке в SSApp
Импорт заполняет редактор, чтобы вы могли проверить данные перед сохранением.
Что делает импорт
  • За раз загружается один общедоступный товар в наличии.
  • Токен определяет магазин для поиска. Он используется один раз и затем удаляется. Он никогда не сохраняется и не передаётся оверлеям.
  • Если у вариантов или наборов разные цены, поле цены остаётся пустым.
  • Это снимок данных. Цены, наличие и изображения не обновляются; при изменениях повторите импорт или отредактируйте запись.
  • Можно сохранить до 20 товаров. Повторное добавление того же товара создаёт вторую копию.

Создайте токен Storefront · Поля товара Fourthwall

Показывайте товары и QR-коды в эфире

Можно также вручную добавить любую общедоступную ссылку (Shopify, Tiltify, Patreon и т. д.). Это не подключает уведомления о платежах.

  1. В разделе Оверлей OBS для, выберите Товары и ссылки поддержки.
  2. Открыть Параметры ссылки оверлея и выберите Вид оверлея: Только витрина товаров, только карточка поддержки, только уведомления об активности или витрина и уведомления.
  3. Нажмите Копировать ссылку OBS и добавьте её в OBS как Источник «Браузер». Начните с 800 × 600. Используйте отдельный источник для каждого вида.
  4. В разделе Параметры отображения, закрепите первый товар или включите чередование, затем включите Показать QR-код.
  5. Отсканируйте QR-код телефоном, проверяя окончательный макет OBS.
Обрезанная витрина товара с названием, ценой, читаемой публичной ссылкой и QR-кодом
Карточка товара с общедоступной ссылкой и QR-кодом. Пример товара.
QR-код не сканируется? Не уменьшайте и не обрезайте оверлей слишком сильно. Чтобы поделиться ссылкой в чате, нажмите Копировать публичную ссылку.
Уведомления, multi-alerts и Event Flow
  • Витрина показывает изображение товара. Меньшая карточка поддержки — нет.
  • Уведомления об активности работают самостоятельно и никогда не показывают QR-код постороннего товара.
  • Multi-alerts и лента активности работают в одном сеансе без списка товаров. Для представления активности в разделе монетизации список товаров должен быть включён.
  • В Event Flow триггер пожертвования по-прежнему охватывает записи с hasDonation. Для покупок или завершённых подарков используйте тип события. См. сопоставление событий.

Переключайте товары в эфире или делитесь одной ссылкой для зрителей: см. управление товарами в эфире.

Если ничего не появляется

ПроблемаЧто попробовать
Приёмник выключенВключите удалённое управление расширением через API. Другие переключатели API выполняют другие функции.
ОтключеноОставьте SSN включённым и проверьте интернет. Это подключение SSN, а не вашего поставщика.
События не полученыПроверьте выбранного поставщика, URL и настройки его вебхука.
Событие пропущеноТесты, закрытые платежи, неподдерживаемые события и неверные суммы пропускаются.
Событие получено, но оверлея нетПроверьте сеанс, пароль, фильтры, правила SSN и видимость источника OBS. Большинство покупок не являются пожертвованиями.
Уведомления появляются дваждыНе отправляйте один и тот же платёж и через поставщика, и через другой сервис.
Ошибка импортаПроверьте ссылку товара, токен Storefront и доступность товара для всех. Его всегда можно ввести вручную.

Это лента уведомлений, а не журнал заказов. Для платежей, возвратов и доставки используйте панель поставщика. Уведомления Tiltify и Patreon пока не поддерживаются.