Adlinkfly Telegram Bot
Un script de bot télégramme simple à utiliser à base de python conçu pour fonctionner avec le site Web de raccourcissement des liens Adlinlfly PHP à l'aide de l'API de développeur AdLinkFly!
⚡ Déploiement en 1 clic:
- Le déploiement en 1 clic est le moyen le plus simple de déployer ce bot! Cliquez sur ces boutons pour déployer le bot dans la plate-forme correspondante. Assurez-vous simplement de remplir / remplacer les valeurs de variables environnementales appropriées lorsque vous êtes demandé. Les paramètres sont expliqués ci-dessous dans les détails (dans la section Configuration / Environment Vriables).
? Exigences:
- Packages Python:
- pytelegrambotapi
- télébot
- demandes
- expirat
- Ballon
- enfilé
- Gunicorn
- python-dotenv
- Doit avoir un site Web de raccourcissement de lien AdLinkfly hébergé sur le Web avec un nom de domaine valide
- Votre site Web AdLinkFly a un certificat SSL valide installé (accessible via le protocole HTTPS!)
- Doit avoir configuré un Envioronment d'exécution approprié (WSGI compatible) pour exécuter des scripts Python! (Recommandé: rendre, koyeb, re-redret -or- un conteneur docker dans votre serveur personnalisé)
? ️ Caractéristiques:
- File facile à intégrer et personnalisé (fichier de configuration tout-en-un!)
- Détection et raccourcissement de l'URL automatique (pas de commandes supplémentaires nécessaires! Envoyez simplement le lien pour raccourcir ... c'est trop facile .. !!)
- Prend en charge le raccourcissement des liens avec un alias personnalisé
- Validation du lien Auto Userinput avec des messages d'erreur.
- Commandes télégrammes disponibles:
- / Démarrer - Affiche un message de bienvenue personnalisé lorsque l'utilisateur démarre la première conversation avec le bot
- / Aide - affiche un message d'aide et de support personnalisé lorsque la commande / aide est donnée par l'utilisateur
- / annonces - raccourcit le lien avec les annonces. Crée également une page de liaison courte distincte! (* Par défaut, la méthode de raccourcissement des liens est définie sur le raccourcissement direct sans aucune annonce et page de liaison courte , si l'utilisateur souhaite raccourcir le lien avec les annonces et la page de liaison courte La commande / ADS est requise à chaque fois!)
- / Alias - raccourcit le lien avec un alias personnalisé de votre choix (par exemple: yourDomain.com/cool-alias)
- / alias_ads - raccourcit le lien avec un alias personnalisé de votre choix et crée également une page de liaison courte distincte qui comprend des annonces
? Télécharger:
- Vous n'avez pas besoin de télécharger quoi que ce soit pour la plupart des cas (sauf: vous le déployez directement dans votre propre serveur personnalisé)
- Pour le déploiement de serveur personnalisé (Direct) Téléchargez la dernière Zip à partir de la section des versions: Adlinkfly-Telegram-Bot-Vx.xxzip Télécharger maintenant
Configuration / environnement Vriables:
- Il n'y a qu'un seul fichier de configuration global '.env' également appelé variables d'environnement que vous devez configurer pour votre bot! Un exemple de champs disponibles est affiché dans le fichier «.env.example» et également décrit ci-dessous (si vous utilisez les solutions de déploiement en 1 clic, vous n'avez pas besoin de créer un fichier «.env» distinct. Toutes les touches sont prédéfinies pour vous! Vous devez simplement saisir / remplacer leurs valeurs lorsque vous êtes demandé)
HOST_PORT = 8080 #Only for Docker Container Deployment - OPTIONAL - DEFAULT: 8080
DOMAIN_NAME = yourdomain.com
BOT_TOKEN = Paste Your Telegram Bot API Token
ADLINKFLY_TOKEN = Paste Your Adlinkfly API Token
START = Type the start message here you want to show the user nNew Line Starts Here
HELP = Type the help message here you want to show the user nNew Line Starts Here
#Don't use https:// on DOMAIN_NAME field just type the nacked domain name as shown!
#To change the line (New Line) of START or HELP message use ' n ' between the lines (Works as Enter Key of Keyboard! Python Syntax... :-)
- Champs importants:
- DOMAIN_NAME = Écrivez le nom de domaine de votre site Web Adlinkfly (écrivez le nom de domaine Nacké sans: www, http: //, https: //) (par exemple: yourDomain.com)
- API_TOKINE = Coller votre jeton API Télégramme Bot ici. Vous ne savez pas comment en obtenir un? lire ici
- AdLinkFly_Token = Collez votre jeton API de développeur AdLinkFly ici. Vous ne savez pas comment en obtenir un? lire ici
- Champs facultatifs:
- Host_port = maps le port de conteneur Docker interne (8080) au port spécifié de votre machine hôte. Utile lorsqu'un autre processus fonctionne sur le même port dans votre machine hôte pour une raison quelconque, ce qui peut entraîner un dysfonctionnement. Par défaut, il utilise le même port (8080) de votre machine hôte qui peut être écrasé par cette variable
- Messages personnalisés:
- Start = écrivez le message personnalisé que vous souhaitez afficher à l'utilisateur lorsqu'il utilise la commande Telegram '/ start'
- Help = écrire le message personnalisé que vous souhaitez afficher à l'utilisateur lorsqu'il utilise la commande Telegram '/ Help'
- Une personnalisation plus approfondie des commandes est possible en modifiant le code source Python .... si vous le souhaitez, vous pouvez essayer ... !!!
Installation / déploiement:
Déploiement à 1 clic (le plus simple):
- Cliquez simplement sur l'un des bouton donnés en haut (dans quelle plate-forme vous souhaitez déployer) et suivez les étapes. Remarque: assurez-vous d'abord de connecter la plate-forme avant de cliquer sur le bouton
- Il vous sera demandé de remplir les valeurs de la variable d'environnement (vérifier la section Configuration / Environnement Vriables pour plus d'informations) Remplissez correctement les valeurs et continuez. C'est ça...!!
- Votre plateforme n'est pas répertoriée? -> J'essaie continuellement d'intégrer de plus en plus de plates-formes. Mais, s'il n'est toujours pas répertorié, vous pouvez essayer l'option de déploiement personnalisé ou me contacter pour plus d'informations.
Replit Déploiement:
- Utilisez l'option «Importer depuis GitHub» pour importer ce dépôt. Vous ne savez pas comment le faire? lire ici
- Utilisez cette URL pour importer:
https://github.com/techishfellow/adlinkfly-telegram-bot.git
- Utilisez cette commande RUN:
- Ouvrez une fenêtre 'shell' et exécutez cette commande pour installer toutes les dépendances:
pip install -r requirements.txt
Ouvrez une fenêtre 'Secrets' et configurez tous les secrets comme expliqué précédemment (dans la section Configuration / Environment Vriables). Replit Secrets fonctionne de la même manière que les variables d'environnement. Vous ne savez pas comment utiliser Replit Secrets? lire ici
Maintenant, cliquez simplement sur le bouton vert «Exécuter» en haut pour démarrer le bot. C'est ça...!!
Déploiement du serveur personnalisé (avec Docker) (recommandé):
- Installez le plugin Docker et Docker Compose (sur Ubuntu / Debian):
curl -sSL https://get.docker.com/ | CHANNEL=stable sh && apt install docker-compose-plugin
- Clone le référentiel Adlinkfly Telegram Bot git vers / opt / adlinkfly-telegram-bot:
git clone https://github.com/techishfellow/adlinkfly-telegram-bot.git /opt/adlinkfly-telegram-bot
- Naviguez vers / opt / adlinkfly-telegram-bot puis créez un fichier .env vierge et modifiez-le (comme expliqué précédemment, dans la section Vriables de configuration / environnement) en utilisant l'éditeur de texte de ligne de commande nano:
cd /opt/adlinkfly-telegram-bot && touch /opt/adlinkfly-telegram-bot/.env && nano /opt/adlinkfly-telegram-bot/.env
Enregistrez-le avec CTRL + O puis en appuyant Enter , quittez Nano CTRL + X
- Ne pas construire et démarrer AdLinkfly Telegram Bot, allez sur / opt / adlinkfly-telegram-bot puis construisez et lancez les conteneurs Docker:
cd /opt/adlinkfly-telegram-bot && docker compose build && docker compose up -d
- Pour arrêter le bot, vous pouvez utiliser cette commande à tout moment:
cd /opt/adlinkfly-telegram-bot && docker compose down
Déploiement du serveur personnalisé (directement) (non recommandé):
- IMPORTANT: Ce script ne fonctionne que dans les serveurs compitables WSGI (la plupart des distros Linux fonctionneront bien ... !! Windows n'est pas pris en charge ... !!)
- Décompressez le fichier zip de version téléchargée (à l'aide de tout logiciel d'extracteur zip. Par exemple: Winrar, 7Zip etc.)
- Ouvrez le dossier extrait et créez un nouveau fichier «.env» sur cet emplacement et configurez-le comme expliqué précédemment (dans la section Configuration / Environment Vriables) (utilisez tout éditeur de texte ou éditeurs de texte terminal. EG: Notepad, Vim, Nano)
- Téléchargez tous les fichiers extraits avec le fichier .env dans la racine de votre serveur
- Assurez-vous que vous avez déjà installé Python3 et PIP dans votre serveur (la plupart des distros Linux sont livrés avec Python3 préinstallé.
sudo apt install python3-pip
- Maintenant, pour installer toutes les dépendances, exécutez cette commande:
pip install -r requirements.txt
- Maintenant, pour démarrer le bot, exécutez cette commande:
- À, arrêtez le bot que vous pouvez utiliser Ctrl + C ou cette commande:
pkill -SIGINT -f 'gunicorn -b 0.0.0.0:8080 -w 4 webserver:adlinkflytgbot'
Contribution / bâtiment de la source:
- Vous voulez faire partie de ce projet? N'hésitez pas à contribuer .. !! Les demandes de traction sont toujours les bienvenues .... !! Suivez ces étapes simples pour commencer à construire. . .
- L'utilisation d'un environnement de développement Linux est requise | Pour Windows, utilisez WSL ou faites simplement tourner un conteneur Docker
- Fourk ce repo dans votre compte GitHub
- Git clone le repo fourchu dans votre machine locale
- Créez votre fichier .env comme expliqué précédemment
- Installez toutes les dépendances:
pip install -r requirements.txt
- Exécutez le bot:
- Effectuer les modifications, envoyer une demande de traction avec une description appropriée (Remarque: les demandes de traction sans description appropriées seront rejetées)
Licence et utilisation
Adlinkfly Telegram Bot est un projet d'observation ouverte sous licence GPL-3.0 Tout le monde peut afficher, modifier ou utiliser (personnel et commercial). Les sources sans aucune autorisation supplémentaire. Si vous souhaitez distribuer ses sources, veuillez envisager de lui donner une attribution de ce dépôt. Remarque: Ce script n'est pas officiellement développé, soutenu ou affilié par les puissants. Ce n'est qu'un projet de passe-temps!
Un projet d'origine ouverte - développé avec ♥ par Subhamoy