Настройка оповещений в 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.conact_id}/order/{order.id}">заказа {order.id}</a> по предложению {offer.title} пользователя {contact.email}
-
Например, если ваш кабинет имеет адрес sampleschool.kwiga.com, то необходимо указать
-
Успешная оплата <a href="https://sampleschool.kwiga.com/expert/crm/contact/{order.conact_id}/order/{order.id}">заказа {order.id}</a> по предложению {offer.title} пользователя {contact.email}
-
если в тексте вы используете html / markdown в тексте, то надо добавить parse_mode: html или 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.
Спасибо за отзыв!
Спасибо! Поправим статью. Нужен ответ сейчас? Написать в поддержку