Tudo o que o sgcSocial faz, mapeado nos dois componentes cliente e nas APIs que eles implementam. Cada recurso funciona igual no Delphi e no C++ Builder, e toda licença entrega o código-fonte completo. Clique em um componente para abrir a página dele, com uso e exemplos.
Cliente completo sobre o TDLib oficial
Business Cloud API
Servidor de webhook e atualizações em tempo real
Delphi 7 a 13, C++ Builder
O sgcSocial é autossuficiente. Ele já vem com o runtime sgcWebSockets Core embutido, portanto não é um complemento.
Também dentro do sgcWebSockets. O cliente Telegram também vem dentro das edições do sgcWebSockets a partir da Standard, e o cliente WhatsApp a partir da Professional. O All-Access inclui tudo. O sgcSocial é o pacote autônomo para equipes que precisam apenas dos clientes de mensageria.
Duas redes de mensagens, registradas na página de paleta SGC Social.
| Componente | Classe | Rede | Descrição |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | Cliente Telegram completo sobre o TDLib oficial: contas de usuário e bots, chats e grupos, mídia, teclados inline, pagamentos e proxies. |
| WhatsApp Client | TsgcWhatsApp_Client | Cliente da API do WhatsApp Business Cloud: texto, mídia, templates e mensagens interativas, mais um servidor de webhook embutido para eventos de entrada. |
TsgcTDLib_Telegram é construído sobre o TDLib oficial (Telegram Database Library), então ele entra como uma conta de usuário ou como um bot e alcança todo o conjunto de recursos do Telegram.
| Recurso | API | Observações |
|---|---|---|
| Entrar como usuário | Telegram.PhoneNumber | Autenticação por número de telefone: OnAuthenticationCode pede o código de login, OnAuthenticationPassword trata a senha de 2FA e OnRegisterUser cobre contas novas. |
| Entrar como bot | Telegram.BotToken | O mesmo componente conduz contas de bot pelo TDLib, com a superfície completa do cliente em vez do subconjunto da Bot API. |
| Credenciais da API | Telegram.API.ApiId, Telegram.API.ApiHash | Emitidas para a sua aplicação em my.telegram.org. |
| Estado da conexão | OnConnectionStatus, OnAuthorizationStatus | Strings de estado brutas do TDLib, como authorizationStateReady. |
| Enviar texto | SendTextMessage, SendRichTextMessage | Texto simples e formatado para qualquer chat id. |
| Enviar mídia | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Arquivos, fotos e vídeos, com SendMessageAlbum para mídia agrupada. |
| Pagamentos | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | O fluxo de pagamentos do Telegram, do início ao fim. |
| Editar e gerenciar | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | O ciclo de vida da mensagem depois do envio. |
| Chats e grupos | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Crie e entre em conversas de forma programática. |
| Chats secretos | CreateNewSecretChat | O TDLib cuida dos chats secretos do Telegram, o tipo com criptografia de ponta a ponta. |
| Pesquisa | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | Nos seus chats, mensagens, contatos e canais públicos. |
| Arquivos | DownloadFile | Baixa qualquer arquivo referenciado pelo TDLib por id. |
| Teclados inline | AnswerCallbackQuery, OnNewCallbackQuery | Botões de callback e de URL anexados às mensagens que você envia. |
| Teclados de resposta | Marcação de teclado nos métodos de envio | Botões de texto, botões de solicitação de localização e de número de telefone. |
| Consultas inline | AnswerInlineQuery | Responda consultas inline endereçadas ao seu bot. |
| Eventos de mensagem | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Mensagens de entrada tipadas, mais OnMessageSponsored e OnNewChat. |
| Válvula de escape bruta | SendCustomRequest, OnEvent | Envie qualquer requisição JSON do TDLib e observe toda atualização bruta. |
| Proxies | HTTP, SOCKS5, MTProto | Roteie a conexão do TDLib por um proxy. |
TsgcWhatsApp_Client fala com a Graph API da Meta sobre HTTPS puro, então não há biblioteca nativa para implantar e toda plataforma Delphi está coberta.
| Recurso | API | Observações |
|---|---|---|
| Configuração da Cloud API | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | Os dois valores da sua aplicação Meta. Toda chamada é uma requisição HTTPS simples para a Graph API. |
| Texto | SendMessageText | Texto para qualquer número do WhatsApp. |
| Mídia por link público | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | A mídia está hospedada em uma URL pública. |
| Mídia a partir de um arquivo local | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | O componente faz upload do arquivo local primeiro, depois o envia. |
| Reações | SendMessageReaction | Reaja a um id de mensagem recebida com um emoji. |
| Localização e contatos | SendMessageLocation, SendMessageContact | Coordenadas com nome e endereço, e cartões de contato. |
| Mensagens interativas | SendMessageInteractiveList, SendMessageInteractiveButtons | Listas de seleção e botões de resposta. |
| Templates | SendMessageTemplate | Nome do template, código de idioma e parâmetros. |
| Gerenciamento de mídia | UploadMedia, DownloadMedia, DeleteMedia | Trabalhe diretamente com o repositório de mídia da Cloud API. |
| Confirmações de leitura | MarkMessageRead | Marque uma mensagem recebida como lida. |
| Gancho de saída | OnBeforeSendMessage | Inspecione uma mensagem antes de ela ser enviada. |
| TLS e log | TLSOptions, log em arquivo | Configuração de TLS para as chamadas HTTPS, e um log em arquivo do tráfego. |
O WhatsApp envia o tráfego de entrada para um webhook, que o componente hospeda para você. O Telegram não precisa de webhook algum, o TDLib mantém a sua própria conexão e dispara eventos.
| Área | Detalhe |
|---|---|
| Endpoint de webhook do WhatsApp | StartServer e StopServer hospedam o webhook da Meta dentro do seu próprio processo, configurado por ServerOptions: IP, porta, certificado SSL, caminho do endpoint e token de verificação. |
| Verificação do webhook | OnBeforeSubscribe dispara na requisição de verificação da Meta, então o endpoint responde ao handshake de assinatura. |
| Mensagens do WhatsApp recebidas | OnMessageReceived entrega cada mensagem recebida, com um argumento var aMarkAsRead para enviar a confirmação de leitura. |
| Status de entrega | OnMessageSent informa o status das mensagens que você enviou. |
| Payloads brutos | OnRawMessage expõe o JSON do webhook exatamente como a Meta o publicou. |
| Atualizações do Telegram | Nenhum webhook necessário. O TDLib mantém a sua própria conexão com o Telegram, e as mensagens novas chegam como eventos: OnMessageText, OnMessageDocument, OnMessagePhoto e OnMessageVideo. |
| Outros eventos do Telegram | OnNewChat, OnNewCallbackQuery e OnMessageSponsored cobrem chats novos, callbacks de teclado e mensagens patrocinadas. |
| Eventos brutos do Telegram | OnEvent entrega toda atualização do TDLib como JSON bruto. |
APIs oficiais, e o mesmo código-fonte em todo compilador compatível.
| Área | Detalhe |
|---|---|
| Telegram | O TDLib oficial (Telegram Database Library), a própria biblioteca cliente do Telegram. |
| A API do WhatsApp Business Cloud, parte da Graph API da Meta, sobre HTTPS. | |
| Plataformas do Telegram | Pela biblioteca nativa TDLib: Windows, macOS, Linux 64-bit, Android e iOS. |
| Plataformas do WhatsApp | HTTPS puro, então toda plataforma Delphi está coberta. |
| Compiladores | Delphi e C++ Builder 7 até 13. |
| Edições | O cliente Telegram também vem dentro do sgcWebSockets a partir da Standard, o cliente WhatsApp a partir da Professional, e o All-Access inclui tudo. |
| Licenciamento | Autônomo. O runtime sgcWebSockets Core vem embutido e o código-fonte completo está incluído. |