sgcSocial: componentes de WhatsApp e Telegram para Delphi e C++ Builder
Produto autônomo WhatsApp Business & Telegram

sgcSocial: componentes de WhatsApp e Telegram para Delphi e C++ Builder

Dois componentes cliente colocam as suas aplicações nas duas redes de mensagens que os seus usuários já têm abertas. O TsgcWhatsApp_Client fala a API do WhatsApp Business Cloud sobre HTTPS puro, enviando e recebendo por meio da Graph API da Meta. O TsgcTDLib_Telegram é um cliente Telegram completo construído sobre o mecanismo oficial TDLib, tanto para contas de usuário quanto para bots, não apenas pela Bot API. O sgcSocial é autônomo: ele já traz embutido o runtime sgcWebSockets Core sobre o qual os dois clientes são construídos.

Código-fonte completo
Delphi 7 a 13 & C++ Builder
Runtime embutido sgcWebSockets Core O runtime de HTTP, TLS e JSON por baixo dos dois clientes
Telegram TsgcTDLib_Telegram
WhatsApp TsgcWhatsApp_Client
2 Componentes cliente Uma página na paleta de componentes
2 Redes de mensagens WhatsApp Business Platform e Telegram
5 Plataformas do Telegram Builds do TDLib para Windows, macOS, Linux 64-bit, Android e iOS
100% Código-fonte incluído Os dois clientes e o runtime Core embutido
12 Meses de atualizações Toda versão lançada enquanto a sua licença estiver ativa

Duas coisas que vale saber antes

O que o sgcSocial precisa de você, e se você já possui estes componentes. As duas respostas são curtas.

O sgcSocial é autossuficiente

Autônomo, o runtime sgcWebSockets Core está incluído: a pilha de cliente HTTP/TLS que o cliente WhatsApp usa para chamar a Graph API, o servidor HTTP que hospeda o seu endpoint de webhook, e a maquinaria JSON com a qual os dois clientes interpretam o seu tráfego. Um único SKU, um único instalador.

Toda licença inclui o código-fonte completo, então tanto os dois clientes quanto o runtime por baixo deles são depurados passo a passo no seu próprio debugger, em vez de desaparecer dentro de um binário.

Sobreposição de edição

Já está na sua edição do sgcWebSockets?

O cliente Telegram vem dentro do sgcWebSockets a partir da edição Standard, e o cliente WhatsApp a partir da Professional, então se você já possui uma dessas edições, já tem o componente correspondente. O All-Access inclui tudo.

O sgcSocial existe para o caso oposto: você quer WhatsApp e Telegram em Delphi ou C++ Builder sem licenciar uma edição completa do sgcWebSockets. Verifique o que a sua edição já cobre antes de comprar.

Dois clientes, duas redes de mensagens

Cada um é um componente não visual que você solta em um formulário ou cria em código, declarado na unit sgcLibs e registrado na página de paleta SGC Social. Defina as credenciais da conta, conecte os eventos e então chame os métodos de envio tipados.

Telegram1 componente

Um cliente Telegram completo, contas de usuário e bots

O TsgcTDLib_Telegram é construído sobre o TDLib, a biblioteca oficial Telegram Database Library que move os próprios aplicativos do Telegram, então ele entra como uma conta de usuário real ou como um bot, não apenas pela Bot API. O fluxo de autenticação por número de telefone é exposto como eventos, OnAuthenticationCode, OnAuthenticationPassword para a 2FA e OnRegisterUser, e o tráfego chega tipado: OnMessageText, OnMessagePhoto, OnMessageVideo, OnMessageDocument, OnNewChat e OnNewCallbackQuery, com um OnEvent bruto por baixo. Envie texto, texto formatado, documentos, fotos, vídeos, álbuns e faturas, edite, exclua, encaminhe e fixe mensagens, crie e pesquise chats, grupos, supergrupos e chats secretos, e anexe teclados inline ou de resposta, incluindo botões de solicitação de localização e de número de telefone. Qualquer recurso que o TDLib conheça e que ainda não tenha um wrapper passa por SendCustomRequest, e proxies HTTP, SOCKS5 e MTProto são configurados em uma única chamada cada.

