Alles, was sgcSocial kann, aufgeschlüsselt nach den zwei Client-Komponenten und den APIs, die sie umsetzen. Jede Funktion arbeitet in Delphi und C++ Builder identisch, und jede Lizenz enthält den vollständigen Quellcode. Klicke auf eine Komponente, um ihre eigene Seite mit Nutzung und Beispielen zu öffnen.
Vollständiger Client auf der offiziellen TDLib
Business Cloud API
Webhook-Server und Echtzeit-Updates
Delphi 7 bis 13, C++ Builder
sgcSocial ist in sich geschlossen. Es bringt die sgcWebSockets Core Runtime mit, es ist also kein Add-on.
Auch in sgcWebSockets enthalten. Der Telegram-Client ist außerdem ab der Standard-Edition in sgcWebSockets enthalten, der WhatsApp-Client ab Professional. All-Access enthält alles. sgcSocial ist das eigenständige Paket für Teams, die nur die Messaging-Clients brauchen.
Zwei Messaging-Netzwerke, registriert auf der Palettenseite SGC Social.
| Komponente | Klasse | Netzwerk | Beschreibung |
|---|---|---|---|
| Telegram-Client | TsgcTDLib_Telegram | Telegram | Vollständiger Telegram-Client auf der offiziellen TDLib: Benutzerkonten und Bots, Chats und Gruppen, Medien, Inline-Keyboards, Zahlungen und Proxys. |
| WhatsApp-Client | TsgcWhatsApp_Client | WhatsApp-Business-Cloud-API-Client: Text, Medien, Templates und interaktive Nachrichten, dazu ein eingebauter Webhook-Server für eingehende Ereignisse. |
TsgcTDLib_Telegram baut auf der offiziellen TDLib (Telegram Database Library) auf, meldet sich also als Benutzerkonto oder als Bot an und erreicht den gesamten Funktionsumfang von Telegram.
| Funktion | API | Hinweise |
|---|---|---|
| Als Benutzer anmelden | Telegram.PhoneNumber | Authentifizierung per Telefonnummer: OnAuthenticationCode fragt nach dem Anmeldecode, OnAuthenticationPassword behandelt das 2FA-Passwort und OnRegisterUser deckt neue Konten ab. |
| Als Bot anmelden | Telegram.BotToken | Dieselbe Komponente steuert Bot-Konten über TDLib, mit der vollen Client-Oberfläche statt der Teilmenge der Bot API. |
| API-Zugangsdaten | Telegram.API.ApiId, Telegram.API.ApiHash | Werden für deine Anwendung auf my.telegram.org ausgestellt. |
| Verbindungsstatus | OnConnectionStatus, OnAuthorizationStatus | Rohe TDLib-Statuszeichenfolgen, zum Beispiel authorizationStateReady. |
| Text senden | SendTextMessage, SendRichTextMessage | Einfacher und formatierter Text an jede Chat-ID. |
| Medien senden | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Dateien, Fotos und Videos, mit SendMessageAlbum für gruppierte Medien. |
| Zahlungen | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | Der komplette Telegram-Zahlungsablauf, von Anfang bis Ende. |
| Bearbeiten und verwalten | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | Der Lebenszyklus einer Nachricht nach dem Senden. |
| Chats und Gruppen | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Konversationen programmatisch erstellen und beitreten. |
| Geheime Chats | CreateNewSecretChat | TDLib verwaltet Telegrams geheime Chats, die Ende-zu-Ende-verschlüsselte Variante. |
| Suche | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Über deine Chats, Nachrichten, Kontakte und öffentlichen Kanäle hinweg. |
| Dateien | DownloadFile | Lädt jede Datei herunter, auf die TDLib per ID verweist. |
| Inline-Keyboards | AnswerCallbackQuery, OnNewCallbackQuery | Callback- und URL-Buttons, die an von dir gesendete Nachrichten angehängt werden. |
| Reply-Keyboards | Keyboard-Markup an den Sendemethoden | Text-Buttons, Buttons für Standortanfragen und Buttons für Telefonnummernanfragen. |
| Inline-Abfragen | AnswerInlineQuery | Beantworte Inline-Abfragen, die an deinen Bot gerichtet sind. |
| Nachrichten-Ereignisse | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Typisierte eingehende Nachrichten, dazu OnMessageSponsored und OnNewChat. |
| Roher Zugriff | SendCustomRequest, OnEvent | Sende jede beliebige TDLib-JSON-Anfrage und beobachte jedes rohe Update. |
| Proxys | HTTP, SOCKS5, MTProto | Leite die TDLib-Verbindung über einen Proxy. |
TsgcWhatsApp_Client spricht die Meta Graph API über reines HTTPS, es gibt also keine native Bibliothek auszuliefern, und jede Delphi-Plattform ist abgedeckt.
| Funktion | API | Hinweise |
|---|---|---|
| Cloud-API-Einrichtung | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | Die beiden Werte aus deiner Meta-Anwendung. Jeder Aufruf ist eine reine HTTPS-Anfrage an die Graph API. |
| Text | SendMessageText | Text an jede WhatsApp-Nummer. |
| Medien über öffentlichen Link | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | Das Medium liegt unter einer öffentlichen URL. |
| Medien aus einer lokalen Datei | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | Die Komponente lädt zuerst die lokale Datei hoch und sendet sie dann. |
| Reaktionen | SendMessageReaction | Reagiere mit einem Emoji auf die ID einer empfangenen Nachricht. |
| Standort und Kontakte | SendMessageLocation, SendMessageContact | Koordinaten mit Name und Adresse, sowie Kontaktkarten. |
| Interaktive Nachrichten | SendMessageInteractiveList, SendMessageInteractiveButtons | Auswahllisten und Antwort-Buttons. |
| Templates | SendMessageTemplate | Template-Name, Sprachcode und Parameter. |
| Medienverwaltung | UploadMedia, DownloadMedia, DeleteMedia | Arbeite direkt mit dem Medienspeicher der Cloud API. |
| Lesebestätigungen | MarkMessageRead | Markiere eine eingehende Nachricht als gelesen. |
| Ausgehender Hook | OnBeforeSendMessage | Untersuche eine Nachricht, bevor sie gesendet wird. |
| TLS und Logging | TLSOptions, Datei-Logging | TLS-Konfiguration für die HTTPS-Aufrufe, und ein Datei-Log des Datenverkehrs. |
WhatsApp schiebt eingehenden Datenverkehr an einen Webhook, den die Komponente für dich hostet. Telegram braucht überhaupt keinen Webhook, TDLib hält seine eigene Verbindung und löst Ereignisse aus.
| Bereich | Detail |
|---|---|
| WhatsApp-Webhook-Endpunkt | StartServer und StopServer hosten den Meta-Webhook innerhalb deines eigenen Prozesses, konfiguriert über ServerOptions: IP, Port, SSL-Zertifikat, Endpunktpfad und Verify-Token. |
| Webhook-Verifizierung | OnBeforeSubscribe löst bei Metas Verifizierungsanfrage aus, sodass der Endpunkt den Abonnement-Handshake beantwortet. |
| Eingehende WhatsApp-Nachrichten | OnMessageReceived liefert jede eingehende Nachricht, mit einem var-Argument aMarkAsRead, das die Lesebestätigung sendet. |
| Zustellstatus | OnMessageSent meldet den Status der von dir gesendeten Nachrichten. |
| Rohe Payloads | OnRawMessage legt das Webhook-JSON genau so offen, wie Meta es gepostet hat. |
| Telegram-Updates | Kein Webhook nötig. TDLib hält seine eigene Verbindung zu Telegram, und neue Nachrichten kommen als Ereignisse an: OnMessageText, OnMessageDocument, OnMessagePhoto und OnMessageVideo. |
| Weitere Telegram-Ereignisse | OnNewChat, OnNewCallbackQuery und OnMessageSponsored decken neue Chats, Keyboard-Callbacks und gesponserte Nachrichten ab. |
| Rohe Telegram-Ereignisse | OnEvent liefert jedes TDLib-Update als rohes JSON. |
Offizielle APIs, und derselbe Quellcode über jeden unterstützten Compiler hinweg.
| Bereich | Detail |
|---|---|
| Telegram | Die offizielle TDLib (Telegram Database Library), Telegrams eigene Client-Bibliothek. |
| Die WhatsApp Business Cloud API, Teil der Meta Graph API, über HTTPS. | |
| Telegram-Plattformen | Über die native TDLib-Bibliothek: Windows, macOS, Linux 64-Bit, Android und iOS. |
| WhatsApp-Plattformen | Reines HTTPS, jede Delphi-Plattform ist also abgedeckt. |
| Compiler | Delphi und C++ Builder 7 bis 13. |
| Editionen | Der Telegram-Client ist außerdem ab der Standard-Edition in sgcWebSockets enthalten, der WhatsApp-Client ab Professional, und All-Access enthält alles. |
| Lizenzierung | Eigenständig. Die sgcWebSockets Core Runtime ist mitgeliefert und der vollständige Quellcode ist enthalten. |