Усі колекції
Базові питання
Додаткові налаштування
Налаштування відправки пропущених дзвінків до Telegram
Налаштування відправки пропущених дзвінків до Telegram
Mariia Lobchenko avatar
Автор: Mariia Lobchenko
Оновлено протягом останнього тижня

Тепер у вас є можливість самостійно налаштувати бота, який відправлятиме повідомлення про пропущені дзвінки до вашої групи в Telegram.

Цей функціонал надається безкоштовно та достатньо зручний: після кожного пропущеного дзвінка до групи вашого менеджерського складу автоматично надходитиме повідомлення.

Це дозволить менеджерам легко відстежувати усі пропущені дзвінки та оперативно їх обробляти. Крім того, вони зможуть відзначати оброблені дзвінки реакцією або надсилати повідомлення, щоб не інші менеджери не телефонували клієнтам повторно 🙂

Приклад, як виглядають повідомлення про пропущений дзвінок:

Можна кастомізувати вміст повідомлень, адаптуючи їх до потреб вашого бізнесу. Ви можете додати необхідні параметри, вибрати потрібну мову для тексту та багато іншого.

Щоб налаштувати такого бота, достатньо лише дотримуватися інструкцій послідовно нижче.


Створення та налаштування групи в Телеграм

1. Для налаштування групи в ТГ, відкриваємо Telegram та створюємо нову групу.

2. Групу називаємо "{домен проекту} / Пропущені". І завантажуємо логотип для групи, можна використовувати будь-який логотип. Після цього натискаємо "Далі" (Next).

3. Тепер додаємо обов'язково хоча б одного користувача. І натискаємо "Додати" (Create)

4. У новоствореній групі відразу ж потрібно призначити ще одного адміністратора для того, щоб група набула статусу “Супергрупи”.

4.1. Для цього переходимо у розділ “Керування групою” (Manage group) і там знаходимо налаштування групи

4.2. Вибираємо "Адміністратори"

4.3. І призначаємо адміністратором вашого користувача та виставляємо йому всі права, крім “remain anonymous”

4.4. Після цього натискаємо "Зберегти" (Save) та виходимо з групи.

Якщо увімкнути параметр “remain anonymous”, всі повідомлення цього користувача групи будуть відображатися від імені самої групи.

5. Тепер нам потрібно дізнатися ID-групи та додати бота Ringostat, який передаватиме дзвінки. Про це описали у наступному розділі - Налаштування ботів для отримання ID групи та дзвінків.


Налаштування ботів для отримання ID групи та дзвінків

Нам потрібно дізнатися ID-групи та додати бота Ringostat для відстеження дзвінків.

Щоб дізнатися ID-групи, потрібно додати до групи бота, який зможе відобразити вам айді.

Таких ботів безліч в інтернеті. Ми рекомендуємо використовувати

Додавання бота для визначення ID групи.

1. Додаємо даного бота @myidbot до групи:

  • Для цього достатньо натиснути на назву групи і вам відкриється розділ “Інформація про групу” (Group info).

    Або натиснути на три крапки праворуч зверху, далі відкрити "Дивитись інформацію про групу" (View group info)

  • І натискаємо на іконку з плюсиком.

  • Вставляємо нашого бота @myidbot і вибираємо першого, як на скріншоті нижче:

2. Бота додали. Тепер потрібно дізнатися ID групи, для цього достатньо просто ввести команду /getgroupid

І отримуємо ID супергрупи:

Обов'язково важливо, щоб у вас була супергрупа, а не група. Для цього потрібно, щоб був власник групи та адмін, або просто два та більше користувачів з правами Адміністратора.

