sgcSocial 功能矩阵
sgcSocial 的全部能力，对应到两个客户端组件以及它们所实现的 API。每项能力在 Delphi 和 C++ Builder 中的表现完全一致，每份授权都提供完整源代码。点击组件即可进入它自己的页面，查看用法和示例。
sgcSocial 的全部能力，对应到两个客户端组件以及它们所实现的 API。每项能力在 Delphi 和 C++ Builder 中的表现完全一致，每份授权都提供完整源代码。点击组件即可进入它自己的页面，查看用法和示例。
sgcSocial 是自包含的。它内置了 sgcWebSockets Core 运行时，因此它不是附加组件。
同时内置于 sgcWebSockets。Telegram 客户端自 Standard 版本起也随 sgcWebSockets 提供，WhatsApp 客户端自 Professional 版本起提供。All-Access 包含全部内容。sgcSocial 是面向只需要这两个消息客户端的团队的独立产品包。
两大消息网络，注册在 SGC Social 面板页上。
| 组件 | 类 | 网络 | 描述 |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | 基于官方 TDLib 的完整 Telegram 客户端：用户账号和机器人，聊天和群组，媒体，内联键盘，支付和代理。 |
| WhatsApp Client | TsgcWhatsApp_Client | WhatsApp Business Cloud API 客户端：文本、媒体、模板和交互式消息，外加用于入站事件的内置 webhook 服务器。 |
TsgcTDLib_Telegram 基于官方 TDLib（Telegram Database Library）构建，因此它可以作为用户账号或机器人登录，并触及 Telegram 的完整功能集。
| 能力 | API | 说明 |
|---|---|---|
| 以用户身份登录 | Telegram.PhoneNumber | 手机号身份验证：OnAuthenticationCode 请求登录验证码，OnAuthenticationPassword 处理 2FA 密码，OnRegisterUser 覆盖新账号注册。 |
| 以机器人身份登录 | Telegram.BotToken | 同一个组件通过 TDLib 驱动机器人账号，提供完整的客户端能力，而不只是 Bot API 的子集。 |
| API 凭据 | Telegram.API.ApiId、Telegram.API.ApiHash | 在 my.telegram.org 为您的应用申请获得。 |
| 连接状态 | OnConnectionStatus、OnAuthorizationStatus | 原始的 TDLib 状态字符串，例如 authorizationStateReady。 |
| 发送文本 | SendTextMessage、SendRichTextMessage | 向任意聊天 id 发送纯文本或富文本。 |
| 发送媒体 | SendDocumentMessage、SendPhotoMessage、SendVideoMessage | 文件、照片和视频，配合 SendMessageAlbum 用于分组媒体。 |
| 支付 | SendInvoiceMessage、AnswerPreCheckoutQuery、SendPaymentForm | 端到端的 Telegram 支付流程。 |
| 编辑和管理 | EditTextMessage、DeleteMessages、ForwardMessages、PinChatMessage | 发送之后的消息生命周期。 |
| 聊天和群组 | CreatePrivateChat、CreateNewBasicGroupChat、CreateNewSupergroupChat、JoinChat、JoinChatByInviteLink | 以编程方式创建和加入对话。 |
| 密聊 | CreateNewSecretChat | TDLib 处理 Telegram 密聊，即端到端加密的聊天类型。 |
| 搜索 | SearchChats、SearchMessages、SearchContacts、SearchPublicChats | 跨您的聊天、消息、联系人和公开频道进行搜索。 |
| 文件 | DownloadFile | 下载 TDLib 通过 id 引用的任意文件。 |
| 内联键盘 | AnswerCallbackQuery、OnNewCallbackQuery | 附加在您发送的消息上的回调和 URL 按钮。 |
| 回复键盘 | 发送方法上的键盘标记 | 文本按钮、请求位置按钮和请求电话号码按钮。 |
| 内联查询 | AnswerInlineQuery | 应答发送给您机器人的内联查询。 |
| 消息事件 | OnMessageText、OnMessageDocument、OnMessagePhoto、OnMessageVideo | 带类型的入站消息，另有 OnMessageSponsored 和 OnNewChat。 |
| 原始逃生舱 | SendCustomRequest、OnEvent | 发送任意 TDLib JSON 请求并观察每一条原始更新。 |
| 代理 | HTTP、SOCKS5、MTProto | 让 TDLib 连接通过代理路由。 |
TsgcWhatsApp_Client 通过纯 HTTPS 与 Meta Graph API 通信，因此无需部署任何原生库，且覆盖每一个 Delphi 平台。
| 能力 | API | 说明 |
|---|---|---|
| Cloud API 设置 | WhatsAppOptions.PhoneNumberId、WhatsAppOptions.Token | 来自您 Meta 应用的两个值。每次调用都是对 Graph API 的纯 HTTPS 请求。 |
| 文本 | SendMessageText | 向任意 WhatsApp 号码发送文本。 |
| 公开链接媒体 | SendMessageImage、SendMessageDocument、SendMessageAudio、SendMessageVideo、SendMessageSticker | 媒体位于公开 URL 上。 |
| 本地文件媒体 | SendFileImage、SendFileDocument、SendFileAudio、SendFileVideo、SendFileSticker | 组件会先上传本地文件，再发送它。 |
| 表情回应 | SendMessageReaction | 用表情对某条已接收消息 id 作出回应。 |
| 位置和联系人 | SendMessageLocation、SendMessageContact | 带名称和地址的坐标，以及联系人名片。 |
| 交互式消息 | SendMessageInteractiveList、SendMessageInteractiveButtons | 选择列表和回复按钮。 |
| 模板 | SendMessageTemplate | 模板名称、语言代码和参数。 |
| 媒体管理 | UploadMedia、DownloadMedia、DeleteMedia | 直接操作 Cloud API 的媒体存储。 |
| 已读回执 | MarkMessageRead | 将某条入站消息标记为已读。 |
| 出站钩子 | OnBeforeSendMessage | 在消息发送之前对其进行检查。 |
| TLS 和日志 | TLSOptions、文件日志 | HTTPS 调用的 TLS 配置，以及流量的文件日志。 |
WhatsApp 把入站流量推送到一个 webhook，该组件会为您托管它。Telegram 完全不需要 webhook，TDLib 自行保持连接并触发事件。
| 方面 | 细节 |
|---|---|
| WhatsApp webhook 端点 | StartServer 和 StopServer 在您自己的进程内托管 Meta 的 webhook，通过 ServerOptions 配置：IP、端口、SSL 证书、端点路径和验证令牌。 |
| Webhook 验证 | OnBeforeSubscribe 在 Meta 的验证请求到达时触发，从而让端点应答订阅握手。 |
| 入站 WhatsApp 消息 | OnMessageReceived 送达每条入站消息，并带有一个 var aMarkAsRead 参数用于发送已读回执。 |
| 投递状态 | OnMessageSent 报告您发送的消息的状态。 |
| 原始负载 | OnRawMessage 按 Meta 发送时的原始形式暴露 webhook JSON。 |
| Telegram 更新 | 无需 webhook。TDLib 自行维持与 Telegram 的连接，新消息以事件形式到达：OnMessageText、OnMessageDocument、OnMessagePhoto 和 OnMessageVideo。 |
| 其他 Telegram 事件 | OnNewChat、OnNewCallbackQuery 和 OnMessageSponsored 分别覆盖新聊天、键盘回调和赞助消息。 |
| 原始 Telegram 事件 | OnEvent 以原始 JSON 形式送达每一条 TDLib 更新。 |
官方发布的 API，以及在每个受支持编译器上通用的同一份源代码。
| 方面 | 细节 |
|---|---|
| Telegram | 官方 TDLib（Telegram Database Library），即 Telegram 自身的客户端库。 |
| WhatsApp Business Cloud API，属于 Meta Graph API 的一部分，运行在 HTTPS 之上。 | |
| Telegram 平台 | 通过原生 TDLib 库：Windows、macOS、Linux 64 位、Android 和 iOS。 |
| WhatsApp 平台 | 纯 HTTPS，因此覆盖每一个 Delphi 平台。 |
| 编译器 | Delphi 和 C++ Builder 7 至 13。 |
| 版本 | Telegram 客户端自 Standard 版本起也随 sgcWebSockets 提供，WhatsApp 客户端自 Professional 版本起提供，All-Access 包含全部内容。 |
| 授权 | 独立产品。已内置 sgcWebSockets Core 运行时，并包含完整源代码。 |