Підключення Perla до сайту клініки
Від реєстрації до живого чату на вашому сайті. Покроково, зі скріншотами й прикладами для кожної популярної платформи.
Як це працює
Три частини, які варто розуміти перед тим, як щось вставляти.
Профіль клініки — це джерело правди
Години, адреса, лікарі, послуги з цінами, страхові та правила передавання адміністратору. Perla відповідає пацієнтам лише з цих даних і нічого не вигадує. Що повніший профіль — то точніші відповіді.
Ключ звʼязує віджет саме з вашою клінікою
Кожна клініка отримує власний ключ виду pk_live_… Він публічний: лежить у коді сайту, і це нормально. Ключ дає рівно одне право — вести чат від імені вашої клініки, нічого більше.
Віджет ізольований від вашого сайту
Чат вантажиться в окремому вікні (iframe) з домену getperla.eu. Тому стилі вашого сайту ніколи не зламають чат, а стилі чату ніколи не зачеплять ваш сайт. Один рядок коду — і все.
Крок за кроком
Скріншоти з реального інтерфейсу. Оранжевим позначено, куди натискати.
Натисніть «Почати безкоштовно»
Відкрийте getperla.eu і натисніть кнопку у правому верхньому куті. Картка на старті не потрібна.
Створіть акаунт клініки
Вкажіть назву клініки, робочий email і пароль щонайменше з 8 символів. Назва потім зʼявиться у шапці чату, який бачать пацієнти, — пишіть її так, як хочете показати людям.
Заповніть профіль і скопіюйте ключ
Після входу ви потрапите в «Огляд». Пройдіть чотири пункти чеклиста — профіль, години роботи, лікарі, послуги з цінами. Далі прогорніть сторінку донизу: там буде блок «Ключ інтеграції». Натисніть «Копіювати».
Заповніть профіль до запуску
Якщо прайс чи години порожні, Perla чесно скаже пацієнту, що ціну уточнить адміністратор — замість того, щоб вигадати цифру. Це правильна поведінка, але кращий результат ви отримаєте, коли профіль заповнений повністю.
Вставка коду на сайт
Оберіть свою платформу — покажу, куди саме вставляти.
Ваша платформа
- 1Відкрийте файл сторінки — зазвичай index.html або спільний шаблон (footer, layout).
- 2Вставте код безпосередньо перед закриваючим тегом </body>.
- 3Якщо сторінок кілька і спільного шаблону немає — додайте код на кожну сторінку.
- 4Збережіть і завантажте файли на хостинг.
- Якщо у вас є спільний файл підвалу — вставте туди один раз, і чат зʼявиться скрізь.
<!-- Perla -->
<script
src="https://getperla.eu/widget.js"
data-perla-key="pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
defer
></script>Замініть pk_live_… на ключ зі свого дашборду. Код однаковий для всіх сторінок сайту.
Параметри віджета
Налаштовується прямо в теґу скрипта.
| Атрибут | Обовʼязковий | Що робить |
|---|---|---|
data-perla-key | Так | Ключ вашої клініки з дашборду. Без нього віджет не запуститься. |
data-perla-lang | Ні | Мова інтерфейсу чату: uk, cs, en, ru або de. Якщо не вказати — береться перша мова з профілю клініки. На саму відповідь не впливає: Perla завжди відповідає тією мовою, якою написав пацієнт. |
defer | Ні | Радимо лишати. Віджет завантажиться після основного вмісту й не сповільнить показ сторінки. |
Перевірка, що все працює
Три хвилини після вставки коду.
- 1
Кнопка зʼявилась
Відкрийте сайт клініки у новій вкладці. У правому нижньому куті має зʼявитися кругла кнопка з роботом. Якщо ви щойно вставили код — оновіть сторінку з Ctrl+Shift+R (Cmd+Shift+R на Mac).
- 2
Чат відповідає вашими даними
Натисніть кнопку й спитайте те, що є у вашому профілі: «Скільки коштує гігієна?» або «Коли ви працюєте в суботу?». Відповідь має збігатися з тим, що ви заповнили в дашборді.
- 3
Діалог зʼявився в дашборді
Поверніться в дашборд, розділ «Діалоги». Ваша тестова розмова має бути там. Спробуйте також записатися — назвіть імʼя й телефон, і в тому ж розділі зʼявиться заявка на запис.
Що Perla вміє, а що ні
Чесно, щоб не було несподіванок перед пацієнтами.
Уміє вже зараз
- Відповідає на питання про ціни, години роботи, адресу, лікарів і страхові — з вашого профілю
- Спілкується мовою пацієнта: українською, чеською, англійською, російською, німецькою
- Збирає заявку на запис: імʼя, телефон і зручний час, і показує її в дашборді
- Передає розмову адміністратору за вашими правилами — наприклад, при гострому болю чи скарзі
- Працює цілодобово, зокрема вночі та у вихідні, коли ресепшн недоступний
Ще не вміє
- Не записує пацієнта напряму в календар — заявку підтверджує адміністратор дзвінком
- Не ставить діагнозів і не радить лікування: це робота лікаря, а не ресепшену
- Не називає цін, яких немає у вашому прайсі — чесно скаже, що уточнить адміністратор
- Не приймає оплату онлайн
Часті питання
Чи безпечно тримати ключ у коді сайту?+
Так. pk_live_… — публічний ключ, він і має бути видимим у коді сторінки, так само як ключі Google Maps чи Stripe. Він дозволяє лише одне: вести чат від імені вашої клініки. Прочитати ваші діалоги, змінити профіль чи потрапити в дашборд з ним неможливо. Крім того, стоїть обмеження на кількість повідомлень за хвилину, щоб ніхто не міг зловживати.
Чи сповільнить віджет мій сайт?+
Ні. Файл важить кілька кілобайт і завантажується з атрибутом defer — тобто вже після того, як сторінка показалася користувачу. Сам чат вантажиться в окремому вікні й не блокує ваш сайт.
Віджет не зʼявився. Що робити?+
Перевірте три речі. Перше: код має стояти перед закриваючим тегом </body>, а не в HEAD. Друге: на Tilda й Webflow потрібно окремо опублікувати сайт після збереження коду. Третє: оновіть сторінку з очищенням кеша (Ctrl+Shift+R). Якщо не допомогло — відкрийте консоль браузера (F12) і пошукайте повідомлення, що починається з [Perla].
Чи можна змінити колір кнопки?+
Так. У дашборді відкрийте розділ «Віджет» і виберіть колір — або з готової палітри, або свій. Зміна застосується на сайті одразу, код чіпати не потрібно.
Чи можна поставити віджет на кілька сайтів однієї клініки?+
Так, один ключ можна використати на будь-якій кількості сторінок і доменів. Усі діалоги зберуться в один дашборд.
Де зберігаються дані пацієнтів?+
Діалоги й заявки на запис зберігаються на серверах у Європейському Союзі. Perla не просить у пацієнта номер картки, паспортні дані чи медичну історію — лише імʼя й телефон для зворотного дзвінка.
Щось не сходиться?
Напишіть нам — розберемось разом і, якщо треба, підключимо віджет за вас.