Настраиваемые уведомления в ТГ

Если стандартные оповещения от Савви Вам не подходят, то Вы можете настроить оповещения в свой ТГ бот используя механизм Веб-хуков.

Чтобы настроить кастомные оповещения в свой ТГ бот, надо выполнить несколько простых действий:

  1. Создайте бота в BotFather.

Подробную инструкцию, как создать бота в BotFather Вы можете найти в разделе руководства Telegram

  1. Получите id чата (chat_id) , в который будут направлены сообщения с оповещениями.

а. Если хотите получать уведомления в бот, то Вы должны получить свой персональный user_id - он же и будет использован, как chat_id в дальнейшем. Как получить свой персональный user_id, Вы можете прочитать по ссылке.

б. Если хотите получать уведомления в группу, Вам надо получить chat_id группы, куда будут приходить уведомления.

Инструкция, как получить chat_id группы.

Шаг 1: Добавь своего бота в группу

  1. Открой Telegram.

  2. Перейди в нужную группу.

  3. Добавь туда своего бота, как обычного участника.

  4. Назначь его админом (если хочешь, чтобы он мог писать сообщения в группу).

Шаг 2: Напиши любое сообщение в группу

Любое — хоть "тест" от себя, хоть что-то другое. Это нужно, чтобы в группе появилась активность.

Шаг 3: Получи обновления через Telegram Bot API

  1. В браузере введи в строку URL-адреса:

https://api.telegram.org/bot<ТВОЙ_ТОКЕН>/getUpdates

Где <ТВОЙ_ТОКЕН> - токен Вашего ТГ бота.

Пример :

https://api.telegram.org/bot123456789:ABCDEF1234567890abcdef12345678/getUpdates
  1. В ответ придёт JSON, в котором будет что-то типа:

{  
  "update_id": 123456789,
  "message": {
    "chat": {
      "id": -1001234567890,
      "title": "Название группы",
      "type": "supergroup"
    },
    ...
  }
}

Шаг 4: Используй chat_id из ответа

Вот этот id:

-1001234567890

— и есть chat_id группы. Он всегда отрицательный.

  1. В Савви переходим в Действия, нажимаем Создать:

  1. Заполняем поля функции:

  1. Добавляем аргументы и константы, которые будут передаваться на вебхук:

Аргументы — это переменные, которые будут формироваться ботом во время диалога. И зависят они от ответов пользователя

Константы — это параметры, которые будут передаваться на вебхук неизменно. В нашем название бота будет всегда передаваться ан вебхук, как Бот - Эльза

  1. Нажимаем Добавить шаг - и выбираем Вебхук:

  1. Настраиваем шаг Вебхук:

  1. Прописываем Тело запроса в формате JSON:

Пример:

{
"chat_id": "446298654",
"text": "{bot_name}, Имя клиента: {client_name}, Номер телефона: {phone_number}, Как прошёл диалог: {summary}"
}

❗️ Аргументы в фигурных скобках надо заменить на аргументы, добавленные через ➕.

  1. Нажимаем Сохранить:

  1. Теперь, после того, как мы настроили Действие на отправку уведомления в наш ТГ, необходимо в центральный промпт добавить инструкцию для бота, как он должен формировать аргументы и в какой момент необходимо передавать их в функцию отправки вебхука.

#ЗАДАЧА
Поздоровайся и спроси у клиента:
1. Имя и сформируй из ответа аргумент {client_name}.
2. Номер телефона и сформируй из ответа аргумент {phone_number}.
3. Род деятельности компании
После ответа клиента на последний вопрос, составь краткий пересказ диалога и сформируй из него аргумент {summary}.

Как только сформируешь все аргументы, вызови функцию tg_bot и передай в неё аргументы {client_name}, {phone_number} и {summary}

Кроме аргументов, сформированных в ходе диалога из ответов клиента, бот может передать в функцию параметры, находящиеся в placeholders.

Параметры placeholders можно увидеть в экспорте диалога в самом верху страницы. Выглядит это таким образом:

Last updated

Was this helpful?