TsgcTDLib_Telegram Mecanismo oficial TDLib
WhatsApp1 componente

A Business Cloud API, saída e entrada

O TsgcWhatsApp_Client fala com a API do WhatsApp Business Cloud por meio da Graph API da Meta, sobre HTTPS puro. Configure WhatsAppOptions.PhoneNumberId e Token e envie: texto, reações, localizações, contatos, listas e botões interativos, e mensagens de template com um nome de template, um código de idioma e parâmetros por mensagem, o formato exigido pelas conversas iniciadas pela empresa. A mídia sai de duas formas: SendMessageImage e seus irmãos referenciam um link público, enquanto SendFileImage e seus irmãos fazem upload de um arquivo local primeiro, e UploadMedia, DownloadMedia e DeleteMedia gerenciam as cópias armazenadas. O recebimento é coberto pelo endpoint de webhook embutido: StartServer o hospeda com ServerOptions e TLSOptions, OnBeforeSubscribe responde ao handshake de verificação da Meta, e OnMessageReceived entrega cada mensagem com um sinalizador var aMarkAsRead que envia a confirmação de leitura para você.

TsgcWhatsApp_Client Graph API da Meta · HTTPS puro

Mensageria conversacional a partir de código Delphi

Os dois componentes são componentes não visuais comuns, então eles se encaixam em qualquer coisa que a sua aplicação já seja: um aplicativo desktop VCL, um serviço do Windows, um daemon Linux. Estes são os padrões que os clientes constroem, cada um associado à chamada que o implementa.

Atualizações de pedido e entrega SendMessageTemplate

As mensagens de template do WhatsApp abrem uma conversa iniciada pela empresa: aprovadas uma vez, depois enviadas pelo seu código com parâmetros específicos de cada pedido.

Login e códigos de uso único SendTextMessage

Entregue códigos pelo Telegram no instante em que o seu backend os gera, em um canal que os usuários realmente acompanham.

Alertas e monitoramento SendRichTextMessage

Um serviço que publica exceções, limites e resumos diários no grupo de operações que a sua equipe já mantém aberto.

Caixa de entrada de suporte ao cliente OnMessageReceived

As mensagens recebidas do WhatsApp chegam ao seu próprio endpoint de webhook como eventos, com um sinalizador var que as marca como lidas.

Chatbots com botões AnswerCallbackQuery

Teclados inline no Telegram e listas e botões interativos no WhatsApp transformam uma conversa em um menu conduzido pelo seu código.

Pagamentos e faturas SendInvoiceMessage

Envie mensagens de fatura do Telegram, responda à consulta de pré-checkout e envie o formulário de pagamento, tudo a partir do componente.

Dois clientes, um runtime embutido

Os dois componentes dificilmente poderiam ser mais diferentes na rede. Um é uma API HTTPS no estilo REST, o outro uma biblioteca de banco de dados nativa, e é exatamente esse o propósito de empacotá-los juntos: o sgcSocial esconde a diferença atrás das mesmas convenções de componente, com o runtime sgcWebSockets Core embutido cuidando do encanamento por baixo.

O WhatsApp é HTTPS mais um webhook

As chamadas de saída são requisições à Graph API sobre TLS, emitidas pela pilha de cliente HTTP do runtime Core, então o componente roda em toda plataforma para a qual o Delphi compila. As mensagens de entrada são enviadas pela Meta ao endpoint de webhook que o próprio componente hospeda: StartServer, ServerOptions e OnBeforeSubscribe para o handshake de verificação.

O Telegram é o mecanismo nativo TDLib

O TsgcTDLib_Telegram conduz a biblioteca oficial TDLib por meio da sua interface JSON: o componente carrega a biblioteca nativa, percorre a máquina de estados de autenticação para você e transforma o fluxo de atualizações em eventos Delphi tipados. O TDLib é distribuído para Windows, macOS, Linux 64-bit, Android e iOS.

O runtime Core está na caixa

Autônomo, o runtime sgcWebSockets Core está incluído. Ele contribui com a pilha de cliente HTTP/TLS, o servidor HTTP por baixo do endpoint de webhook e o parser JSON dos quais os dois clientes dependem, e o seu código-fonte completo faz parte do pacote como tudo o mais.

