[Plugin] Telegram Connector

[Kalcor, SA:MP]

[Plugin] Telegram Connector

TgConnector







A telegram connector plugin that helps to interact with telgram bots through SA-MP.

Installing



If you are a sampctl user

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
  
  
  
  
  
  

  Code:

  
  

  git clone https://github.com/Sreyas-Sreelal/tgconnector.git

  
  
  
  


• Use makefile to compile and test
  
  
  • Setup testing environment
    
    
    
    
    
    

    Code:

    
    

    make setup

    
    
    
    
  
  
  • To build release version
    
    
    
    
    
    

    Code:

    
    

    make release

    
    
    
    
  
  
  • Run tests
    
    
    
    
    
    

    Code:

    
    

    make run

    
    
  
  

Example



A basic bot

pawn 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)

Source: [Plugin] Telegram Connector