Опис

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

WooCommerce не обов’язковий. З активним WooCommerce доступний повний набір подій замовлень; без нього плагін працює лише з формами й надсилає заявки Contact Form 7 у Телеграм, а сторінка налаштувань розташована в Налаштування Сповіщення в Телеграм.

Події, які можна увімкнути

Нове замовлення — надсилається один раз, коли замовлення вперше отримує один з обраних вами статусів (без дублів).
Зміна статусу — сповіщення за вашим власним переліком статусів замовлення.
Невдала оплата — окреме сповіщення для замовлень, що отримали статус «Не вдалося».
Закінчення залишків — спрацьовує, коли товар досягає порогу малого залишку з WooCommerce Налаштування Товари Запаси, не частіше одного разу на добу для кожного товару.
Заявки з форм сайту — Contact Form 7 одразу після встановлення, а також будь-який плагін, що викликає дію catcode_lead_captured.

Гнучка доставка

Надсилайте одразу в кілька чатів — приватний чат, групу або канал (@username).
Надсилайте у тему форуму, додавши ID теми — наприклад -1001234567890:42.
Тихий режим — повідомлення надходять без звуку сповіщення.

Власні шаблони повідомлень

Складіть власне повідомлення з тегів: номер замовлення, сума, список товарів, кількість позицій, ім’я клієнта, телефон, email і коментар, адреса оплати та доставки, спосіб оплати й доставки, дата та статус замовлення, посилання на замовлення в адмінці. Рядок, усі теги якого порожні, прибирається автоматично — тож повідомлення лишається охайним, навіть якщо якогось поля немає. Підтримується розмітка Telegram (<b>, <i>, <u>, <s>, <code>, <a href>).

Надійно та безпечно

Журнал надсилань — кожне надсилання фіксується разом із чатом, HTTP-статусом і результатом.
Автоматичний повтор — невдале надсилання повторюється один раз через коротку паузу.
Токен бота зберігається зашифрованим.

Telegram і WooCommerce — продукти третіх сторін. Цей плагін є незалежною інтеграцією і не пов’язаний з Telegram чи WooCommerce, не схвалений і не спонсорований ними.

Опис українською

Сповіщення про замовлення WooCommerce у Телеграм. Плагін надсилає повідомлення у ваш чат, групу або канал одразу, щойно в інтернет-магазині з’являється нове замовлення або змінюється його статус.

Свій бот Телеграм — токен береться у @BotFather, жодних посередників і комісій.
Надсилання в особистий чат, у групу, у канал або в окрему тему форуму.
Власний шаблон повідомлення: номер замовлення, сума, товари, покупець, телефон, спосіб доставки й оплати.
Вибір статусів замовлення, які викликають сповіщення.
Кнопка тестового повідомлення, щоб перевірити налаштування без реального замовлення.
Заявки з форм сайту (Contact Form 7) — окремим повідомленням із власним шаблоном.

Telegram — сторонній сервіс. Цей плагін є незалежною інтеграцією і не афілійований з Telegram.

Безкоштовна і Pro-версія

Ця версія плагіна повністю робоча, без обмежень за часом і без реклами в адмінці.
Pro — окремий продукт із розширеними можливостями та підтримкою: https://catcode.com.ua/modules/telegram-order-notifications-for-woocommerce/

Зовнішні сервіси

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

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

Telegram — сторонній сервіс. Використовуючи цей плагін, ви погоджуєтесь з умовами Telegram.

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

Скріншоти

Підключення: токен бота і чати, які отримують сповіщення.

Події: які статуси замовлень і події магазину надсилають повідомлення. — Підключення: токен бота і чати, які отримують сповіщення.

Встановлення

Завантажте плагін у /wp-content/plugins/ або встановіть його з адмінки WordPress: Плагіни Додати новий.
Активуйте плагін. WooCommerce не обов’язковий: з ним приходять події замовлень, без нього плагін надсилає лише заявки з форм сайту.
У Telegram створіть бота через @BotFather командою /newbot і скопіюйте виданий токен.
Перейдіть у WooCommerce Сповіщення в Телеграм (або Налаштування Сповіщення в Телеграм, якщо WooCommerce не активний) і вставте токен бота.
Додайте один або кілька ID чатів (по одному в рядку). Скористайтеся кнопкою «Знайти chat_id» після того, як напишете боту повідомлення або додасте його в групу.
Оберіть події для сповіщень, за потреби відредагуйте шаблони й збережіть.
Натисніть «Надіслати тестове повідомлення», щоб переконатися, що все працює.

