Client API Telegram per Delphi e C++ Builder | eSeGeCe

Client TDLib Telegram

Crea applicazioni Telegram per account utente o bot in Delphi/C++Builder. Incapsula l'ufficiale TDLib di Telegram per esporre autenticazione, chat, messaggi ed eventi di aggiornamento.

TsgcTDLib_Telegram

Wrapper Delphi/C++Builder per l'ufficiale TDLib di Telegram (tdjson). Gestisce la macchina a stati di autenticazione, espone eventi tipizzati per l'invio/ricezione dei messaggi e consegna ogni altro aggiornamento TDLib tramite OnEvent.

Classe del componente

TsgcTDLib_Telegram

Protocollo

Telegram TDLib

Piattaforme

Windows, macOS, Linux, iOS, Android

Edizione

Standard / Professional / Enterprise

Imposta TDLib, autenticati, invia messaggi

Imposta Telegram.API.ApiId / ApiHash e Telegram.PhoneNumber, collega OnAuthenticationCode per il flusso di accesso, quindi invia messaggi non appena OnAuthorizationStatus segnala 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!");
}

Cosa contiene

Una facciata Delphi sulla libreria condivisa ufficiale TDLib (tdjson) — lo stesso protocollo che usano i client ufficiali Telegram.

Flusso di autenticazione

Il componente guida la macchina a stati di autenticazione TDLib: numero di telefono, codice, password 2FA opzionale, e persiste la sessione nella directory del database locale.

Invio di messaggi

SendTextMessage, SendPhotoMessage, SendVideoMessage, SendDocumentMessage e SendMessageAlbum coprono i principali tipi di contenuto dei messaggi TDLib.

Chat e contatti

GetChats, GetChat, SearchPublicChat e GetUser espongono la rubrica Telegram e i canali/gruppi a cui partecipi come risposte tipizzate.

Stream di aggiornamenti

OnEvent consegna ogni evento TDLib updateXxx — nuovi messaggi, utente che scrive, post su canali, modifiche, eliminazioni — come nome dell'evento grezzo più JSON per il routing a valle, insieme agli eventi tipizzati OnMessageText, OnNewChat e OnNewCallbackQuery per i casi più comuni.

TDLib nativo

Usa l'ufficiale tdjson.dll / libtdjson.so / libtdjson.dylib — le stesse garanzie di crittografia end-to-end del client Telegram ufficiale.

Multipiattaforma

TDLib viene rilasciato per Windows, macOS, Linux, Android e iOS. Il componente individua e carica automaticamente la libreria nativa per ciascuna piattaforma; tu gestisci solo il bridging tipizzato tramite gli eventi e i metodi sopra descritti.

Specifiche e riferimenti

Fonti autorevoli per l'API che questo componente implementa.

Documentazione e demo

Collegamenti diretti al riferimento del componente, progetto demo pronto all'uso e download della versione di prova.

Guida online — API_Telegram Riferimento completo di proprietà, metodi ed eventi di questo componente.
Progetto demo — Demos\50.Other\01.Telegram_Client Progetto di esempio pronto all'uso. Incluso nel pacchetto sgcWebSockets — scarica la versione di prova qui sotto.
Documento tecnico (PDF) Funzionalità, guida rapida, esempi di codice per Delphi e C++ Builder e riferimenti alle fonti primarie — solo questo componente.
Manuale utente (PDF) Manuale completo che copre ogni componente della libreria.
La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Pronto a creare un client Telegram?

Scarica la versione di prova gratuita e aggiungi la messaggistica Telegram alle tue applicazioni Delphi.