Proxies, TLS e log

O cliente Telegram alcança redes restritivas por meio de proxies HTTP, SOCKS5 ou MTProto com AddProxyHTTP, AddProxySocks5 e AddProxyMTProto. O cliente WhatsApp expõe TLSOptions para os seus endpoints e pode gravar o seu tráfego em um arquivo de log enquanto você faz a integração.

Envie no WhatsApp, ecoe no Telegram

Os dois componentes seguem a mesma forma: defina as credenciais da conta, atribua os manipuladores de evento, ative. Eles são declarados na unit sgcLibs, e o mesmo código compila do Delphi 7 ao 13 e no C++ Builder.

uses
  sgcLibs;

var
  WhatsApp: TsgcWhatsApp_Client;
  Telegram: TsgcTDLib_Telegram;
begin
  // WhatsApp: Business Cloud API over HTTPS
  WhatsApp := TsgcWhatsApp_Client.Create(nil);
  WhatsApp.WhatsAppOptions.PhoneNumberId := '123456789012345';
  WhatsApp.WhatsAppOptions.Token := 'EAAG...';

  WhatsApp.OnMessageReceived := WhatsAppMessageReceived;
  WhatsApp.StartServer;   // webhook endpoint for inbound messages

  WhatsApp.SendMessageText('+34600111222', 'Your order is on its way.');

  // Telegram: the official TDLib engine
  Telegram := TsgcTDLib_Telegram.Create(nil);
  Telegram.Telegram.API.ApiId := '123456';
  Telegram.Telegram.API.ApiHash := 'your-api-hash';
  Telegram.Telegram.PhoneNumber := '+34600111222';

  Telegram.OnAuthenticationCode := TelegramAuthenticationCode;
  Telegram.OnMessageText := TelegramMessageText;

  Telegram.Active := True;
end;

procedure TForm1.WhatsAppMessageReceived(Sender: TObject;
  const aMessage: TsgcWhatsApp_Receive_Message;
  var aMarkAsRead: Boolean);
begin
  Memo1.Lines.Add(aMessage.RawMessage);
  aMarkAsRead := True;   // sends the read receipt
end;

procedure TForm1.TelegramAuthenticationCode(Sender: TObject;
  var Code: String);
begin
  Code := InputBox('Telegram', 'Login code', '');
end;

procedure TForm1.TelegramMessageText(Sender: TObject;
  MessageText: TsgcTelegramMessageText);
begin
  Memo1.Lines.Add(MessageText.ChatId + ': ' + MessageText.Text);
  Telegram.SendTextMessage(MessageText.ChatId, 'Got it, thanks!');
end;
// include: sgcLibs.hpp

// WhatsApp: Business Cloud API over HTTPS
TsgcWhatsApp_Client *WhatsApp = new TsgcWhatsApp_Client(this);
WhatsApp->WhatsAppOptions->PhoneNumberId = "123456789012345";
WhatsApp->WhatsAppOptions->Token = "EAAG...";

WhatsApp->OnMessageReceived = WhatsAppMessageReceived;
WhatsApp->StartServer();   // webhook endpoint for inbound messages

WhatsApp->SendMessageText("+34600111222", "Your order is on its way.");

// Telegram: the official TDLib engine
TsgcTDLib_Telegram *Telegram = new TsgcTDLib_Telegram(this);
Telegram->Telegram->API->ApiId = "123456";
Telegram->Telegram->API->ApiHash = "your-api-hash";
Telegram->Telegram->PhoneNumber = "+34600111222";

Telegram->OnMessageText = TelegramMessageText;

Telegram->Active = true;

void __fastcall TForm1::WhatsAppMessageReceived(TObject *Sender,
    TsgcWhatsApp_Receive_Message* const aMessage, bool &aMarkAsRead)
{
  Memo1->Lines->Add(aMessage->RawMessage);
  aMarkAsRead = true;   // sends the read receipt
}

