Plugin Telegram Connector

SyS · (This post was last modified: 2019-04-15, 03:48 AM by Kar.)

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)