Everything sgcSocial does, mapped across the two client components and the APIs they implement. Every capability works the same in Delphi and C++ Builder, and every license ships full source code. Click a component for its own page with usage and examples.
Full client on the official TDLib
Business Cloud API
Webhook server and real-time updates
Delphi 7 to 13, C++ Builder
sgcSocial is self-contained. It ships with the sgcWebSockets Core runtime bundled in, so it is not an add-on.
Also inside sgcWebSockets. The Telegram client also ships inside sgcWebSockets editions from Standard up, and the WhatsApp client from Professional up. All-Access includes everything. sgcSocial is the standalone package for teams that only need the messaging clients.
Two messaging networks, registered on the SGC Social palette page.
| Component | Class | Network | Description |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | Full Telegram client on the official TDLib: user accounts and bots, chats and groups, media, inline keyboards, payments and proxies. |
| WhatsApp Client | TsgcWhatsApp_Client | WhatsApp Business Cloud API client: text, media, templates and interactive messages, plus a built-in webhook server for inbound events. |
TsgcTDLib_Telegram is built on the official TDLib (Telegram Database Library), so it signs in as a user account or as a bot and reaches the whole Telegram feature set.
| Capability | API | Notes |
|---|---|---|
| Sign in as a user | Telegram.PhoneNumber | Phone-number authentication: OnAuthenticationCode asks for the login code, OnAuthenticationPassword handles the 2FA password and OnRegisterUser covers new accounts. |
| Sign in as a bot | Telegram.BotToken | The same component drives bot accounts through TDLib, with the full client surface rather than the Bot API subset. |
| API credentials | Telegram.API.ApiId, Telegram.API.ApiHash | Issued for your application at my.telegram.org. |
| Connection state | OnConnectionStatus, OnAuthorizationStatus | Raw TDLib state strings, such as authorizationStateReady. |
| Send text | SendTextMessage, SendRichTextMessage | Plain and rich text to any chat id. |
| Send media | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Files, photos and videos, with SendMessageAlbum for grouped media. |
| Payments | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | The Telegram payments flow, end to end. |
| Edit and manage | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | The message lifecycle after sending. |
| Chats and groups | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Create and join conversations programmatically. |
| Secret chats | CreateNewSecretChat | TDLib handles Telegram secret chats, the end-to-end encrypted kind. |
| Search | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Across your chats, messages, contacts and public channels. |
| Files | DownloadFile | Downloads any file TDLib references by id. |
| Inline keyboards | AnswerCallbackQuery, OnNewCallbackQuery | Callback and URL buttons attached to messages you send. |
| Reply keyboards | Keyboard markup on the send methods | Text buttons, request-location buttons and request-phone-number buttons. |
| Inline queries | AnswerInlineQuery | Answer inline queries addressed to your bot. |
| Message events | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Typed inbound messages, plus OnMessageSponsored and OnNewChat. |
| Raw escape hatch | SendCustomRequest, OnEvent | Send any TDLib JSON request and observe every raw update. |
| Proxies | HTTP, SOCKS5, MTProto | Route the TDLib connection through a proxy. |
TsgcWhatsApp_Client talks to the Meta Graph API over plain HTTPS, so there is no native library to deploy and every Delphi platform is covered.
| Capability | API | Notes |
|---|---|---|
| Cloud API setup | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | The two values from your Meta application. Every call is a plain HTTPS request to the Graph API. |
| Text | SendMessageText | Text to any WhatsApp number. |
| Media by public link | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | The media lives at a public URL. |
| Media from a local file | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | The component uploads the local file first, then sends it. |
| Reactions | SendMessageReaction | React to a received message id with an emoji. |
| Location and contacts | SendMessageLocation, SendMessageContact | Coordinates with a name and address, and contact cards. |
| Interactive messages | SendMessageInteractiveList, SendMessageInteractiveButtons | Selection lists and reply buttons. |
| Templates | SendMessageTemplate | Template name, language code and parameters. |
| Media management | UploadMedia, DownloadMedia, DeleteMedia | Work with the Cloud API media store directly. |
| Read receipts | MarkMessageRead | Mark an inbound message as read. |
| Outbound hook | OnBeforeSendMessage | Inspect a message before it is sent. |
| TLS and logging | TLSOptions, file logging | TLS configuration for the HTTPS calls, and a file log of the traffic. |
WhatsApp pushes inbound traffic to a webhook, which the component hosts for you. Telegram needs no webhook at all, TDLib keeps its own connection and raises events.
| Area | Detail |
|---|---|
| WhatsApp webhook endpoint | StartServer and StopServer host the Meta webhook inside your own process, configured through ServerOptions: IP, port, SSL certificate, endpoint path and verify token. |
| Webhook verification | OnBeforeSubscribe fires on Meta's verification request, so the endpoint answers the subscription handshake. |
| Inbound WhatsApp messages | OnMessageReceived delivers each inbound message, with a var aMarkAsRead argument to send the read receipt. |
| Delivery status | OnMessageSent reports the status of messages you sent. |
| Raw payloads | OnRawMessage exposes the webhook JSON exactly as Meta posted it. |
| Telegram updates | No webhook needed. TDLib keeps its own connection to Telegram, and new messages arrive as events: OnMessageText, OnMessageDocument, OnMessagePhoto and OnMessageVideo. |
| Other Telegram events | OnNewChat, OnNewCallbackQuery and OnMessageSponsored cover new chats, keyboard callbacks and sponsored messages. |
| Raw Telegram events | OnEvent delivers every TDLib update as raw JSON. |
Official APIs, and the same source across every supported compiler.
| Area | Detail |
|---|---|
| Telegram | The official TDLib (Telegram Database Library), Telegram's own client library. |
| The WhatsApp Business Cloud API, part of the Meta Graph API, over HTTPS. | |
| Telegram platforms | Through the native TDLib library: Windows, macOS, Linux 64-bit, Android and iOS. |
| WhatsApp platforms | Pure HTTPS, so every Delphi platform is covered. |
| Compilers | Delphi and C++ Builder 7 through 13. |
| Editions | The Telegram client also ships inside sgcWebSockets from Standard up, the WhatsApp client from Professional up, and All-Access includes everything. |
| Licensing | Standalone. The sgcWebSockets Core runtime is bundled in and full source code is included. |