[Plugin] Telegram Connector

[SyS]

TgConnector

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 

    
    
    
  
  

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)