sgcSocial'ın yaptığı her şey, iki istemci bileşeni ve uyguladıkları API'ler üzerinden eşlenmiş. Her yetenek Delphi ve C++ Builder'da aynı şekilde çalışır ve her lisans tam kaynak koduyla gelir. Kullanım ve örnekleri içeren kendi sayfası için bir bileşene tıklayın.
Resmi TDLib üzerinde tam istemci
Business Cloud API
Webhook sunucusu ve gerçek zamanlı güncellemeler
Delphi 7'den 13'e, C++ Builder
sgcSocial kendi kendine yeterlidir. sgcWebSockets Core çalışma zamanı pakete dahil olarak gelir, bu yüzden bir eklenti değildir.
sgcWebSockets içinde de var. Telegram istemcisi ayrıca sgcWebSockets sürümlerinin içinde Standard sürümünden itibaren, WhatsApp istemcisi ise Professional sürümünden itibaren gelir. All-Access her şeyi içerir. sgcSocial, yalnızca mesajlaşma istemcilerine ihtiyaç duyan ekipler için bağımsız pakettir.
SGC Social palet sayfasına kayıtlı iki mesajlaşma ağı.
| Bileşen | Sınıf | Ağ | Açıklama |
|---|---|---|---|
| Telegram İstemcisi | TsgcTDLib_Telegram | Telegram | Resmi TDLib üzerinde tam Telegram istemcisi: kullanıcı hesapları ve botlar, sohbetler ve gruplar, medya, inline klavyeler, ödemeler ve proxy'ler. |
| WhatsApp İstemcisi | TsgcWhatsApp_Client | WhatsApp Business Cloud API istemcisi: metin, medya, şablon ve etkileşimli mesajlar, ayrıca gelen olaylar için yerleşik bir webhook sunucusu. |
TsgcTDLib_Telegram, resmi TDLib (Telegram Database Library) üzerine kuruludur; bu nedenle bir kullanıcı hesabı ya da bot olarak oturum açar ve Telegram'ın tüm özellik kümesine ulaşır.
| Yetenek | API | Notlar |
|---|---|---|
| Kullanıcı olarak oturum açma | Telegram.PhoneNumber | Telefon numarası kimlik doğrulama: OnAuthenticationCode giriş kodunu ister, OnAuthenticationPassword 2FA parolasını yönetir ve OnRegisterUser yeni hesapları kapsar. |
| Bot olarak oturum açma | Telegram.BotToken | Aynı bileşen, Bot API alt kümesi yerine tam istemci yüzeyiyle bot hesaplarını TDLib üzerinden yönetir. |
| API kimlik bilgileri | Telegram.API.ApiId, Telegram.API.ApiHash | my.telegram.org'da uygulamanız için verilir. |
| Bağlantı durumu | OnConnectionStatus, OnAuthorizationStatus | authorizationStateReady gibi ham TDLib durum dizeleri. |
| Metin gönderme | SendTextMessage, SendRichTextMessage | Herhangi bir sohbet kimliğine düz ve zengin metin. |
| Medya gönderme | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Dosyalar, fotoğraflar ve videolar; gruplanmış medya için SendMessageAlbum ile birlikte. |
| Ödemeler | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | Telegram ödeme akışı, uçtan uca. |
| Düzenleme ve yönetme | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | Gönderdikten sonraki mesaj yaşam döngüsü. |
| Sohbetler ve gruplar | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Konuşmaları program aracılığıyla oluşturun ve katılın. |
| Gizli sohbetler | CreateNewSecretChat | TDLib, uçtan uca şifrelenmiş türden olan Telegram gizli sohbetlerini yönetir. |
| Arama | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Sohbetleriniz, mesajlarınız, kişileriniz ve genel kanallar genelinde. |
| Dosyalar | DownloadFile | TDLib'in kimlikle referans verdiği her dosyayı indirir. |
| Inline klavyeler | AnswerCallbackQuery, OnNewCallbackQuery | Gönderdiğiniz mesajlara eklenen geri çağırma ve URL düğmeleri. |
| Yanıt klavyeleri | Gönderme metotları üzerindeki klavye biçimlendirmesi | Metin düğmeleri, konum isteme düğmeleri ve telefon numarası isteme düğmeleri. |
| Inline sorgular | AnswerInlineQuery | Botunuza yöneltilen inline sorguları yanıtlayın. |
| Mesaj olayları | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Tiplenmiş gelen mesajlar, ayrıca OnMessageSponsored ve OnNewChat. |
| Ham çıkış kapısı | SendCustomRequest, OnEvent | Herhangi bir TDLib JSON isteği gönderin ve her ham güncellemeyi gözlemleyin. |
| Proxy'ler | HTTP, SOCKS5, MTProto | TDLib bağlantısını bir proxy üzerinden yönlendirin. |
TsgcWhatsApp_Client, Meta Graph API'sini düz HTTPS üzerinden konuşur; bu yüzden dağıtılacak yerel bir kitaplık yoktur ve her Delphi platformu kapsanır.
| Yetenek | API | Notlar |
|---|---|---|
| Cloud API kurulumu | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | Meta uygulamanızdan gelen iki değer. Her çağrı, Graph API'ye düz bir HTTPS isteğidir. |
| Metin | SendMessageText | Herhangi bir WhatsApp numarasına metin. |
| Genel bağlantıyla medya | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | Medya, genel bir URL'de bulunur. |
| Yerel dosyadan medya | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | Bileşen önce yerel dosyayı yükler, ardından gönderir. |
| Tepkiler | SendMessageReaction | Alınan bir mesaj kimliğine bir emoji ile tepki verin. |
| Konum ve kişiler | SendMessageLocation, SendMessageContact | Ad ve adresle koordinatlar, ayrıca kişi kartları. |
| Etkileşimli mesajlar | SendMessageInteractiveList, SendMessageInteractiveButtons | Seçim listeleri ve yanıt düğmeleri. |
| Şablonlar | SendMessageTemplate | Şablon adı, dil kodu ve parametreler. |
| Medya yönetimi | UploadMedia, DownloadMedia, DeleteMedia | Cloud API medya deposuyla doğrudan çalışın. |
| Okundu bilgileri | MarkMessageRead | Gelen bir mesajı okundu olarak işaretleyin. |
| Giden kanca | OnBeforeSendMessage | Bir mesajı gönderilmeden önce inceleyin. |
| TLS ve günlükleme | TLSOptions, dosya günlüklemesi | HTTPS çağrıları için TLS yapılandırması ve trafiğin dosya günlüğü. |
WhatsApp, gelen trafiği bileşenin sizin için barındırdığı bir webhook'a gönderir. Telegram'ın hiç webhook'a ihtiyacı yoktur, TDLib kendi bağlantısını sürdürür ve olaylar yükseltir.
| Alan | Ayrıntı |
|---|---|
| WhatsApp webhook uç noktası | StartServer ve StopServer, Meta webhook'unu kendi sürecinizin içinde barındırır; ServerOptions üzerinden yapılandırılır: IP, bağlantı noktası, SSL sertifikası, uç nokta yolu ve doğrulama token'ı. |
| Webhook doğrulaması | OnBeforeSubscribe, Meta'nın doğrulama isteğinde tetiklenir; böylece uç nokta abonelik el sıkışmasını yanıtlar. |
| Gelen WhatsApp mesajları | OnMessageReceived, okundu bilgisini göndermek için bir var aMarkAsRead argümanıyla her gelen mesajı iletir. |
| Teslimat durumu | OnMessageSent, gönderdiğiniz mesajların durumunu bildirir. |
| Ham yükler | OnRawMessage, webhook JSON'ını tam olarak Meta'nın gönderdiği şekilde açığa çıkarır. |
| Telegram güncellemeleri | Webhook gerekmez. TDLib, Telegram'a kendi bağlantısını sürdürür ve yeni mesajlar olay olarak gelir: OnMessageText, OnMessageDocument, OnMessagePhoto ve OnMessageVideo. |
| Diğer Telegram olayları | OnNewChat, OnNewCallbackQuery ve OnMessageSponsored; yeni sohbetleri, klavye geri çağırmalarını ve sponsorlu mesajları kapsar. |
| Ham Telegram olayları | OnEvent, her TDLib güncellemesini ham JSON olarak iletir. |
Resmi API'ler ve desteklenen her derleyicide aynı kaynak kodu.
| Alan | Ayrıntı |
|---|---|
| Telegram | Resmi TDLib (Telegram Database Library), Telegram'ın kendi istemci kitaplığı. |
| Meta Graph API'sinin bir parçası olan WhatsApp Business Cloud API, HTTPS üzerinden. | |
| Telegram platformları | Yerel TDLib kitaplığı aracılığıyla: Windows, macOS, Linux 64-bit, Android ve iOS. |
| WhatsApp platformları | Saf HTTPS, bu yüzden her Delphi platformu kapsanır. |
| Derleyiciler | Delphi ve C++ Builder 7'den 13'e. |
| Sürümler | Telegram istemcisi ayrıca sgcWebSockets içinde Standard sürümünden itibaren, WhatsApp istemcisi ise Professional sürümünden itibaren gelir; All-Access her şeyi içerir. |
| Lisanslama | Bağımsız. sgcWebSockets Core çalışma zamanı pakete dahildir ve tam kaynak kodu içerilir. |