Tout ce que fait sgcSocial, réparti sur les deux composants clients et les API qu'ils implémentent. Chaque capacité fonctionne de la même façon en Delphi et en C++ Builder, et chaque licence est livrée avec le code source complet. Clique sur un composant pour ouvrir sa page dédiée avec son utilisation et des exemples.
Client complet sur le TDLib officiel
API Business Cloud
Serveur webhook et mises à jour en temps réel
Delphi 7 à 13, C++ Builder
sgcSocial est autonome. Il est livré avec le runtime sgcWebSockets Core inclus, ce n'est donc pas un complément.
Aussi dans sgcWebSockets. Le client Telegram est aussi livré dans les éditions sgcWebSockets à partir de Standard, et le client WhatsApp à partir de Professional. All-Access inclut tout. sgcSocial est le package autonome pour les équipes qui n'ont besoin que des clients de messagerie.
Deux réseaux de messagerie, enregistrés sur la page de palette SGC Social.
| Composant | Classe | Réseau | Description |
|---|---|---|---|
| Client Telegram | TsgcTDLib_Telegram | Telegram | Client Telegram complet sur le TDLib officiel : comptes utilisateurs et bots, discussions et groupes, médias, claviers inline, paiements et proxys. |
| Client WhatsApp | TsgcWhatsApp_Client | Client WhatsApp Business Cloud API : texte, médias, modèles et messages interactifs, plus un serveur webhook intégré pour les événements entrants. |
TsgcTDLib_Telegram est bâti sur le TDLib officiel (Telegram Database Library), il se connecte donc comme un compte utilisateur ou comme un bot et atteint tout l'éventail des fonctionnalités de Telegram.
| Capacité | API | Notes |
|---|---|---|
| Se connecter comme utilisateur | Telegram.PhoneNumber | Authentification par numéro de téléphone : OnAuthenticationCode demande le code de connexion, OnAuthenticationPassword gère le mot de passe 2FA et OnRegisterUser couvre les nouveaux comptes. |
| Se connecter comme bot | Telegram.BotToken | Le même composant pilote les comptes bot via TDLib, avec la surface complète du client plutôt que le sous-ensemble de l'API Bot. |
| Identifiants API | Telegram.API.ApiId, Telegram.API.ApiHash | Délivrés pour ton application sur my.telegram.org. |
| État de connexion | OnConnectionStatus, OnAuthorizationStatus | Chaînes d'état TDLib brutes, telles que authorizationStateReady. |
| Envoyer du texte | SendTextMessage, SendRichTextMessage | Texte simple et enrichi vers n'importe quel identifiant de discussion. |
| Envoyer des médias | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Fichiers, photos et vidéos, avec SendMessageAlbum pour les médias groupés. |
| Paiements | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | Le flux de paiement Telegram, de bout en bout. |
| Modifier et gérer | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | Le cycle de vie du message après l'envoi. |
| Discussions et groupes | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Créer et rejoindre des conversations par programmation. |
| Discussions secrètes | CreateNewSecretChat | TDLib gère les discussions secrètes Telegram, celles chiffrées de bout en bout. |
| Recherche | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Dans tes discussions, messages, contacts et canaux publics. |
| Fichiers | DownloadFile | Télécharge tout fichier référencé par TDLib via son identifiant. |
| Claviers inline | AnswerCallbackQuery, OnNewCallbackQuery | Boutons de rappel et d'URL attachés aux messages que tu envoies. |
| Claviers de réponse | Balisage de clavier sur les méthodes d'envoi | Boutons texte, boutons de demande de position et de demande de numéro de téléphone. |
| Requêtes inline | AnswerInlineQuery | Répondre aux requêtes inline adressées à ton bot. |
| Événements de message | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Messages entrants typés, plus OnMessageSponsored et OnNewChat. |
| Échappatoire brute | SendCustomRequest, OnEvent | Envoie n'importe quelle requête JSON TDLib et observe chaque mise à jour brute. |
| Proxys | HTTP, SOCKS5, MTProto | Achemine la connexion TDLib via un proxy. |
TsgcWhatsApp_Client parle à l'API Graph de Meta en HTTPS pur, il n'y a donc aucune bibliothèque native à déployer et chaque plateforme Delphi est couverte.
| Capacité | API | Notes |
|---|---|---|
| Configuration de l'API Cloud | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | Les deux valeurs issues de ton application Meta. Chaque appel est une requête HTTPS simple vers l'API Graph. |
| Texte | SendMessageText | Texte vers n'importe quel numéro WhatsApp. |
| Média par lien public | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | Le média est hébergé à une URL publique. |
| Média depuis un fichier local | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | Le composant téléverse d'abord le fichier local, puis l'envoie. |
| Réactions | SendMessageReaction | Réagis à un identifiant de message reçu avec un emoji. |
| Position et contacts | SendMessageLocation, SendMessageContact | Coordonnées avec un nom et une adresse, et cartes de contact. |
| Messages interactifs | SendMessageInteractiveList, SendMessageInteractiveButtons | Listes de sélection et boutons de réponse. |
| Modèles | SendMessageTemplate | Nom du modèle, code de langue et paramètres. |
| Gestion des médias | UploadMedia, DownloadMedia, DeleteMedia | Travaille directement avec le stockage de médias de l'API Cloud. |
| Accusés de lecture | MarkMessageRead | Marque un message entrant comme lu. |
| Point d'accroche sortant | OnBeforeSendMessage | Inspecte un message avant qu'il soit envoyé. |
| TLS et journalisation | TLSOptions, journalisation fichier | Configuration TLS pour les appels HTTPS, et un journal fichier du trafic. |
WhatsApp pousse le trafic entrant vers un webhook, que le composant héberge à ta place. Telegram n'a besoin d'aucun webhook, TDLib maintient sa propre connexion et déclenche des événements.
| Domaine | Détail |
|---|---|
| Point de terminaison webhook WhatsApp | StartServer et StopServer hébergent le webhook Meta dans ton propre processus, configuré via ServerOptions : IP, port, certificat SSL, chemin du point de terminaison et jeton de vérification. |
| Vérification du webhook | OnBeforeSubscribe se déclenche sur la requête de vérification de Meta, le point de terminaison répond donc à la poignée de main d'abonnement. |
| Messages WhatsApp entrants | OnMessageReceived délivre chaque message entrant, avec un argument var aMarkAsRead pour envoyer l'accusé de lecture. |
| Statut de livraison | OnMessageSent rapporte le statut des messages que tu as envoyés. |
| Charges utiles brutes | OnRawMessage expose le JSON du webhook exactement comme Meta l'a publié. |
| Mises à jour Telegram | Aucun webhook nécessaire. TDLib maintient sa propre connexion à Telegram, et les nouveaux messages arrivent sous forme d'événements : OnMessageText, OnMessageDocument, OnMessagePhoto et OnMessageVideo. |
| Autres événements Telegram | OnNewChat, OnNewCallbackQuery et OnMessageSponsored couvrent les nouvelles discussions, les rappels de clavier et les messages sponsorisés. |
| Événements Telegram bruts | OnEvent délivre chaque mise à jour TDLib sous forme de JSON brut. |
Des API officielles, et le même source sur chaque compilateur pris en charge.
| Domaine | Détail |
|---|---|
| Telegram | Le TDLib officiel (Telegram Database Library), la bibliothèque cliente de Telegram lui-même. |
| L'API WhatsApp Business Cloud, qui fait partie de l'API Graph de Meta, en HTTPS. | |
| Plateformes Telegram | Via la bibliothèque native TDLib : Windows, macOS, Linux 64 bits, Android et iOS. |
| Plateformes WhatsApp | HTTPS pur, chaque plateforme Delphi est donc couverte. |
| Compilateurs | Delphi et C++ Builder 7 à 13. |
| Éditions | Le client Telegram est aussi livré dans sgcWebSockets à partir de Standard, le client WhatsApp à partir de Professional, et All-Access inclut tout. |
| Licence | Autonome. Le runtime sgcWebSockets Core est inclus et le code source complet est fourni. |