void __fastcall TForm1::TelegramMessageText(TObject *Sender,
    TsgcTelegramMessageText *MessageText)
{
  Memo1->Lines->Add(MessageText->ChatId + ": " + MessageText->Text);
  Telegram->SendTextMessage(MessageText->ChatId, "Got it, thanks!");
}

HTTPS puro de um lado, TDLib nativo do outro

O cliente WhatsApp é HTTPS puro, então compila e roda em qualquer lugar que o Delphi compile. O cliente Telegram conduz a biblioteca nativa TDLib, que o Telegram publica para cinco plataformas.

TsgcWhatsApp_Client API Business Cloud sobre HTTPS, servidor de webhook incluído
Windows Win32 Windows Win64 Linux64 macOS iOS Android
TsgcTDLib_Telegram Roda onde quer que a biblioteca nativa TDLib rode
Windows macOS Linux 64-bit Android iOS
Suporte de IDE Uma única árvore de código-fonte, pacotes de design-time por versão
Delphi 7 a 13 C++ Builder
Instalador de avaliação A avaliação All-Access do sgcWebSockets inclui os componentes Social
Um único download, os dois componentes

Baixar o instalador de avaliação →

Um pacote autônomo

O sgcSocial é licenciado por conta própria, a partir de €249 para um único desenvolvedor. Todas as licenças incluem código-fonte completo, 1 ano de atualizações e de 50% a 70% de desconto na renovação: 50% ao renovar um pacote, 60% para dois, 70% para três ou mais. sgcAI, sgcMQ e sgcSocial contam cada um como um pacote.

sgcSocial

€249

Licenças Single, Team e Site disponíveis.

  • Cliente Telegram sobre o TDLib oficial, contas de usuário & bots
  • Cliente da API do WhatsApp Business Cloud
  • Endpoint de webhook do WhatsApp embutido
  • Templates, mídia, teclados inline & de resposta
  • Runtime sgcWebSockets Core incluído
  • Delphi 7 a 13 & C++ Builder
  • Código-fonte completo
  • 1 ano de atualizações

O sgcSocial inclui o runtime sgcWebSockets Core, então não há mais nada para comprar.

O checkout lista dois itens: o direito de uso do runtime sgcWebSockets Core, cobrado a zero, e o próprio pacote sgcSocial. Detalhes completos de preços.

3,000+Developers
20+Years
761+Components
30+API Integrations
5Platforms
Garantia de reembolso de 30 diasNão ficou satisfeito? Solicite o reembolso total em até 30 dias após a compra. Ver política de reembolso

Alcance seus usuários onde eles já conversam

WhatsApp e Telegram a partir de código nativo Delphi e C++ Builder, com o runtime embutido e o código-fonte completo na caixa. Baixe o instalador de avaliação All-Access e coloque os dois componentes em um formulário hoje mesmo.

Outros produtos da eSeGeCe

Combine o sgcSocial com as nossas outras bibliotecas de componentes para Delphi, C++ Builder e .NET.

sgcWebSockets

A biblioteca completa: clientes e servidores WebSocket, HTTP/2, IoT, P2P e componentes de IA. As suas edições também incluem Telegram e WhatsApp.

Saiba mais →

sgcAI

Componentes de IA, LLM e MCP. Um único componente de chat alcança OpenAI, Anthropic, Gemini, DeepSeek, Ollama, Grok e Mistral.

Saiba mais →

sgcMQ

Componentes cliente nativos de MQTT 3.1.1/5.0, AMQP 0.9.1, AMQP 1.0, Apache Kafka e STOMP, com o runtime Core embutido.

Saiba mais →

sgcQUIC

Componentes cliente e servidor QUIC (RFC 9000) e HTTP/3 (RFC 9114) construídos sobre o mecanismo QUIC nativo do OpenSSL 3.5.

Saiba mais →

sgcHTML

Componentes de HTML e interface do lado do servidor, com reconhecimento de dados, para Delphi, C++ Builder e .NET, com Bootstrap 5 e htmx.

Saiba mais →

sgcSign

Assinaturas digitais de nível empresarial. XAdES, PAdES, CAdES e ASiC com 10 provedores de chaves e 21 perfis por país da UE.

Saiba mais →