TsgcTDLib_Telegram is a full Telegram client built on the official TDLib (Telegram Database Library). It signs in with a user account or a bot token, so it reaches far beyond the Bot API: your own chats, groups, channels, secret chats, media, payments and search. The same component and the same API in Delphi and C++ Builder.
Set Telegram.API.ApiId and ApiHash, sign in with Telegram.PhoneNumber or Telegram.BotToken, wire the message events, then set Active to True.
TsgcTDLib_Telegram
Official TDLib (Telegram Database Library)
Windows, macOS, Linux 64-bit, Android, iOS
Delphi, C++ Builder
Also inside sgcWebSockets. The Telegram client also ships inside sgcWebSockets editions from Standard up. sgcSocial is the standalone package, the sgcWebSockets Core runtime is bundled in.
Set your api_id and api_hash from my.telegram.org, sign in with a phone number, and echo inbound text messages. TsgcTDLib_Telegram is declared in the sgcLibs unit.
uses
sgcLibs;
var
Telegram: TsgcTDLib_Telegram;
begin
Telegram := TsgcTDLib_Telegram.Create(nil);
Telegram.Telegram.API.ApiId := '123456';
Telegram.Telegram.API.ApiHash := 'your-api-hash';
Telegram.Telegram.PhoneNumber := '+34600111222';
Telegram.OnAuthenticationCode := TelegramAuthenticationCode;
Telegram.OnAuthorizationStatus := TelegramAuthorizationStatus;
Telegram.OnMessageText := TelegramMessageText;
Telegram.Active := True;
end;
procedure TForm1.TelegramAuthenticationCode(Sender: TObject;
var Code: string);
begin
Code := InputBox('Telegram', 'Enter the code you received', '');
end;
procedure TForm1.TelegramAuthorizationStatus(Sender: TObject;
const Status: string);
begin
if Status = 'authorizationStateReady' then
Telegram.GetChats;
end;
procedure TForm1.TelegramMessageText(Sender: TObject;
MessageText: TsgcTelegramMessageText);
begin
Memo1.Lines.Add(MessageText.ChatId + ': ' + MessageText.Text);
Telegram.SendTextMessage(MessageText.ChatId, 'received!');
end;// include: sgcLibs.hpp
TsgcTDLib_Telegram *Telegram = new TsgcTDLib_Telegram(this);
Telegram->Telegram->API->ApiId = "123456";
Telegram->Telegram->API->ApiHash = "your-api-hash";
Telegram->Telegram->PhoneNumber = "+34600111222";
Telegram->OnAuthenticationCode = TelegramAuthenticationCode;
Telegram->OnMessageText = TelegramMessageText;
Telegram->Active = true;
void __fastcall TForm1::TelegramAuthenticationCode(TObject *Sender,
UnicodeString &Code)
{
Code = InputBox("Telegram", "Enter the code you received", "");
}
void __fastcall TForm1::TelegramMessageText(TObject *Sender,
TsgcTelegramMessageText *MessageText)
{
Memo1->Lines->Add(MessageText->ChatId + ": " + MessageText->Text);
Telegram->SendTextMessage(MessageText->ChatId, "received!");
}The members you reach for most often.
Telegram.API.ApiId and ApiHash identify your application. Sign in with Telegram.PhoneNumber, or with Telegram.BotToken for a bot. OnAuthenticationCode asks for the login code, OnAuthenticationPassword for the 2FA password, and OnRegisterUser covers new accounts.
OnConnectionStatus and OnAuthorizationStatus report the raw TDLib states. Telegram.DatabaseDirectory persists the session, so the next start does not ask for a code again.
SendTextMessage and SendRichTextMessage for text, SendDocumentMessage, SendPhotoMessage and SendVideoMessage for media, SendMessageAlbum for grouped media and SendInvoiceMessage for payments.
EditTextMessage, DeleteMessages, ForwardMessages and PinChatMessage cover the lifecycle after sending.
CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat and CreateNewSecretChat create conversations. JoinChat and JoinChatByInviteLink join existing ones.
SearchChats, SearchMessages, SearchContacts and SearchPublicChats query the network. DownloadFile fetches any file TDLib references.
Inline keyboards with callback and URL buttons, answered through AnswerCallbackQuery and observed with OnNewCallbackQuery. Reply keyboards offer text, request-location and request-phone-number buttons.
AnswerInlineQuery answers inline queries, AnswerPreCheckoutQuery and SendPaymentForm drive the payments flow.
OnMessageText, OnMessageDocument, OnMessagePhoto and OnMessageVideo deliver typed messages, with OnMessageSponsored, OnNewChat and raw OnEvent alongside. SendCustomRequest sends any TDLib JSON request.
HTTP, SOCKS5 and MTProto proxies route the TDLib connection through your network path of choice.
| sgcSocial OverviewBoth components, editions and licensing at a glance. | Open | |
| Feature Matrix: TelegramEvery capability of this component in table form. | Open | |
| Telegram API Deep DiveThe API reference page, with online help and PDF links. | Open | |
| Blog: Telegram Client for DelphiA walkthrough of building a Telegram client with this component. | Open | |
| Blog: Android Telegram ClientRunning the TDLib client on Android. | Open | |
| Blog: iOS Telegram ClientRunning the TDLib client on iOS. | Open |