TgConnector
![[Image: tgconnector.svg?branch=master]](https://travis-ci.org/Sreyas-Sreelal/tgconnector.svg?branch=master)
![[Image: sampctl-TGConnector-2f2f2f.svg]](https://shields.southcla.ws/badge/sampctl-TGConnector-2f2f2f.svg){kind=icon}
![[Image: tgconnector.svg]](https://img.shields.io/github/issues/Sreyas-Sreelal/tgconnector.svg)
![[Image: tgconnector.svg]](https://img.shields.io/github/issues-pr-raw/sreyas-sreelal/tgconnector.svg)
![[Image: tgconnector.svg]](https://img.shields.io/github/license/sreyas-sreelal/tgconnector.svg)
A telegram connector plugin that helps to interact with telgram bots through SA-MP.
Installing
If you are a sampctl user
PHP Code:
sampctl p install Sreyas-Sreelal/tgconnector
OR
- Download suitable binary files from releases for your operating system
- Add it your plugins folder
- Add tgconnector to server.cfg or? tgconnector.so (for linux)
- Add tgconnector.inc in includes folder
Building
- Clone the repo
PHP Code:git clone https://github.com/sreyas-sreelal/tgconnector.git
- Use makefile to compile and test
- Setup testing environment
PHP Code:make setup
- To build release version
PHP Code:make release
- Run tests
PHP Code:make run
- Setup testing environment
Example
A basic bot
PHP Code:
#include<a_samp>
#include<tgconnector>
#include<zcmd>
#define CHAT_ID (TGChatId:"YOUR_CHAT_ID_HERE")
new TGBot:g_bot;
main() {
//Store bot token in SAMP_TG_BOT environment variable and connect from it
g_bot = TGConnectFromEnv("SAMP_TG_BOT");
if(g_bot != INVALID_BOT_ID) {
printf("bot connected successfully!");
} else {
printf("Error: bot couldn't connect");
}
}
public OnTGMessage(TGBot:bot,TGUser:fromid,TGMessage:messageid) {
if(g_bot != bot){
return 1;
}
new?
message[50],
username[24],
chatname[56],
server_msg[128];
TGCacheGetMessage(message);
TGCacheGetUserName(username);
TGCacheGetChatName(chatname);
format(server_msg,128,"[%s] %s(%d): %s",chatname,username,_:fromid,message);
SendClientMessageToAll(-1,server_msg);
return 1;
}
public OnTGUserJoined(TGBot:bot,TGUser:userid) {
new?
TGChatId:chatid[15],
username[24],
chatname[56],
server_msg[128];
? ? //Retrive data stored in current context
TGCacheGetUserName(username);
TGCacheGetChatId(chatid);
TGCacheGetChatName(chatname);
format(server_msg,128,"User %s(%d) joined %s(%s)",username,_:userid,chatname,_:chatid);
SendClientMessageToAll(-1,server_msg);
return 1;
}
public OnTGUserLeft(TGBot:bot,TGUser:userid) {
new?
TGChatId:chatid[15],
username[24],
chatname[56],
server_msg[128];
TGCacheGetUserName(username);
TGCacheGetChatId(chatid);
TGCacheGetChatName(chatname);
format(server_msg,128,"User %s(%d) left %s(%s)",username,_:userid,chatname,_:chatid);
SendClientMessageToAll(-1,server_msg);
return 1;
}
CMD:sendtgmessage(playerid,params[]) {
TGSendMessage(g_bot,CHAT_ID,params);
return 1;
}
Notes
This plugin is still in WIP and more tests need to be done.If you find any bugs or have anything to contribute feel free to open an issue or pull request on github.
Also be sure to not to share your bot token with anyone it's recommended to store it inside a environment variable.
Repository
Source: https://github.com/Sreyas-Sreelal/tgconnector
Releases: https://github.com/Sreyas-Sreelal/tgconnector/releases
Wiki: https://github.com/Sreyas-Sreelal/tgconnector/wiki (Not complete yet)