Часті питання

Як отримати токен бота?: Відкрийте @BotFather у Telegram, надішліть /newbot, пройдіть кроки й скопіюйте токен. Вставте його на сторінці налаштувань плагіна — він зберігається у зашифрованому вигляді.
Як дізнатися свій chat id?: Напишіть боту будь-яке повідомлення (або додайте бота у групу), потім відкрийте налаштування плагіна й натисніть «Знайти chat_id». Плагін прочитає нові оновлення й покаже ID чатів, які бачить. Зверніть увагу: якщо у бота налаштовано вебхук, getUpdates нічого не поверне.
Чи можна надсилати сповіщення в тему групи (форум)?: Так. Вкажіть ID чату, а далі через двокрапку ID теми — наприклад -1001234567890:42.
Які поля замовлення можна використати в повідомленні?: Номер та ID замовлення, сума, поточний і попередній статус, дата замовлення, список товарів і їх кількість, ім’я клієнта, телефон, email і коментар, адреса оплати та доставки, спосіб оплати й доставки, вартість доставки, посилання на замовлення в адмінці та назва магазину. У повідомленнях про низький залишок доступні також назва товару, артикул і залишок.

Відгуки

Для цього плагіна немає відгуків.

Учасники та розробники

“CatCode Order Notifications with Telegram for WooCommerce” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:

CatCode

“CatCode Order Notifications with Telegram for WooCommerce” було перекладено на 1 локалізацію. Дякуємо перекладачам за їх роботу.

Перекладіть “CatCode Order Notifications with Telegram for WooCommerce” на вашу мову.

Цікавитесь розробкою?

Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.

Журнал змін

1.3.1

Виправлено посилання на сторінку модуля в сповіщенні в адмінці.
Сповіщення тепер закривається назавжди: після закриття воно більше не з’являється знову при наступному завантаженні сторінки.

1.3.0

Заявки Contact Form 7: кожне поле в повідомленні Телеграм тепер підписане текстом, що стоїть поруч із ним у формі, далі підказкою поля, і лише потім технічною назвою (your-name більше не з’являється як підпис).
Поля зі списком і перемикачами більше не виводять свій перший варіант як назву поля.
Підпис, у якому після двокрапки стоїть значення (наприклад «Площа: 500 м2»), залишає лише сам підпис.

1.2.0

WooCommerce тепер не обов’язковий: на сайті без магазину плагін працює лише з формами й надсилає заявки Contact Form 7 у Телеграм.
Без WooCommerce сторінка налаштувань розташована в Налаштування Сповіщення в Телеграм, а події замовлень і їхні шаблони приховано, щоб не висіли непрацюючими.
Збереження, тестове повідомлення і «Знайти chat_id» більше не падають з помилкою «Недостатньо прав» на сайті без WooCommerce.
Раніше збережені налаштування замовлень не губляться під час збереження на сайті без магазину, тож якщо згодом додати WooCommerce, нічого не пропаде.

1.1.2

Посилання «Налаштування» у списку плагінів: після активації плагін був лише підпунктом глибоко в меню WooCommerce, і здавалося, що нічого не встановилось.
Стандартні шаблони повідомлень тепер перекладаються і більше не записуються в базу під час активації: раніше український магазин одразу отримував повідомлення англійською.

1.1.1

Українська адмінка була частково англійською: WordPress віддає лише мовний пакет з translate.wordpress.org, а в ньому бракувало рядків, доданих у 1.1.0 (заявки з форм, нагадування про відгук). Тепер вбудований український переклад підвантажується як запасний під мовним пакетом.

1.1.0

Нова подія: заявки з форм сайту — Contact Form 7 одразу після встановлення і будь-який плагін, що викликає дію catcode_lead_captured, з окремим шаблоном повідомлення.
Попередження про малий залишок обмежено одним на товар на добу; раніше кожне замовлення повторювало те саме попередження.
Посилання на замовлення в журналі доставки тепер працює і з HPOS, і без нього.
Одне ненав’язливе повідомлення в адмінці, яке з’являється лише після першого справді доставленого сповіщення і більше не показується після закриття.
Друга копія того самого плагіна більше не спричиняє фатальну помилку: вона просто не запускається.

1.0.3

Додано український переклад: його не було в опублікованій збірці.
readme: опис і ключові слова українською.

1.0.2

Усі глобальні ідентифікатори зведено до єдиного унікального префікса, щоб уникнути конфліктів.
Прибрано вбудовані файли перекладу; переклади надходять через WordPress.org.

1.0.0

Перший публічний реліз.