package
0.0.0-20250311023717-5c21e974eed8
Repository: https://github.com/thrasher-corp/gocryptotrader.git
Documentation: pkg.go.dev

# README

GoCryptoTrader package Telegram

Build Status Software License GoDoc Coverage Status Go Report Card

This telegram package is part of the GoCryptoTrader codebase.

This is still in active development

You can track ideas, planned features and what's in progress on our GoCryptoTrader Kanban board.

Join our slack to discuss all things related to GoCryptoTrader! GoCryptoTrader Slack

Telegram Communications package

What is telegram?

  • Telegram is a cloud-based instant messaging and voice over IP service developed by Telegram Messenger LLP
  • Please visit: Telegram for more information

Current Features

  • Creation of bot that can retrieve

    • Bot status

    How to enable

    • Enable via configuration

    • See the individual package example below. NOTE: For privacy considerations, it's not possible to directly request a user's ID through the Telegram Bot API unless the user interacts first. The user must message the bot directly. This allows the bot to identify and save the user's ID. If this wasn't set initially, the user's ID will be stored by this package following a successful authentication when any supported command is issued.

    import (
    	"github.com/thrasher-corp/gocryptotrader/communications/base"
    	"github.com/thrasher-corp/gocryptotrader/communications/telegram"
    )
    
    t := new(telegram.Telegram)
    
    // Define Telegram configuration
    commsConfig := &base.CommunicationsConfig{
    	TelegramConfig: base.TelegramConfig{
    		Name:              "Telegram",
    		Enabled:           true,
    		Verbose:           false,
    		VerificationToken: "token",
    		AuthorisedClients: map[string]int64{"pepe": 0}, // 0 represents a placeholder for the user's ID, see note above for more info.
    	},
    }
    
    t.Setup(commsConfig)
    err := t.Connect
    // Handle error
    
  • Once the bot has started you can interact with the bot using these commands via Telegram:

/start			- Will authenticate your ID
/status			- Displays the status of the bot
/help			- Displays current command list

Please click GoDocs chevron above to view current GoDoc information for this package

Contribution

Please feel free to submit any pull requests or suggest any desired features to be added.

When submitting a PR, please abide by our coding guidelines:

  • Code must adhere to the official Go formatting guidelines (i.e. uses gofmt).
  • Code must be documented adhering to the official Go commentary guidelines.
  • Code must adhere to our coding style.
  • Pull requests need to be based on and opened against the master branch.

Donations

If this framework helped you in any way, or you would like to support the developers working on it, please donate Bitcoin to:

bc1qk0jareu4jytc0cfrhr5wgshsq8282awpavfahc

# Variables

ErrNotConnected is the error message returned if Telegram is not connected.
ErrWaiter is the default timer to wait if an err occurs before retrying after successfully connecting.

# Structs

ChatType contains chat data.
GetUpdateResponse represents an incoming update.
Message holds the full message information.
MessageEntityType contains message entity information.
MessageType contains message data.
Telegram is the overarching type across this package.
User holds user information.
UserType contains user data.