=== Telegram Order Notifications for WooCommerce ===
Contributors: catcode
Tags: woocommerce, telegram, notifications, sms, viber
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Миттєві сповіщення про замовлення WooCommerce у Telegram: нові замовлення, зміна статусу, невдала оплата, низький залишок.

== Description ==

Плагін надсилає повідомлення про події вашого магазину WooCommerce у Telegram — в особистий чат, групу, канал або окрему тему (topic) форум-групи.

**Можливості**

* Сповіщення про нове замовлення — один раз, коли замовлення вперше потрапляє у вибраний статус.
* Сповіщення про зміну статусу — окремий список статусів, які вас цікавлять.
* Сповіщення про невдалу оплату.
* Сповіщення про низький залишок товару (поріг береться з налаштувань WooCommerce).
* Кілька чатів одночасно; підтримка тем у форум-групах (`-1001234567890:42`).
* Власні шаблони повідомлень із тегами: номер, сума, товари, покупець, телефон, адреса, спосіб оплати й доставки, посилання в адмінку.
* Рядок, усі теги якого порожні, автоматично прибирається з повідомлення.
* Тихі повідомлення (без звуку).
* Кнопка «Знайти chat_id» — не треба шукати сторонніх ботів.
* Журнал відправок із кодом відповіді Telegram.
* Повторна спроба через 5 хвилин, якщо Telegram недоступний.
* Токен бота зберігається у зашифрованому вигляді.
* Сумісність з HPOS (custom order tables) і блоковим checkout.

**Pro: Viber і SMS покупцям**

* Повідомлення покупцю про статус замовлення: окремий текст для кожного статусу, кожен надсилається один раз.
* Сервіси на вибір: TurboSMS, Alpha SMS або SMS-Fly. Канал — Viber з резервом SMS, лише Viber або лише SMS.
* Номер у форматі E.164 за країною замовлення: `093…`, `+38 093…`, `731 234 567` для Польщі — без здогадів за першими цифрами.
* Альфа-імʼя і Viber-відправник окремо для кожної країни (`UA=Shop`, `PL=ShopPL`, `*=Shop`).
* Тег `{tracking_number}` — номер ТТН з наших модулів Нової Пошти й Укрпошти або з будь-якого мета-поля замовлення.
* Надсилання у фоні через Action Scheduler: повільний шлюз не гальмує оформлення замовлення.
* Перевірка ключа й балансу, тестове повідомлення, журнал і приватна нотатка в замовленні.
* 7 днів Pro безкоштовно за кнопкою в налаштуваннях; далі ліцензія на catcode.com.ua.

**Як налаштувати**

1. Створіть бота: напишіть [@BotFather](https://t.me/BotFather) команду `/newbot` і скопіюйте токен.
2. Вставте токен у WooCommerce → Telegram-сповіщення.
3. Напишіть боту будь-яке повідомлення (або додайте його в групу як адміністратора) і натисніть «Знайти chat_id».
4. Вставте отриманий ID у поле «Чати для сповіщень» і надішліть тестове повідомлення.

Плагін не є офіційним продуктом Telegram чи WooCommerce.

== External services ==

Плагін звертається до Telegram Bot API (`https://api.telegram.org`) — це необхідно, щоб доставити сповіщення у ваш чат.

Передаються: токен вашого бота, ID чату та текст повідомлення, сформований за вашим шаблоном (може містити номер, суму й склад замовлення, ім’я, телефон, email і адресу покупця). Дані надсилаються лише в момент події, тільки у вказані вами чати.

Умови використання: https://telegram.org/tos ; політика конфіденційності: https://telegram.org/privacy

Лише якщо увімкнено Pro-функцію «Viber / SMS покупцям», плагін звертається до вибраного вами сервісу: TurboSMS (`https://api.turbosms.ua`, сайт і умови: https://turbosms.ua/ , конфіденційність: https://turbosms.ua/privacy.html), Alpha SMS (`https://alphasms.ua`, сайт: https://alphasms.ua/ , конфіденційність: https://alphasms.ua/legal/privacy/) або SMS-Fly (`https://sms-fly.ua`, оферта: https://sms-fly.ua/oferta/ , конфіденційність: https://sms-fly.ua/privacy/). Передаються: ваш ключ сервісу, номер телефону покупця, імʼя відправника й текст повідомлення за вашим шаблоном.

Для Pro-ліцензії плагін звертається до `https://catcode.com.ua/wp-json/catcode/v1/` (активація, пробний період, щоденна перевірка): передаються ключ ліцензії, адреса сайту і, для пробного періоду, e-mail, який ви вказали.

== Frequently Asked Questions ==

= Бот не пише в групу =
Додайте бота в групу та надайте йому право надсилати повідомлення. Для каналів бот має бути адміністратором.

= Кнопка «Знайти chat_id» нічого не знаходить =
Спершу напишіть боту повідомлення. Якщо для бота встановлено webhook, метод getUpdates не працює — вкажіть chat_id вручну.

= Повідомлення не надсилається, у журналі «can't parse entities» =
У шаблоні незакритий або недозволений HTML-тег. Telegram підтримує лише `<b>`, `<i>`, `<u>`, `<s>`, `<code>`, `<pre>`, `<a href>`.

= Чи можна надсилати в кілька чатів? =
Так, по одному ID на рядок.

== Screenshots ==

1. Налаштування підключення та подій.
2. Шаблони повідомлень із тегами.
3. Повідомлення про нове замовлення у Telegram.
4. Журнал відправок.

== Changelog ==

= 1.3.1 =
* Поки поруч активна безкоштовна копія з WordPress.org і ця версія стоїть на паузі, WooCommerce більше не показує її як несумісну з HPOS (червоне повідомлення на всіх сторінках адмінки).

= 1.3.0 =
* Pro: повідомлення покупцям у Viber і SMS про статус замовлення через TurboSMS, Alpha SMS або SMS-Fly.
* Номер телефону приводиться до E.164 за країною замовлення; альфа-імʼя і Viber-відправник — за країною.
* Тег {tracking_number} з мета-полів замовлення (Нова Пошта, Укрпошта або ваше поле).
* Ліцензія і 7-денний пробний період Pro; Telegram-сповіщення лишаються безкоштовними.

= 1.2.0 =
* WooCommerce більше не обовʼязковий: без магазину плагін надсилає в Telegram заявки з форм сайту.

= 1.1.0 =
* Нова подія — заявки з форм сайту (Contact Form 7) з власним шаблоном повідомлення.
* Підтримка екшена `catcode_lead_captured`: якщо встановлено KeyCRM Form Catcher, у повідомленні є тип заявки, товар і артикул.
* Низький залишок — не частіше одного повідомлення на товар на добу (раніше кожне замовлення повторювало попередження).
* Посилання на замовлення в журналі тепер відкривається і з HPOS, і без нього.
* Ненав'язливе сповіщення в адмінці — з'являється лише після першого доставленого повідомлення, закрив = більше не показуємо.
* Дві копії модуля (наша й версія з WordPress.org) більше не валять сайт фаталом — друга просто не запускається.

= 1.0.0 =
* Перший реліз.
