Cliente da API Telegram para Delphi e C++ Builder | eSeGeCe

Cliente Telegram TDLib

Construa aplicações Telegram (conta de usuário ou bot) em Delphi/C++Builder. Encapsula o Telegram TDLib oficial para expor autenticação, chats, mensagens e eventos de update.

TsgcTDLib_Telegram

Wrapper Delphi/C++Builder para o Telegram TDLib oficial (tdjson). Conduz a máquina de estados de autenticação, expõe eventos tipados de envio/recebimento de mensagens e entrega todos os demais updates do TDLib por meio de OnEvent.

Classe do componente

TsgcTDLib_Telegram

Protocolo

Telegram TDLib

Plataformas

Windows, macOS, Linux, iOS, Android

Edição

Standard / Professional / Enterprise

Configure o TDLib, autentique-se, envie mensagens

Defina Telegram.API.ApiId / ApiHash e Telegram.PhoneNumber, conecte OnAuthenticationCode ao fluxo de login e envie mensagens assim que OnAuthorizationStatus reportar authorizationStateReady.

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->OnAuthorizationStatus = TelegramAuthorizationStatus;
Telegram->OnMessageText = TelegramMessageText;

Telegram->Active = true;

void __fastcall TForm1::TelegramAuthenticationCode(TObject *Sender, AnsiString &Code)
{
  Code = InputBox("Telegram", "Enter the code you received", "");
}

void __fastcall TForm1::TelegramAuthorizationStatus(TObject *Sender, const AnsiString Status)
{
  if (Status == "authorizationStateReady")
    Telegram->GetChats();
}

void __fastcall TForm1::TelegramMessageText(TObject *Sender, TsgcTelegramMessageText *MessageText)
{
  Memo1->Lines->Add(MessageText->ChatId + ": " + MessageText->Text);
  Telegram->SendTextMessage(MessageText->ChatId, "received!");
}

O que tem dentro

Uma fachada Delphi sobre a biblioteca compartilhada oficial TDLib (tdjson) — o mesmo protocolo usado pelos clientes Telegram oficiais.

Fluxo de autenticação

O componente conduz a máquina de estados de autenticação do TDLib: número de telefone, código, senha 2FA opcional, e persiste a sessão no diretório do banco de dados local.

Envio de mensagens

SendTextMessage, SendPhotoMessage, SendVideoMessage, SendDocumentMessage e SendMessageAlbum cobrem os principais tipos de conteúdo de mensagem do TDLib.

Chats e contatos

GetChats, GetChat, SearchPublicChat e GetUser expõem a agenda de contatos do Telegram e os canais/grupos dos quais você participa como respostas tipadas.

Stream de updates

OnEvent entrega todo evento updateXxx do TDLib — novas mensagens, digitação de usuário, posts de canal, edições, exclusões — como nome do evento bruto mais JSON para roteamento posterior, além dos eventos tipados OnMessageText, OnNewChat e OnNewCallbackQuery para os casos mais comuns.

TDLib nativo

Usa o tdjson.dll / libtdjson.so / libtdjson.dylib oficial — as mesmas garantias de criptografia ponta a ponta do cliente Telegram oficial.

Multiplataforma

O TDLib é distribuído para Windows, macOS, Linux, Android e iOS. O componente localiza e carrega a biblioteca nativa automaticamente em cada plataforma; você só precisa cuidar da ponte tipada por meio dos eventos e métodos acima.

Especificações e referências

Fontes oficiais para a API que este componente implementa.

Documentação e demos

Acesse a referência do componente, baixe o projeto de demonstração pronto para executar e obtenha a versão de avaliação.

Ajuda online — API_Telegram Referência completa de propriedades, métodos e eventos deste componente.
Projeto de demonstração — Demos\50.Other\01.Telegram_Client Projeto de exemplo pronto para executar. Vem dentro do pacote sgcWebSockets — baixe a versão de avaliação abaixo.
Documento técnico (PDF) Recursos, início rápido, exemplos de código para Delphi e C++ Builder e referências oficiais — apenas este componente.
Manual do usuário (PDF) Manual completo cobrindo cada componente da biblioteca.
Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Pronto para criar um cliente Telegram?

Baixe a avaliação gratuita e adicione mensageria Telegram às suas aplicações Delphi.