Wszystko, co robi sgcSocial, rozpisane na dwa komponenty klienckie i specyfikacje, które implementują. Każda funkcja działa tak samo w Delphi i C++ Builder, a każda licencja zawiera pełny kod źródłowy. Kliknij komponent, aby przejść na jego stronę z opisem użycia i przykładami.
Pełny klient na oficjalnym TDLib
Business Cloud API
Serwer webhooka i aktualizacje w czasie rzeczywistym
Delphi od 7 do 13, C++ Builder
sgcSocial jest samowystarczalny. Jest dostarczany z dołączonym środowiskiem uruchomieniowym sgcWebSockets Core, więc nie jest dodatkiem.
Także wewnątrz sgcWebSockets. Klient Telegrama jest dostarczany także wewnątrz sgcWebSockets od edycji Standard wzwyż, a klient WhatsApp od edycji Professional wzwyż. All-Access zawiera wszystko. sgcSocial to pakiet samodzielny dla zespołów, które potrzebują wyłącznie klientów komunikatorów.
Dwie sieci komunikatorów, zarejestrowane na stronie palety SGC Social.
| Komponent | Klasa | Sieć | Opis |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | Pełny klient Telegrama na oficjalnym TDLib: konta użytkowników i boty, czaty i grupy, multimedia, klawiatury inline, płatności i proxy. |
| WhatsApp Client | TsgcWhatsApp_Client | Klient WhatsApp Business Cloud API: tekst, multimedia, szablony i wiadomości interaktywne, plus wbudowany serwer webhooka dla zdarzeń przychodzących. |
TsgcTDLib_Telegram jest zbudowany na oficjalnym TDLib (Telegram Database Library), dzięki czemu loguje się jako konto użytkownika albo jako bot i sięga do całego zestawu funkcji Telegrama.
| Możliwość | API | Uwagi |
|---|---|---|
| Logowanie jako użytkownik | Telegram.PhoneNumber | Uwierzytelnianie numerem telefonu: OnAuthenticationCode prosi o kod logowania, OnAuthenticationPassword obsługuje hasło 2FA, a OnRegisterUser obejmuje nowe konta. |
| Logowanie jako bot | Telegram.BotToken | Ten sam komponent steruje kontami botów przez TDLib, z pełną powierzchnią klienta, a nie tylko podzbiorem Bot API. |
| Poświadczenia API | Telegram.API.ApiId, Telegram.API.ApiHash | Wydawane dla twojej aplikacji na my.telegram.org. |
| Stan połączenia | OnConnectionStatus, OnAuthorizationStatus | Surowe łańcuchy stanu TDLib, takie jak authorizationStateReady. |
| Wysyłanie tekstu | SendTextMessage, SendRichTextMessage | Zwykły i sformatowany tekst do dowolnego id czatu. |
| Wysyłanie multimediów | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Pliki, zdjęcia i wideo, z SendMessageAlbum dla zgrupowanych multimediów. |
| Płatności | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | Cały przepływ płatności Telegrama, od początku do końca. |
| Edycja i zarządzanie | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | Cykl życia wiadomości po wysłaniu. |
| Czaty i grupy | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Twórz i dołączaj do konwersacji programowo. |
| Czaty tajne | CreateNewSecretChat | TDLib obsługuje czaty tajne Telegrama, czyli te szyfrowane end-to-end. |
| Wyszukiwanie | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | W twoich czatach, wiadomościach, kontaktach i kanałach publicznych. |
| Pliki | DownloadFile | Pobiera dowolny plik, do którego odwołuje się TDLib przez id. |
| Klawiatury inline | AnswerCallbackQuery, OnNewCallbackQuery | Przyciski callback i URL dołączone do wysyłanych przez ciebie wiadomości. |
| Klawiatury reply | Znaczniki klawiatury w metodach wysyłania | Przyciski tekstowe, przyciski żądania lokalizacji i żądania numeru telefonu. |
| Zapytania inline | AnswerInlineQuery | Odpowiadaj na zapytania inline skierowane do twojego bota. |
| Zdarzenia wiadomości | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Typowane wiadomości przychodzące, plus OnMessageSponsored i OnNewChat. |
| Surowy zawór bezpieczeństwa | SendCustomRequest, OnEvent | Wyślij dowolne żądanie JSON TDLib i obserwuj każdą surową aktualizację. |
| Proxy | HTTP, SOCKS5, MTProto | Skieruj połączenie TDLib przez proxy. |
TsgcWhatsApp_Client komunikuje się z Graph API firmy Meta przez zwykłe HTTPS, więc nie ma żadnej natywnej biblioteki do wdrożenia, a każda platforma Delphi jest objęta.
| Możliwość | API | Uwagi |
|---|---|---|
| Konfiguracja Cloud API | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | Dwie wartości z twojej aplikacji Meta. Każde wywołanie to zwykłe żądanie HTTPS do Graph API. |
| Tekst | SendMessageText | Tekst do dowolnego numeru WhatsApp. |
| Multimedia z publicznego łącza | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | Multimedia znajdują się pod publicznym adresem URL. |
| Multimedia z pliku lokalnego | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | Komponent najpierw przesyła plik lokalny, a potem go wysyła. |
| Reakcje | SendMessageReaction | Zareaguj emoji na id odebranej wiadomości. |
| Lokalizacja i kontakty | SendMessageLocation, SendMessageContact | Współrzędne z nazwą i adresem oraz wizytówki kontaktowe. |
| Wiadomości interaktywne | SendMessageInteractiveList, SendMessageInteractiveButtons | Listy wyboru i przyciski odpowiedzi. |
| Szablony | SendMessageTemplate | Nazwa szablonu, kod języka i parametry. |
| Zarządzanie multimediami | UploadMedia, DownloadMedia, DeleteMedia | Pracuj bezpośrednio z magazynem multimediów Cloud API. |
| Potwierdzenia przeczytania | MarkMessageRead | Oznacz przychodzącą wiadomość jako przeczytaną. |
| Hak wychodzący | OnBeforeSendMessage | Sprawdź wiadomość, zanim zostanie wysłana. |
| TLS i logowanie | TLSOptions, logowanie do pliku | Konfiguracja TLS dla wywołań HTTPS oraz dziennik ruchu zapisywany do pliku. |
WhatsApp przesyła ruch przychodzący do webhooka, który komponent hostuje za ciebie. Telegram nie potrzebuje żadnego webhooka, TDLib utrzymuje własne połączenie i zgłasza zdarzenia.
| Obszar | Szczegóły |
|---|---|
| Punkt końcowy webhooka WhatsApp | StartServer i StopServer hostują webhook Meta wewnątrz twojego własnego procesu, konfigurowany przez ServerOptions: IP, port, certyfikat SSL, ścieżka punktu końcowego i token weryfikacyjny. |
| Weryfikacja webhooka | OnBeforeSubscribe uruchamia się przy żądaniu weryfikacyjnym Meta, więc punkt końcowy odpowiada na handshake subskrypcji. |
| Przychodzące wiadomości WhatsApp | OnMessageReceived dostarcza każdą wiadomość przychodzącą, z argumentem var aMarkAsRead do wysłania potwierdzenia przeczytania. |
| Status dostarczenia | OnMessageSent raportuje status wysłanych przez ciebie wiadomości. |
| Surowe ładunki | OnRawMessage udostępnia JSON webhooka dokładnie tak, jak wysłała go Meta. |
| Aktualizacje Telegrama | Webhook nie jest potrzebny. TDLib utrzymuje własne połączenie z Telegramem, a nowe wiadomości przychodzą jako zdarzenia: OnMessageText, OnMessageDocument, OnMessagePhoto i OnMessageVideo. |
| Inne zdarzenia Telegrama | OnNewChat, OnNewCallbackQuery i OnMessageSponsored obejmują nowe czaty, callbacki klawiatur i wiadomości sponsorowane. |
| Surowe zdarzenia Telegrama | OnEvent dostarcza każdą aktualizację TDLib jako surowy JSON. |
Oficjalne API i te same źródła we wszystkich obsługiwanych kompilatorach.
| Obszar | Szczegóły |
|---|---|
| Telegram | Oficjalny TDLib (Telegram Database Library), własna biblioteka kliencka Telegrama. |
| WhatsApp Business Cloud API, część Graph API firmy Meta, przez HTTPS. | |
| Platformy Telegrama | Przez natywną bibliotekę TDLib: Windows, macOS, Linux 64-bit, Android i iOS. |
| Platformy WhatsApp | Czyste HTTPS, więc każda platforma Delphi jest objęta. |
| Kompilatory | Delphi i C++ Builder od 7 do 13. |
| Edycje | Klient Telegrama jest dostarczany także wewnątrz sgcWebSockets od edycji Standard wzwyż, klient WhatsApp od edycji Professional wzwyż, a All-Access zawiera wszystko. |
| Licencjonowanie | Produkt samodzielny. Środowisko uruchomieniowe sgcWebSockets Core jest dołączone, a pełny kod źródłowy jest w zestawie. |