Получать уведомления в Telegram очень удобно, когда над проектом работает команда, все могут видеть новые подписки, оплаты и отписки, обсуждать детали.

Предварительные настройки

1. Создайте закрытый Telegram-чат

Чат должен быть закрытым, чтобы в него не вступили случайные люди. Команду можно добавить сразу или позже.

2. Создайте нового Telegram-бота

Боты в телеграме создаются через @botfather. Бота лучше сделать нового, чтобы он не был задействован в других задачах.

Сохраните его логин и Api token полученный при создании.

Api token бота выглядит в формате: «1234567890:FHdYOaG5hoKqFvI3tRrzOtAb7TRQ3O2Xt6H»

3. Выясните ID вашего чата

ID нужен для того, чтобы бот знал, куда отправлять сообщения.

• В разделе управления чатом, выберите «Добавить», чтобы добавить нового участника чата
• Впишите в поисковике: getmy_idbot
• Выберите из списка бот, который называется «GetMyIDBot» и добавьте его
• Через мгновение получите свой ID-номер и ID текущего чата
• Если вдруг бот ничего не прислал, то войдите в меню через соответствующую кнопку внизу и нажмите «Start»

ID чата выглядит в формате: «-1234567890987»

Получив ID чата @getmy_idbot можно удалять.

4. Добавьте созданного вами бота в созданный вами чат

Логика идентичная добавлению бота на предыдущем шаге. Только теперь, добавьте собственного бота, чтобы он мог писать в ваш чат. От имени бота будут приходить уведомления.

Создание событий

После того, как вы создали чат и добавили туда своего бота, вам нужно настроить отправку событий боту, чтобы он их передавал в чат.

Это делается через стандартную настройку вебхуков, по инструкции: Webhook — интеграция с любыми внешними системами через веб-хуки.

Необходимо для каждого коннектора, на каждое необходимое событие, создать вебхук со следующими параметрами:

• Название – любое
• Событие – любое необходимое вам
• Метод отправки – POST
• Адрес – смотрите ниже
• Дополнительные параметры – смотрите ниже

Какой указать адрес

Адрес формируется из стандартных значений + api token вашего бота:

https://api.telegram.org/bot{token}/sendMessage

где вместо {token} вы указываете api token вашего бота, без пробелов по краям. Должно получиться что-то похожее на пример:

https://api.telegram.org/bot1234567890: FHdYOaG5hoKqFvI3tRrzOtAb7TRQ3O2Xt6H /sendMessage

Какие указать дополнительные параметры

Бот принимает всего 2 параметра: chat_id и text.

В chat_id нужно указать ID созданного вами чата, который вы узнали на шаге 3 предварительных настроек. Это позволит боту однозначно идентифицировать получателя – ваш закрытый чат.

А в text нужно указывать значение самого сообщения. Сообщение можно сформировать из текста и из переменных Ainox. Полный список переменных можно посмотреть в настройке уведомлений вашего коннектора.

Должно получиться что-то похожее на пример:

chat_id=-1234567890987; 
text={event} от {e-mail}.;

Получение уведомлений

После того, как вы настроили вебхук для каждого события в коннекторе, можно приступать к тестированию. При наступлении выбранного события Ainox отправит вебхук боту, который отправит сообщение с заданным текстом в ваш телеграм-чат.

Важно! При отправке вебхука может быть задержка в несколько минут.

Помощь с настройкой

Инструкция создана в формате «как есть». Команда поддержки не оказывает консультации по взаимодействию с внешними системами.

Вы можете передать задачу по настройке вебхуков в техническую поддержку Ainox, в рамках дополнительной, платной услуги. Обратитесь в чат за консультацией со ссылкой на эту статью и описанием задачи.