Вітаємо в екосистемі автоматизації Holub! Цей посібник створено для того, щоб ви змогли підключити сповіщення в Telegram та синхронізацію з Google Таблицями всього за 5-10 хвилин, навіть якщо ви ніколи раніше не працювали з кодом чи API.
Нижче наведено вичерпний покроковий майстер налаштування.
---
## 🚀 Крок 1. Створення та налаштування Telegram-бота
Щоб ваш інтернет-магазин міг надсилати повідомлення, нам потрібен персональний робочий робот (бот), який виступатиме в ролі «кур'єра».
1. Відкрийте додаток **Telegram** на телефоні або комп'ютері.
2. У рядку пошуку введіть `@BotFather` (це офіційний батько всіх ботів у Telegram із синьою галочкою верифікації).
3. Натисніть кнопку **Start** (або наберіть `/start`).
4. Надішліть команду `/newbot` для створення нового робота.
5. `@BotFather` попросить вас ввести ім'я для бота (наприклад: `Мій Магазин Сповіщення`).
6. Після цього введіть унікальний юзернейм бота англійською мовою, який обов'язково має закінчуватися на `_bot` або `bot` (наприклад: `my_super_shop_hz_bot`).
7. У відповідь ви отримаєте привітальне повідомлення, яке містить **Token** (довгий рядок із цифр та літер, наприклад: `123456789:ABCdefGhI...`).
> ⚠️ **Важливо:** Нікому не показуйте цей токен, це пароль до вашого бота. Скопіюйте його.
8. Перейдіть за посиланням на вашого нового бота (воно буде в повідомленні) та натисніть кнопку **Start** (або напишіть йому будь-яке повідомлення), щоб дозволити йому писати вам у майбутньому.
---
## 👥 Крок 2. Отримання Chat ID (куди надсилати сповіщення)
Бот створений, але він не знає, в який саме чат (вам особисто чи в групу менеджерів) слати інформацію.
### Варіант А: Якщо ви хочете отримувати сповіщення особисто
1. У пошуку Telegram знайдіть бота `@userinfobot` або `@GiveChatId_bot`.
2. Натисніть **Start**.
3. У відповідь бот моментально надішле ваш персональний **Chat ID** (це числовий код, наприклад: `987654321`). Скопіюйте його.
### Варіант Б: Якщо сповіщення мають летіти в групу з менеджерами (Доступно в PRO)
1. Створіть звичайну групу в Telegram і додайте туди ваших менеджерів.
2. Додайте у цю групу вашого створеного бота (з Кроку 1) як учасника і **обов'язково зробіть його Адміністратором**.
3. Додайте в цю ж групу бота `@raw_data_bot`. Він виплюне в чат технічний код JSON. Знайдіть у цьому коді рядок `"id": -100xxxxxxxxx`. Число, яке починається з мінуса — це ID вашої групи. Скопіюйте його разом із мінусом.
4. Видаліть `@raw_data_bot` з групи, він більше не потрібен.
---
## 📊 Крок 3. Підключення Google Таблиць за 1 хвилину (Доступно в PRO)
Забудьте про складні налаштування Google Cloud. Ми розробили систему автоматичного копіювання інфраструктури.
1. Зайдіть в адмінці вашого сайту на вкладку **Google Таблиці** нашого плагіна.
2. Клікніть на кнопку **«📋 Копіювати шаблон»**.
3. У вікні, що відкриється, Google запитає: *«Зробити копію документа?»*. Натисніть **Зробити копію**. Таблиця з готовим дизайном та вбудованим кодом з'явиться у вашому Google Диску.
4. Подивіться на адресний рядок браузера вашої нової таблиці. Скопіюйте **Spreadsheet ID** — це набір символів між `/d/` та `/edit` (наприклад: `1RL7KOX6Tsgo-TWS2wUWCnfUADvReg3-sIofMEvtAR2M`).
5. У верхньому меню таблиці натисніть **Розширення (Extensions) -> Apps Script**.
6. Перед вами відкриється готовий код. Нічого не міняйте. Праворуч вгорі натисніть синю кнопку **Розгорнути (Deploy) -> Нове розгортання (New deployment)**.
7. Ліворуч натисніть на шестірню та оберіть тип **Веб-додаток (Web app)**.
8. У полі *«У кого є доступ» (Who has access)* **обов'язково оберіть: Усі (Anyone)**. Натисніть кнопку **Розгорнути**.
9. Надайте дозволи (Google попросить підтвердити акаунт -> натисніть *Advanced* -> *Go to project (unsafe)*).
10. Скопіюйте отриману **URL-адресу веб-додатку** (вона закінчується на `/exec`).
---
## ⚙️ Крок 4. Фінальна активація в адмінці WordPress
Тепер просто зв'яжемо все докупи. Поверніться в адмінку вашого сайту в меню **Holub Telegram**:
1. **Вкладка Telegram:** Вставте скопійований Token Бота та ваш Chat ID (або кілька ID, кожен з нового рядка, якщо у вас PRO). Нижче галочками відзначте, які саме дані (сума, телефон, склад товарів тощо) ви хочете бачити в повідомленні. Натисніть **Зберегти**.
2. **Вкладка Google Таблиці:** Вставте ID Таблиці та URL веб-додатку (exec). Натисніть **Зберегти**.
3. **Вкладка Швидке замовлення:** Поставте галочку *«Активувати кнопку „Купити в 1 клік“ на сайті»*. Оберіть автоматичний режим виведення кнопки (вона з'явиться в картці товару сама) або скопіюйте шорткод `[holub_quick_buy]` для вставки в Elementor.
**Все готово!** Зробіть тестове замовлення або змініть статус існуючого — магія автоматизації спрацює миттєво.
---
## ❓ Найчастіші питання та відповіді (FAQ)
### 1. Чому сповіщення не надходять в Telegram, а в логах пише «Помилка API»?
**Відповідь:** Найчастіша причина — ви забули активувати бота. Бот у Telegram не має права написати людині чи в групу першим, поки йому не дозволять. Обов'язково знайдіть вашого бота через пошук та натисніть кнопку **Start** (або додайте його в групу і зробіть адміном). Також перевірте, чи немає пробілів на початку або в кінці Token бота в налаштуваннях.
### 2. Як додати кілька менеджерів для отримання сповіщень?
**Відповідь:** У версії PRO ви можете зайти на вкладку Telegram і в полі «ID отримувача» ввести ID першого менеджера, натиснути Enter, ввести ID другого з нового рядка і так далі. Кількість чатів необмежена. У безкоштовній версії працює лише один, найперший ID.
### 3. Чи безпечно надавати доступ «Для всіх» (Anyone) під час активації скрипта Google?
**Відповідь:** Так, це повністю безпечно. Доступ «Anyone» у налаштуваннях Google Apps Script означає лише те, що ваш сайт WordPress зможе надіслати технічні дані замовлення без необхідності проходити складну авторизацію через логін/пароль щоразу. Сторонні люди не отримають доступу до вашого Google Диску чи інших файлів.
### 4. Дані не записуються в Google Таблицю, хоча ID і URL вказані правильно. Що робити?
**Відповідь:** Перевірте, чи правильно ви виконали Крок 3. Натисніть у таблиці ще раз *Розгорнути -> Керувати розгортаннями*, перевірте, щоб була активна остання версія веб-додатку, а доступ був виставлений саме для "Anyone". Також переконайтеся, що ви скопіювали посилання, яке закінчується саме на `/exec`, а не на `/edit`.
### 5. Кнопка «Купити в 1 клік» відображається, але при натисканні нічого не відбувається.
**Відповідь:** Наш модуль швидкого замовлення працює на базі технології AJAX, яка потребує підтримки jQuery від вашої теми WordPress (вона є у 99% тем). Якщо кнопка не реагує, перевірте, чи активовано плагін WooCommerce, та чи активовано чекбокс «Статус модуля» у нашій вкладці швидкого замовлення.
### 6. Я хочу перенести налаштований плагін на інший сайт, як це зробити?
**Відповідь:** Зайдіть на вкладку **📦 Експорт плагіна**, натисніть кнопку *«Зібрати в ZIP та завантажити»*. Плагін скомпілює сам себе у готовий архів, який ви можете завантажити на новий сайт через меню *Плагіни -> Додати новий*. Потім вам залишиться лише один раз натиснути «Зберегти налаштування» на новому сайті.
Коментарі
Дописати коментар