Отправка уведомлений о звонках в Telegram

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

Нам потребуется: cервер с Asterisk, Python3.6 или выше и pip3.

1. Создадим телеграм бота

1.1. Открываем телеграмм и в поиске находим BotFather

1.2. пишем ему команду /newbot пишем ему имя бота и username (username на конце должен содержать слово bot), а в ответ мы получаем api key который нужен дальше для отправки сообщений через бота.

(Мой ключ использовать не нужно, я все равно удалю бота)

2. Пишем бота.

Бот будет максимально простой, но для его работы нам понадобится установить пару зависимостей.

2.1. Установка библиотеки requests и asterisk в python.

       Выполним команду pip3 install requests asterisk

2.2. В папке /usr/share/asterisk/agi-bin/ создаем файл bot.py

cd /usr/share/asterisk/agin-bin/
touch bot.py - команда touch создает или обновляет дату создания файла

2.3 после чего откроем его в любом удобном текстовом редакторе в моем случаи это vim

vim bot.py

2.4. Впишем следующий код в данный файл:

#!/usr/bin/python3.6

import requests
import sys
import pymssql
from asterisk.agi import AGI

agi = AGI()
phone = str(agi.env["agi_callerid"])
exten = str(agi.env["agi_extension"])

text = 'Совершен вызов с номера: ' + phone + ' на номер: ' + exten

def main(text: str):
    token = ""
    url = "https://api.telegram.org/bot"
    channel_id = ""
    url += token
    method = url + "/sendMessage"

    r = requests.post(method, data={
         "chat_id": channel_id,
         "text": text
          })

    if r.status_code != 200:
        raise Exception("post_text error")

if __name__ == '__main__':
    main(text)

token — токен для бота, который выдал вам BotFather.

channel_id — ваш id телеграмма.

3. В /etc/asterisk/extensions_custom.conf пропишем следующее:

[from-code-num]

exten => 333,1,Answer()
same => n,AGI(bot.py)
same => n,Hangup()

При звонке на номер 333 Мы запускаем наш скрипт bot.py, что бы ловить вызов на любой номер вместо 333 напишите _XXX.

4. В разделе Connectivity перейдем в custom context и создадим новый контекст нажав на кнопку Add Context.

Настройки выставим следующие:

Тут мы разрешаем вызовы на все локальные номера, а также вызовы по всем маршрутам.

Далее идем в Applications -> Extensions

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

Во вкладке Advanced находим Custom Context

Сохраняем.

Теперь пробуем сделать вызов с этого номера на номер 333.

И нам пришло уведомление.

Вывод: Мы настроили нашу АТС на отправку уведомлений о звонках в телеграм, написали простого бота, который это реализует.