Описание функциональных характеристик проекта tlPutl

Проект tlPutl является интернет-сервисом (SaaS-решением) для администраторов телеграмм каналов. Решение построено на двух языках программирования: Laravel (PHP-фреймворк) и Python. Для получения данных используется API Telegram.

Функционал сервиса

1. Автопоиск рекламодателей

В режиме реального времени сервис отслеживает появление рекламных постов в каналах смежной с вами тематики.

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

Пример API запроса на Python для отслеживания появления рекламных постов в каналах смежной тематики и получения контактов заказчиков рекламы:

import requests
    
    # API запрос для автопоиска рекламодателей
    def search_advertisers(channel_topic):
        url = f"https://api.telegram.org/{YOUR_API_ENDPOINT}/search_advertisers"
        params = {
            "channel_topic": channel_topic
        }
        response = requests.get(url, params=params)
        data = response.json()
        # Обработка полученных данных
        # ...
        return data

2. Учет эффективности рекламы

Сервис ведет постоянный мониторинг ваших каналов, отслеживая рекламу и посты взаимного пиара.

Для каждого вида активности в канале делается расчет эффективности, исходя из количества новых подписчиков.

Пример API запроса на Python для мониторинга каналов и расчета эффективности рекламы на основе количества новых подписчиков:

import requests

# API запрос для учета эффективности рекламы
def calculate_advertising_efficiency(channel_id):
    url = f"https://api.telegram.org/{YOUR_API_ENDPOINT}/calculate_advertising_efficiency"
    params = {
        "channel_id": channel_id
    }
    response = requests.get(url, params=params)
    data = response.json()
    # Обработка полученных данных
    # ...
    return data

3. Автоматические комментарии

Сервис автоматически оставляет комментарии под публикациями в ваших каналах.

Комментарии стимулируют ваших собственных подписчиков оставлять комментарии, привлекая внимание рекламодателей.

Рекламодателям нравятся активные каналы, поэтому наличие комментариев увеличивает привлекательность вашего канала.

Пример API запроса на Python для автоматического оставления комментариев под публикациями в каналах:

import requests

# API запрос для оставления автоматических комментариев
def leave_comments(channel_id, comments):
    url = f"https://api.telegram.org/{YOUR_API_ENDPOINT}/leave_comments"
    params = {
        "channel_id": channel_id,
        "comments": comments
    }
    response = requests.post(url, json=params)
    data = response.json()
    # Обработка полученных данных
    # ...
    return data

4. Повышение вовлеченности и защита от ботов

Сервис предоставляет инструмент гибкой очистки канала от «мертвых душ», повышая вовлеченность (ER) и рост канала в глазах рекламодателей.

Функционал защиты канала от накрутки ботов обеспечивает надежность показателей активности и подлинность вашей аудитории.

Пример API запроса на Python для очистки канала от "мертвых душ" и защиты от накрутки ботов:

import requests

# API запрос для очистки канала от "мертвых душ" и защиты от ботов
def clean_channel(channel_id):
    url = f"https://api.telegram.org/{YOUR_API_ENDPOINT}/clean_channel"
    params = {
        "channel_id": channel_id
    }
    response = requests.post(url, json=params)
    data = response.json()
    # Обработка полученных данных
    # ...
    return data

5. Публикации любой сложности

Через сервис tlPutl вы можете планировать выход контентных и рекламных публикаций с текстом, фото, видео и реакциями.

Визуализация плана публикаций позволяет точно сбалансировать контентную и рекламную активность в канале.

Пример API запроса на Python для планирования и управления контентными и рекламными публикациями в канале:

import requests

# API запрос для планирования и управления публикациями
def schedule_publications(channel_id, publications):
    url = f"https://api.telegram.org/{YOUR_API_ENDPOINT}/schedule_publications"
    params = {
        "channel_id": channel_id,
        "publications": publications
    }
    response = requests.post(url, json=params)
    data = response.json()
    # Обработка полученных данных
    # ...
    return data

Обратите внимание, что в каждом примере необходимо заменить YOUR_API_ENDPOINT на конкретный адрес вашего API сервера или платформы, используемой для реализации функционала. Также вам понадобится обработать полученные данные в соответствии с требованиями вашего проекта.

Информация, необходимая для эксплуатации программного обеспечения

ПО распространяется в виде интернет-сервиса (SaaS-решение), специальные действия по установке ПО на стороне пользователя не требуются

Требования к серверу:

Composer 2
Node.js 14
Python 3
Linux/Unix
PHP >= 8.0
MySQL >= 5.7.8, MariaDB >= 10.2.2
Web-сервер Nginx
Расширение PHP BCMath
Расширение PHP Ctype
Расширение PHP cURL
Расширение PHP DOM
Расширение PHP Fileinfo
Расширение PHP JSON
Расширение PHP Mbstring
Расширение PHP OpenSSL
Расширение PHP PCRE
Расширение PHP PDO
Расширение PHP Tokenizer
Расширение PHP XML

Конфигурация web-сервера Nginx:

server {
listen 80;
listen [::]:80;
server_name example.com;
root /srv/example.com/public;

add_header X-Frame-Options "SAMEORIGIN";
add_header X-Content-Type-Options "nosniff";

index index.php;

charset utf-8;

location / {
try_files $uri $uri/ /index.php?$query_string;
}

location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }

error_page 404 /index.php;

location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php8.0-fpm.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}

location ~ /\.(?!well-known).* {
deny all;
}
}

Установка Laravel проекта:
1. Разместите файлы проекта на сервере
2. Устанавите зависимости командой composer install или composer update
3. php artisan key:generate
4. Заполните подключение в базе данных в файле .env
5. Заполните настройки почтового сервера SMTP в файле .env
6. Запустите мигриции базы данных командой php artisan migrate
7. Добавьте задание "php artisan schedule:work" в systemd или supervisor
8. Добавьте задание "php artisan queue:work" в systemd или supervisor

Установка Python микросервиса:

1. Разместите файлы проекта на сервере
2. Установите зависимости
3. Запустите проект через systemd или supervisor