3. Копіюємо ID (досить просто натиснути на значення, яке видав даний бот, значення обов'язково має бути з мінусом спереду), зберігаємо його і видаляємо бота, він більше не потрібен.

Додавання бота Ringostat для передачі дзвінків.

Тепер потрібно додати бота Ringostat, який передаватиме повідомлення про дзвінки у вашу групу.

Додаємо бота за аналогією, як робили з попереднім ботом, тільки вводимо назву @rngst_calls_monitoring_bot

Цього бота видаляти не можна, інакше перестануть працювати сповіщення про пропущені дзвінки!

Залишився фінальний етап - налаштувати webhook в особистому кабінеті Рінгостат, щоб сповіщення про пропущені дзвінки були інтегровані з Telegram.

Про це описали у наступному розділі - Налаштування webhook-запиту для Telegram.


Налаштування webhook-запиту для Telegram

Фінальний етап у створенні сповіщень про пропущені дзвінки в Telegram - це налаштування самого вебхук-запиту.

Вебхук-запити налаштовуються в розділі Установки → Інтеграція → Webhooks 2.0 в інтерфейсі особистого кабінету.

У цій статті також описали, як створити вебхук-запит. Рекомендуємо ознайомитися, якщо у вашому проекті ще немає вебхуків з подією Після дзвінка.

Налаштування webhook-запиту для Телеграм

Якщо подія Після дзвінка є:

1. Редагуємо будь-який вебхук з подією Після дзвінка:

2. І додаємо нову дію у події Після дзвінка:

3. Налаштовуємо нову дію:

3.1. Назва = Telegram missed calls alerts

3.2. HTTP Метод = POST

3.3. URL (копіюємо обережно) =

https://api.telegram.org/bot1883735049:AAEitlmpxJ0JE0N3LLG0lcPtvBWLCpXSags/sendMessage?chat_id=XXXXXXXXX

де XXXXXX - це отриманий раніше айді групи разом зі знаком “-”

Важливо! Обов'язково перевірте, що ви правильно скопіювали URL-адресу без пробілів і вказали ID групи з мінусом спереду.

3.4. Content type = application/json

3.5. Формат дати = Standard date

3.6. Формат відправки даних = raw

3.7. Тіло запиту - в залежності від мови.

Нижче наведено шаблони чотирма мовами. Вам необхідно вибрати ту мову, яка підходить вам та скопіювати шаблон у тіло запиту:

Шаблон українською мовою:

{
"text": "<b>Було пропущено дзвінок!</b>\n\nДата дзвінка: $calldate\nНомер клієнта: $userfield\nКуди дзвонили: $dst\nЧас очікування: $duration-billsec сек\nКартка дзвінка: <a href='$call_card'>посилання</a>\nСтатус дзвінка: $disposition\n",
"disable_web_page_preview": "true",
"parse_mode": "HTML"
}

Шаблон англійською мовою:

{
"text": "<b>Missed call!</b>\n\nCall date: $calldate\nCaller: $userfield\nDestination: $dst\nWait time: $duration-billsec sec\nCall card: <a href='$call_card'>link</a>\nCall status: $disposition\n",
"disable_web_page_preview": "true",
"parse_mode": "HTML"
}

Шаблон польською мовою:

{
"text": "<b>Przegapił połączenie!</b>\n\nCzas połączenia: $calldate\nNumer dzwoniącego: $userfield\nNumer, na który wykonano połączenie: $dst\nCzas oczekiwania: $duration-billsec сек\nKarta połączenia: <a href='$call_card'>Link</a>\nStatus połączenia: $disposition\n",
"disable_web_page_preview": "true",
"parse_mode": "HTML"
}

Шаблон російською мовою:

{
"text": "<b>Пропущен звонок!</b>\n\nДата звонка: $calldate\nНомер звонящего: $userfield\nКуда звонили: $dst\nВремя ожидания: $duration-billsec сек\nКарточка звонка: <a href='$call_card'>ссылка</a>\nСтатус звонка: $disposition\n",
"disable_web_page_preview": "true",
"parse_mode": "HTML"
}

Якщо вам потрібна додаткова інформація, наприклад, додатковий номер IVR, то шаблон тексту в потрібне місце потрібно додати:
\nДодатковий номер: $exten_number

Де:

\n - це абзац;

Додатковий номер: - назва параметра, його можна перекласти іншою мовою за потреби;

$exten_number - сам параметр, його також можна обирати, досить просто прописати $ і вибрати потрібне значення серед випадаючого списку:

Приклад запиту українського мовою:

4. І останній крок – налаштування фільтрів.

4.1. Переходимо у Фільтри:

4.2. Вибираємо встановлений фільтр Пропущені та застосовуємо:

4.3. У встановленому фільтрі не враховуються дзвінки з помилками, тому рекомендуємо додати ще два статуси "Невдалий" та "Не спрацювала схема переадресації":

І зберігаємо вебхук-запит.


На цьому налаштування завершено. Залишилось лише протестувати, здійснивши пропущений дзвінок у проекті.

Ви отримали відповідь на своє запитання?