Alles wat sgcSocial doet, uitgesplitst over de twee clientcomponenten en de API's die ze implementeren. Elke mogelijkheid werkt hetzelfde in Delphi en C++ Builder, en elke licentie bevat de volledige broncode. Klik op een component voor de eigen pagina met gebruik en voorbeelden.
Volledige client op de officiële TDLib
Business Cloud API
Webhookserver en realtime updates
Delphi 7 tot 13, C++ Builder
sgcSocial is zelfstandig. Het wordt geleverd met de sgcWebSockets Core runtime inbegrepen, dus het is geen add-on.
Ook in sgcWebSockets. De Telegram-client zit ook in sgcWebSockets-edities vanaf Standard, en de WhatsApp-client vanaf Professional. All-Access bevat alles. sgcSocial is het standalone package voor teams die alleen de messagingclients nodig hebben.
Twee berichtennetwerken, geregistreerd op de paletpagina SGC Social.
| Component | Klasse | Netwerk | Beschrijving |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | Volledige Telegram-client op de officiële TDLib: gebruikersaccounts en bots, chats en groepen, media, inline keyboards, betalingen en proxy's. |
| WhatsApp Client | TsgcWhatsApp_Client | WhatsApp Business Cloud API-client: tekst, media, templates en interactieve berichten, plus een ingebouwde webhookserver voor inkomende events. |
TsgcTDLib_Telegram is gebouwd op de officiële TDLib (Telegram Database Library), dus het meldt zich aan als gebruikersaccount of als bot en bereikt de complete Telegram-functieset.
| Mogelijkheid | API | Opmerkingen |
|---|---|---|
| Aanmelden als gebruiker | Telegram.PhoneNumber | Telefoonnummerauthenticatie: OnAuthenticationCode vraagt om de inlogcode, OnAuthenticationPassword handelt het 2FA-wachtwoord af en OnRegisterUser dekt nieuwe accounts. |
| Aanmelden als bot | Telegram.BotToken | Hetzelfde component stuurt botaccounts aan via TDLib, met het volledige clientoppervlak in plaats van de Bot API-subset. |
| API-inloggegevens | Telegram.API.ApiId, Telegram.API.ApiHash | Uitgegeven voor je toepassing op my.telegram.org. |
| Verbindingsstatus | OnConnectionStatus, OnAuthorizationStatus | Rauwe TDLib-statusstrings, zoals authorizationStateReady. |
| Tekst versturen | SendTextMessage, SendRichTextMessage | Platte en rich text naar elke chat-id. |
| Media versturen | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Bestanden, foto's en video's, met SendMessageAlbum voor gegroepeerde media. |
| Betalingen | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | De volledige Telegram-betalingsflow, van begin tot eind. |
| Bewerken en beheren | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | De levenscyclus van het bericht na het versturen. |
| Chats en groepen | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Maak en join gesprekken programmatisch. |
| Secret chats | CreateNewSecretChat | TDLib handelt Telegram secret chats af, de eind-tot-eind versleutelde variant. |
| Zoeken | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Door je chats, berichten, contacten en publieke kanalen. |
| Bestanden | DownloadFile | Downloadt elk bestand dat TDLib via een id aanduidt. |
| Inline keyboards | AnswerCallbackQuery, OnNewCallbackQuery | Callback- en URL-knoppen die aan verstuurde berichten hangen. |
| Reply keyboards | Keyboard-markup op de verzendmethoden | Tekstknoppen, request-location-knoppen en request-phone-number-knoppen. |
| Inline queries | AnswerInlineQuery | Beantwoord inline queries die aan je bot zijn gericht. |
| Berichtevents | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Getypeerde inkomende berichten, plus OnMessageSponsored en OnNewChat. |
| Rauwe escape hatch | SendCustomRequest, OnEvent | Verstuur elke TDLib JSON-request en observeer elke rauwe update. |
| Proxy's | HTTP, SOCKS5, MTProto | Leid de TDLib-verbinding via een proxy. |
TsgcWhatsApp_Client spreekt met de Meta Graph API over gewone HTTPS, dus er is geen native bibliotheek nodig en elk Delphi-platform is gedekt.
| Mogelijkheid | API | Opmerkingen |
|---|---|---|
| Cloud API-instellingen | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | De twee waarden uit je Meta-toepassing. Elke aanroep is een gewone HTTPS-request naar de Graph API. |
| Tekst | SendMessageText | Tekst naar elk WhatsApp-nummer. |
| Media via publieke link | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | De media staat op een publieke URL. |
| Media vanaf een lokaal bestand | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | Het component uploadt eerst het lokale bestand en verstuurt het daarna. |
| Reacties | SendMessageReaction | Reageer op een ontvangen bericht-id met een emoji. |
| Locatie en contacten | SendMessageLocation, SendMessageContact | Coördinaten met een naam en adres, en contactkaarten. |
| Interactieve berichten | SendMessageInteractiveList, SendMessageInteractiveButtons | Selectielijsten en replyknoppen. |
| Templates | SendMessageTemplate | Templatenaam, taalcode en parameters. |
| Mediabeheer | UploadMedia, DownloadMedia, DeleteMedia | Werk rechtstreeks met de mediaopslag van de Cloud API. |
| Leesbevestigingen | MarkMessageRead | Markeer een inkomend bericht als gelezen. |
| Uitgaande hook | OnBeforeSendMessage | Inspecteer een bericht voordat het wordt verstuurd. |
| TLS en logging | TLSOptions, bestandslogging | TLS-configuratie voor de HTTPS-aanroepen, en een bestandslog van het verkeer. |
WhatsApp pusht inkomend verkeer naar een webhook, die het component voor je host. Telegram heeft helemaal geen webhook nodig, TDLib houdt zijn eigen verbinding open en geeft events af.
| Gebied | Detail |
|---|---|
| WhatsApp-webhookendpoint | StartServer en StopServer hosten de webhook van Meta binnen je eigen proces, geconfigureerd via ServerOptions: IP, poort, SSL-certificaat, endpointpad en verify-token. |
| Webhookverificatie | OnBeforeSubscribe triggert bij de verificatierequest van Meta, zodat het endpoint de abonnementshandshake beantwoordt. |
| Inkomende WhatsApp-berichten | OnMessageReceived levert elk inkomend bericht af, met een var aMarkAsRead-argument om de leesbevestiging te versturen. |
| Afleveringsstatus | OnMessageSent meldt de status van berichten die je hebt verstuurd. |
| Rauwe payloads | OnRawMessage geeft de webhook-JSON precies zoals Meta die heeft gepost. |
| Telegram-updates | Geen webhook nodig. TDLib houdt zijn eigen verbinding met Telegram open, en nieuwe berichten komen binnen als events: OnMessageText, OnMessageDocument, OnMessagePhoto en OnMessageVideo. |
| Overige Telegram-events | OnNewChat, OnNewCallbackQuery en OnMessageSponsored dekken nieuwe chats, keyboardcallbacks en gesponsorde berichten. |
| Rauwe Telegram-events | OnEvent levert elke TDLib-update als rauwe JSON. |
Officiële API's, en dezelfde broncode voor elke ondersteunde compiler.
| Gebied | Detail |
|---|---|
| Telegram | De officiële TDLib (Telegram Database Library), Telegrams eigen clientbibliotheek. |
| De WhatsApp Business Cloud API, onderdeel van de Meta Graph API, over HTTPS. | |
| Telegram-platforms | Via de native TDLib-bibliotheek: Windows, macOS, Linux 64-bit, Android en iOS. |
| WhatsApp-platforms | Pure HTTPS, dus elk Delphi-platform is gedekt. |
| Compilers | Delphi en C++ Builder 7 tot en met 13. |
| Edities | De Telegram-client zit ook in sgcWebSockets vanaf Standard, de WhatsApp-client vanaf Professional, en All-Access bevat alles. |
| Licenties | Standalone. De sgcWebSockets Core runtime is meegeleverd en de volledige broncode is inbegrepen. |