Налаштування сповіщень у Telegram канал
У статті описана послідовність дій, яка дозволяє налаштувати отримання сповіщень про нові платежі, нові реєстрації або інші події в Telegram чаті.
Сповіщень у Telegram каналі допоможе вам бути в курсі подій, оперативно реагувати та відстежувати дані клієнтів.
Крок 1: Необхідно створити Telegram бота. Ви можете використовувати раніше створеного бота або створити нового для цієї задачі. Вам необхідно мати API токен бота, і як створити бота або отримати його токен, можна дізнатися зі статті.
Крок 2: Створіть чат у Telegram (або використовуйте раніше створений), куди повинні приходити сповіщення. Додайте в цей чат бота (як адміністратора). Також додайте в цей чат бота @myidbot — він потрібен, щоб дізнатися ID цього чату.
Крок 3: У чаті напишіть /getgroupid@myidbot (скопіюйте цей текст без змін). У відповідь ви отримаєте ID чату.

Крок 4: Відкрийте свій проект на платформі Kwiga, у меню виберіть Курси - Налаштування процесів - Автоматизація процесів. Створіть новий тригер, у події виберіть ту подію, яка відповідає вашій задачі.
Приклади:
Якщо ви хочете отримувати сповіщення про нові реєстрації (неважливо, чи оплатили клієнти чи ні), виберіть - Контакти - Додано.
Якщо ви хочете отримувати сповіщення про нові платежі, виберіть - Замовлення - Успішна оплата замовлення.
У дії вкажіть відправку вебхука, Method POST.

У налаштуваннях Webhook параметра вкажіть:
URL: https://api.telegram.org/bot<token>/sendMessage
Замість <token> вставте токен вашого бота. Остаточний вигляд буде таким (замініть числа в прикладі на відповідне значення токена вашого бота):
https://api.telegram.org/bot4438664756564457547EabCX4AOtYCu678wOWsib31s/sendMessage
Додайте кастомні параметри:
chat_id — це ID чату, куди надсилати сповіщення, отримане за допомогою бота @myidbot. Якщо ID чату має знак мінус, вказуйте його також.
text — можна використовувати звичайний текст, а також HTML або Markdown формат. Тут ви вказуєте текст повідомлення, який має надходити в чат при виконанні події. Це може бути, наприклад:
Додано новий <a href="https://<вставте-сюди-адрес-кабинету-на-Kwiga>/expert/crm/contact/{contact.id}/personal-info">контакт #{contact.id}</a> {contact.name}
Або:
Успішна оплата <a href="https://<вставте-сюди-адрес-кабинету-на-Kwiga>/expert/crm/contact/{order.contact_id}/order/{order.id}">замовлення {order.id}</a> по пропозиції {offer.title} користувача {contact.email}
Наприклад, якщо ваш кабінет має адресу sampleschool.kwiga.com, то потрібно вказати:
Успішна оплата <a href="https://sampleschool.kwiga.com/expert/crm/contact/{order.contact_id}/order/{order.id}">замовлення {order.id}</a> по пропозиції {offer.title} користувача {contact.email}
Якщо в тексті ви використовуєте HTML / Markdown, додайте parse_mode: html або parse_mode: markdown.
Якщо додаєте посилання в текст і не хочете, щоб у повідомленні Telegram з'являлося велике прев'ю посилання, додайте link_preview_options.is_disabled: true.
Результат у чаті:

Ось посилання на документацію Telegram по відправці повідомлення.
Поширені запитання
Чи потрібно надавати боту права адміністратора в чаті?
Так, бота додають до чату для сповіщень як адміністратора. Також до цього чату потрібно додати бота @myidbot – він потрібен, щоб дізнатися ID чату.
Як дізнатися ID чату і що робити, якщо він зі знаком мінус?
Напишіть у чаті команду /getgroupid@myidbot без змін – бот відповість ID. Якщо ID починається з мінуса, вказуйте його разом із мінусом у параметрі chat_id.
Чи можна отримувати сповіщення про нові реєстрації, а не лише про оплати?
Так. Для реєстрацій, незалежно від оплати, виберіть в автоматизації подію «Контакти» → «Додано», для оплат – «Замовлення» → «Успішна оплата замовлення».
Яку адресу вказати у вебхуку?
https://api.telegram.org/bot, одразу за ним – токен вашого бота, потім /sendMessage. Метод – POST.
Чи можна відформатувати текст сповіщення та додати до нього посилання?
Так, текст може бути у форматі html або markdown – тоді додайте параметр parse_mode зі значенням html або markdown. Щоб під посиланням не з’являвся великий попередній перегляд, додайте параметр link_preview_options.is_disabled зі значенням true.
Дякуємо за відгук!
Дякуємо! Виправимо статтю. Потрібна відповідь зараз? Написати в підтримку