Tutto quello che fa sgcSocial, mappato sui due componenti client e sulle API che implementano. Ogni funzionalità si comporta allo stesso modo in Delphi e in C++ Builder, e ogni licenza include il codice sorgente completo. Clicca su un componente per la sua pagina dedicata con utilizzo ed esempi.
Client completo sul TDLib ufficiale
Business Cloud API
Server webhook e aggiornamenti in tempo reale
Da Delphi 7 a 13, C++ Builder
sgcSocial è autosufficiente. Viene distribuito con il runtime sgcWebSockets Core incluso, quindi non è un componente aggiuntivo.
Anche dentro sgcWebSockets. Il client Telegram è incluso anche nelle edizioni di sgcWebSockets a partire dalla Standard, e il client WhatsApp a partire dalla Professional. All-Access include tutto. sgcSocial è il package autonomo per i team che hanno bisogno solo dei client di messaggistica.
Due reti di messaggistica, registrate sulla pagina della palette SGC Social.
| Componente | Classe | Rete | Descrizione |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | Client Telegram completo sul TDLib ufficiale: account utente e bot, chat e gruppi, contenuti multimediali, tastiere inline, pagamenti e proxy. |
| WhatsApp Client | TsgcWhatsApp_Client | Client WhatsApp Business Cloud API: testo, contenuti multimediali, template e messaggi interattivi, oltre a un server webhook integrato per gli eventi in entrata. |
TsgcTDLib_Telegram è costruito sul TDLib ufficiale (Telegram Database Library), quindi accede come account utente o come bot e raggiunge l'intero set di funzionalità di Telegram.
| Funzionalità | API | Note |
|---|---|---|
| Accesso come utente | Telegram.PhoneNumber | Autenticazione con numero di telefono: OnAuthenticationCode richiede il codice di accesso, OnAuthenticationPassword gestisce la password 2FA e OnRegisterUser copre i nuovi account. |
| Accesso come bot | Telegram.BotToken | Lo stesso componente pilota gli account bot attraverso TDLib, con l'intera superficie del client invece del sottoinsieme della Bot API. |
| Credenziali API | Telegram.API.ApiId, Telegram.API.ApiHash | Rilasciate per la tua applicazione su my.telegram.org. |
| Stato della connessione | OnConnectionStatus, OnAuthorizationStatus | Stringhe di stato TDLib grezze, come authorizationStateReady. |
| Invia testo | SendTextMessage, SendRichTextMessage | Testo semplice e formattato verso qualsiasi chat id. |
| Invia contenuti multimediali | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | File, foto e video, con SendMessageAlbum per i contenuti multimediali raggruppati. |
| Pagamenti | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | Il flusso dei pagamenti di Telegram, end to end. |
| Modifica e gestione | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | Il ciclo di vita del messaggio dopo l'invio. |
| Chat e gruppi | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Crea e unisciti a conversazioni via codice. |
| Chat segrete | CreateNewSecretChat | TDLib gestisce le chat segrete di Telegram, il tipo con cifratura end-to-end. |
| Ricerca | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Nelle tue chat, messaggi, contatti e canali pubblici. |
| File | DownloadFile | Scarica qualsiasi file a cui TDLib fa riferimento tramite id. |
| Tastiere inline | AnswerCallbackQuery, OnNewCallbackQuery | Pulsanti di callback e URL allegati ai messaggi che invii. |
| Tastiere di risposta | Markup della tastiera sui metodi di invio | Pulsanti di testo, pulsanti di richiesta posizione e pulsanti di richiesta numero di telefono. |
| Query inline | AnswerInlineQuery | Rispondi alle query inline indirizzate al tuo bot. |
| Eventi messaggio | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Messaggi in entrata tipizzati, più OnMessageSponsored e OnNewChat. |
| Via di fuga grezza | SendCustomRequest, OnEvent | Invia qualsiasi richiesta JSON TDLib e osserva ogni aggiornamento grezzo. |
| Proxy | HTTP, SOCKS5, MTProto | Instrada la connessione TDLib attraverso un proxy. |
TsgcWhatsApp_Client parla con la Graph API di Meta su HTTPS puro, quindi non c'è nessuna libreria nativa da distribuire e ogni piattaforma Delphi è coperta.
| Funzionalità | API | Note |
|---|---|---|
| Configurazione Cloud API | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | I due valori della tua applicazione Meta. Ogni chiamata è una richiesta HTTPS pura alla Graph API. |
| Testo | SendMessageText | Testo verso qualsiasi numero WhatsApp. |
| Contenuti multimediali da link pubblico | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | Il contenuto multimediale si trova a un URL pubblico. |
| Contenuti multimediali da file locale | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | Il componente carica prima il file locale, poi lo invia. |
| Reazioni | SendMessageReaction | Reagisci a un id di messaggio ricevuto con un'emoji. |
| Posizione e contatti | SendMessageLocation, SendMessageContact | Coordinate con nome e indirizzo, e biglietti da visita dei contatti. |
| Messaggi interattivi | SendMessageInteractiveList, SendMessageInteractiveButtons | Liste di selezione e pulsanti di risposta. |
| Template | SendMessageTemplate | Nome del template, codice lingua e parametri. |
| Gestione dei contenuti multimediali | UploadMedia, DownloadMedia, DeleteMedia | Lavora direttamente con l'archivio multimediale della Cloud API. |
| Ricevute di lettura | MarkMessageRead | Segna un messaggio in entrata come letto. |
| Hook in uscita | OnBeforeSendMessage | Ispeziona un messaggio prima che venga inviato. |
| TLS e log | TLSOptions, log su file | Configurazione TLS per le chiamate HTTPS, e un log su file del traffico. |
WhatsApp invia il traffico in entrata a un webhook, che il componente ospita per te. Telegram non ha bisogno di nessun webhook, TDLib mantiene la propria connessione e solleva eventi.
| Ambito | Dettaglio |
|---|---|
| Endpoint webhook WhatsApp | StartServer e StopServer ospitano il webhook di Meta dentro il tuo stesso processo, configurato tramite ServerOptions: IP, porta, certificato SSL, percorso dell'endpoint e token di verifica. |
| Verifica del webhook | OnBeforeSubscribe scatta sulla richiesta di verifica di Meta, così l'endpoint risponde all'handshake di sottoscrizione. |
| Messaggi WhatsApp in entrata | OnMessageReceived consegna ogni messaggio in entrata, con un argomento var aMarkAsRead per inviare la ricevuta di lettura. |
| Stato di consegna | OnMessageSent segnala lo stato dei messaggi che hai inviato. |
| Payload grezzi | OnRawMessage espone il JSON del webhook esattamente come pubblicato da Meta. |
| Aggiornamenti Telegram | Nessun webhook necessario. TDLib mantiene la propria connessione a Telegram, e i nuovi messaggi arrivano come eventi: OnMessageText, OnMessageDocument, OnMessagePhoto e OnMessageVideo. |
| Altri eventi Telegram | OnNewChat, OnNewCallbackQuery e OnMessageSponsored coprono le nuove chat, i callback della tastiera e i messaggi sponsorizzati. |
| Eventi Telegram grezzi | OnEvent consegna ogni aggiornamento TDLib come JSON grezzo. |
API ufficiali, e lo stesso sorgente su ogni compilatore supportato.
| Ambito | Dettaglio |
|---|---|
| Telegram | Il TDLib ufficiale (Telegram Database Library), la libreria client dello stesso Telegram. |
| La WhatsApp Business Cloud API, parte della Graph API di Meta, su HTTPS. | |
| Piattaforme Telegram | Attraverso la libreria nativa TDLib: Windows, macOS, Linux 64-bit, Android e iOS. |
| Piattaforme WhatsApp | HTTPS puro, quindi ogni piattaforma Delphi è coperta. |
| Compilatori | Delphi e C++ Builder dalla versione 7 alla 13. |
| Edizioni | Il client Telegram è incluso anche in sgcWebSockets a partire dalla Standard, il client WhatsApp a partire dalla Professional, e All-Access include tutto. |
| Licenze | Autonomo. Il runtime sgcWebSockets Core è incluso e il codice sorgente completo fa parte della fornitura. |