Інтеграція Пульс: Як впроваджувати майданчикам

Контекст: 

Проєкт «Пульс» — це державна система збору зворотного зв’язку від бізнесу щодо взаємодії з державними органами та сервісами. Інтеграція віджету дозволить учаснику оцінити роботу майданчика, а також загальну ефективність аукціонів та взаємодію з організаторами. Pulse _Presentation_UA.pdf

Віджет Пульс — це проста онлайн-форма, яка дозволяє підприємцям оцінювати умови ведення бізнесу в країні та залишати відгуки чи поради щодо роботи органів влади, зручності сервісів і процедур, що впливають на бізнес. Зібрані дані формують реальну картину бізнес-клімату в Україні та допомагають уряду швидко реагувати на проблеми.

НПА який регламентує проєкт ПКМУ Про реалізацію експериментального проекту щодо цифровізації взаємодії органів виконавчої влади із суб’єктами господарювання за допомогою інформаційно-комунікаційної системи Пульс від 10 жовтня 2025 р. № 1304 Київ

Мета та цілі: 

Інтеграція віджету Пульс має забезпечити швидкий доступ користувача до сервісу Пульс без переходу на окрему сторінку.

Цілі інтеграції віджету на майданчиках.

• Забезпечити контакт з усією бізнес-аудиторією сайту. Надати змогу кожному бізнесу залишити оцінку і відгук.
• Забезпечити високий CTR, наскільки це можливо.
• Отримати якомога більше оцінок і відгуків від аутентифікованого бізнесу. 

Функціональні особливості:

• Документація віджету пульс
• Наявність реєстрації користувачів робить можливим використання безшовної інтеграції віджета (без додаткової аутентифікації після проходження опитування). Оскільки користувач уже увійшов у свій особистий кабінет на майданчику, йому не потрібно проходити додаткову державну авторизацію (наприклад, через id.gov.ua) всередині самого віджета.
  • Віджет має бути інтегрований для учасників аукціонів, після подачі заяви на участь - одразу після успішного подання заявки на участь та здійснення гарантійного/реєстраційного платежу. Це гарантує збір актуального фідбеку, не заважає користувачу і не знижує конверсію самого майданчика.
    • Частота виклику: Автоматичне відображення віджета налаштовується з обмеженням — не частіше 1 разу на 2 тижні для одного унікального профілю бізнесу

• • За умови наявності власних віджетів (наприклад, передзвонити або чат техпідтримки) додавати у вигляді банера
  • Постійний доступ (Self-Service): На майданчику має бути реалізована кнопка/посилання для самостійного виклику віджета користувачем у будь-який зручний момент.
• Активація віджету “Пульс” виконується при натисканні на кнопку віджета Пульс.
• Логіка пріоритетності (Конфлікт опитувань)
  • Пріоритет надається внутрішнім формам зворотного зв’язку майданчика, щоб не перевантажувати користувача.
• Технічна інтеграція віджета
  • Віджет Пульс складається з частини, яку бачить сам користувач на сайті – фронтової частини, та з API, що передає дані від майданчика до Пульсу.
  • Існує два варіанти інтеграції:
    • можливість використати  повністю готовий наданий дизайн віджету Пульс разом з API Пульс. Дизайн функціоналу віджету може бути змінено для досягнення нативного розміщення, але зі збереженням айдентики Пульс. Пульс надає статичний фронт (html/css/js) для полегшення кастомізації дизайну.
    • майданчик може візуально адаптувати віджет під дизайн власної сторінки, використовуючи лише API Пульсу для технічної взаємодії.
• Інтеграція віджета Пульс поза контуром аутентифікації бізнесу

• Інтеграція з сервісом Пульс (відправка даних до Пульсу) реалізована через API https://pulse.gov.ua/assets/pulse-feedback-widget/PFW.zip

• Існує тестове середовище.

• Токен для доступу надається окремо для кожного порталу (окремо для тестового і робочого середовища ).

• Результати опитування (оцінка та коментар) надходять знеособлено, але з валідацією того, що користувач є підприємцем.

• Опис API віджету Пульс:  Пульс_опис API

• Ініціалізація віджета
• Після успішного виклику віджет повинен відкриватися поверх поточної сторінки.
• Під час відкриття віджета фон сторінки позаду нього має затемнюватися відповідно до стандартної поведінки Pulse Feedback Widget.
• Після закриття віджета користувач повинен мати можливість повторно відкрити віджет.
• Якщо користувач почав взаємодію з віджетом, але закрив його до завершення, при повторному відкритті має зберігатися поточний прогрес, якщо це підтримується логікою самого Pulse Feedback Widget.

Нефункціональні особливості

• Обробка помилок
  • Якщо скрипт віджета недоступний або інстанс віджета не вдалося створити, це не повинно призводити до критичної помилки сторінки.
  • У разі помилки система повинна:
    • не ламати роботу плаваючого меню
    • не ламати роботу сторінки
    • логувати помилку в консоль браузера для діагностики
    • показувати користувачу повідомлення про тимчасову недоступність. Текст повідомлення: Віджет "Пульс" тимчасово недоступний. Ознайомитись з сервісом ви можете за посиланням https://pulse.gov.ua/

Контактна особа: Костянтин Руденко (k.rudenko@brdo.com.ua, +380674806080)