La famille de composants sgcTelegram associe la puissance de la bibliothèque officielle Telegram Database Library à la productivité rapide de Delphi. Cet article décrit comment configurer et intégrer le composant dans tes applications, présente des cas d'usage commerciaux et met en avant pourquoi c'est un atout stratégique pour tes flux de communication.
Pourquoi choisir sgcTelegram pour Delphi
- Engagement utilisateur haut de gamme : livre des alertes en temps réel, des notifications transactionnelles et des bots conversationnels sans quitter ton écosystème Delphi.
- Sécurité de niveau entreprise : chiffrement de bout en bout natif et journalisation conforme via TDLib pour garantir que ta solution de messagerie réponde aux exigences métier les plus strictes.
- Évolutivité multiplateforme : cible Windows, macOS, Linux, iOS et Android avec la même API de composant, simplifiant les feuilles de route produit et réduisant les coûts de maintenance.
- Faible latence : la gestion asynchrone des événements garde tes applications réactives, un atout clé pour les tableaux de bord de trading, les consoles de support client et les hubs de télémétrie IoT.
Étapes de configuration dans Delphi
Suis ces étapes pour déposer le composant sur une fiche VCL ou FMX et la préparer pour la production :
- Installe le package sgcWebSockets et ajoute les unités sgcTelegram à ton projet.
- Place un composant TsgcTelegramClient sur la fiche. Définis DatabasePath sur un dossier accessible en écriture où TDLib peut stocker les caches chiffrés.
- Configure tes identifiants API Telegram. Affecte ApiId et ApiHash obtenus depuis my.telegram.org.
- Renseigne les propriétés ApplicationVersion, DeviceModel et SystemLanguageCode pour respecter les exigences de la plateforme Telegram.
- Branche-toi sur les événements de cycle de vie (OnAuthorizationState, OnUpdateConnectionState, OnNewMessage) pour authentifier, surveiller et répondre aux mises à jour entrantes.
- Appelle Connect à l'exécution pour initier la session TDLib et piloter le flux d'authentification (numéro de téléphone, code SMS ou jeton de bot).
Exemple de code Delphi
L'exemple suivant illustre une console de notification de qualité commerciale qui se connecte en tant que bot, envoie un message de bienvenue et stocke les réponses des clients :
procedure TfrmTelegram.ConsoleAuthorize;
begin
sgcTelegramClient1.Manager.LibraryPath := IncludeTrailingPathDelimiter(ExtractFilePath(ParamStr(0))) + 'tdlib';
sgcTelegramClient1.Manager.DatabasePath := GetHomePath + PathDelim + 'TelegramCache';
sgcTelegramClient1.ApiId := <YOUR_API_ID>;
sgcTelegramClient1.ApiHash := '<YOUR_API_HASH>';
sgcTelegramClient1.PhoneNumber := '<COMPANY_BOT_TOKEN>';
sgcTelegramClient1.ApplicationVersion := '2.0';
sgcTelegramClient1.DeviceModel := 'Retail Notification Hub';
sgcTelegramClient1.SystemLanguageCode := 'en';
sgcTelegramClient1.Options.UseTestDataCenter := False;
sgcTelegramClient1.Connect;
end;
procedure TfrmTelegram.sgcTelegramClient1AuthorizationState(Sender: TObject;
const AState: TsgcTelegramAuthorizationState);
begin
if AState.State = asReady then
begin
sgcTelegramClient1.Messages.SendMessage('<CUSTOMER_CHAT_ID>', 'Your order has shipped! Track it via our portal.');
end;
end;
procedure TfrmTelegram.sgcTelegramClient1NewMessage(Sender: TObject;
const AMessage: TsgcTelegramMessage);
begin
MemoConsole.Lines.Add(Format('[%s] %s', [DateTimeToStr(Now), AMessage.Content.Text.Text]));
end;
Cet extrait illustre comment configurer les chemins du système de fichiers, les identifiants et les gestionnaires d'événements. Remplace les espaces réservés par ton jeton de bot de production et les identifiants de discussion.
Avantages pour les équipes Delphi
- Modèle de composant unifié : éditeurs de propriétés, inspecteurs à la conception et LiveBindings permettent un prototypage rapide sans code REST passe-partout.
- Large couverture de protocoles : réutilise le même framework sgcWebSockets pour les intégrations HTTP/2, MQTT et WebSocket, garantissant une architecture cohérente entre les services.
- Support professionnel : les mises à jour prioritaires et l'assistance d'experts raccourcissent les délais des projets et réduisent le risque technique.
Inclus le composant Telegram dans ta prochaine version pour valoriser les communications avec tes clients, accélérer la livraison des fonctionnalités et débloquer de nouvelles sources de revenus. Contacte notre équipe commerciale pour des offres de licences groupées ou des prestations de conseil personnalisées adaptées à ton secteur.