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

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

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

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. Настраиваем шаг Вебхук:

Вставляем в поле URL: https://api.telegram.org/bot<ТВОЙ_ТОКЕН>/getUpdates , где <ТВОЙ_ТОКЕН> - это токен твоего ТГ-бота полученный при создании бота через BotFather.

Метод запроса — POST

Тип тела - JSON

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

Пример:

Обратите внимание, что аргументы в Тело запроса добавляются через знак ➕ в правой части поля ввода:

Пример 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}

Работа с аргументами в плейсхолдере

#ЗАДАЧА
Поздоровайся и спроси у клиента:
1. Имя
2. Номер телефона
3. Род деятельности компании
Клиент ответит на все вопросы, вызови функцию tg_bot и передай в неё аргументы {contact_id}, {lead_id}, {manager_id}, {origin} и {source}. 

Где взять параметры {contact_id}, {lead_id}, {manager_id}, {origin} и {source} из примера выше, если во время диалога мы их не формировали?

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

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

В зависимости от подключённого канала, параметры, попадающие в placeholders могут отличаться.

Самый простой способ узнать, какие параметры мы можем с placeholders передать в нашу функцию — сделать экспорт диалога и проверить, какие именно параметры передаются Боту.