Todo lo que hace sgcSocial, repartido entre los dos componentes cliente y las APIs que implementan. Cada capacidad funciona igual en Delphi y en C++ Builder, y todas las licencias incluyen el código fuente completo. Haz clic en un componente para ver su propia página con uso y ejemplos.
Cliente completo sobre el TDLib oficial
Business Cloud API
Servidor de webhook y actualizaciones en tiempo real
Delphi 7 a 13, C++ Builder
sgcSocial es autocontenido. Se entrega con el runtime sgcWebSockets Core incluido, así que no es un complemento.
También dentro de sgcWebSockets. El cliente de Telegram también se entrega dentro de las ediciones de sgcWebSockets desde Standard en adelante, y el cliente de WhatsApp desde Professional en adelante. All-Access lo incluye todo. sgcSocial es el paquete independiente para los equipos que solo necesitan los clientes de mensajería.
Dos redes de mensajería, registradas en la página de paleta SGC Social.
| Componente | Clase | Red | Descripción |
|---|---|---|---|
| Telegram Client | TsgcTDLib_Telegram | Telegram | Cliente de Telegram completo sobre el TDLib oficial: cuentas de usuario y bots, chats y grupos, medios, teclados en línea, pagos y proxies. |
| WhatsApp Client | TsgcWhatsApp_Client | Cliente de WhatsApp Business Cloud API: texto, medios, plantillas y mensajes interactivos, además de un servidor de webhook incorporado para eventos entrantes. |
TsgcTDLib_Telegram está construido sobre el TDLib oficial (Telegram Database Library), así que inicia sesión como una cuenta de usuario o como un bot y alcanza todo el conjunto de funciones de Telegram.
| Capacidad | API | Notas |
|---|---|---|
| Iniciar sesión como usuario | Telegram.PhoneNumber | Autenticación por número de teléfono: OnAuthenticationCode pide el código de acceso, OnAuthenticationPassword gestiona la contraseña de 2FA y OnRegisterUser cubre las cuentas nuevas. |
| Iniciar sesión como bot | Telegram.BotToken | El mismo componente maneja cuentas de bot a través de TDLib, con la superficie completa del cliente en lugar del subconjunto de la Bot API. |
| Credenciales de la API | Telegram.API.ApiId, Telegram.API.ApiHash | Se emiten para tu aplicación en my.telegram.org. |
| Estado de conexión | OnConnectionStatus, OnAuthorizationStatus | Cadenas de estado en crudo de TDLib, como authorizationStateReady. |
| Enviar texto | SendTextMessage, SendRichTextMessage | Texto plano y enriquecido a cualquier id de chat. |
| Enviar medios | SendDocumentMessage, SendPhotoMessage, SendVideoMessage | Archivos, fotos y vídeos, con SendMessageAlbum para medios agrupados. |
| Pagos | SendInvoiceMessage, AnswerPreCheckoutQuery, SendPaymentForm | El flujo de pagos de Telegram, de principio a fin. |
| Editar y gestionar | EditTextMessage, DeleteMessages, ForwardMessages, PinChatMessage | El ciclo de vida del mensaje después de enviarlo. |
| Chats y grupos | CreatePrivateChat, CreateNewBasicGroupChat, CreateNewSupergroupChat, JoinChat, JoinChatByInviteLink | Crea y únete a conversaciones mediante código. |
| Chats secretos | CreateNewSecretChat | TDLib gestiona los chats secretos de Telegram, los del tipo cifrado de extremo a extremo. |
| Búsqueda | SearchChats, SearchMessages, SearchContacts, SearchPublicChats | En tus chats, mensajes, contactos y canales públicos. |
| Archivos | DownloadFile | Descarga cualquier archivo que TDLib referencie por id. |
| Teclados en línea | AnswerCallbackQuery, OnNewCallbackQuery | Botones de callback y de URL adjuntos a los mensajes que envías. |
| Teclados de respuesta | Markup de teclado en los métodos de envío | Botones de texto, botones de solicitud de ubicación y botones de solicitud de número de teléfono. |
| Consultas en línea | AnswerInlineQuery | Responde a las consultas en línea dirigidas a tu bot. |
| Eventos de mensaje | OnMessageText, OnMessageDocument, OnMessagePhoto, OnMessageVideo | Mensajes entrantes tipados, además de OnMessageSponsored y OnNewChat. |
| Vía de escape en crudo | SendCustomRequest, OnEvent | Envía cualquier petición JSON de TDLib y observa todas las actualizaciones en crudo. |
| Proxies | HTTP, SOCKS5, MTProto | Enruta la conexión de TDLib a través de un proxy. |
TsgcWhatsApp_Client habla con la Graph API de Meta sobre HTTPS puro, así que no hay ninguna librería nativa que desplegar y quedan cubiertas todas las plataformas de Delphi.
| Capacidad | API | Notas |
|---|---|---|
| Configuración de la Cloud API | WhatsAppOptions.PhoneNumberId, WhatsAppOptions.Token | Los dos valores de tu aplicación de Meta. Cada llamada es una petición HTTPS pura a la Graph API. |
| Texto | SendMessageText | Texto a cualquier número de WhatsApp. |
| Medios por enlace público | SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo, SendMessageSticker | El medio está alojado en una URL pública. |
| Medios desde un archivo local | SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo, SendFileSticker | El componente sube antes el archivo local y luego lo envía. |
| Reacciones | SendMessageReaction | Reacciona a un id de mensaje recibido con un emoji. |
| Ubicación y contactos | SendMessageLocation, SendMessageContact | Coordenadas con un nombre y una dirección, y tarjetas de contacto. |
| Mensajes interactivos | SendMessageInteractiveList, SendMessageInteractiveButtons | Listas de selección y botones de respuesta. |
| Plantillas | SendMessageTemplate | Nombre de plantilla, código de idioma y parámetros. |
| Gestión de medios | UploadMedia, DownloadMedia, DeleteMedia | Trabaja directamente con el almacén de medios de la Cloud API. |
| Acuses de lectura | MarkMessageRead | Marca un mensaje entrante como leído. |
| Gancho de salida | OnBeforeSendMessage | Inspecciona un mensaje antes de que se envíe. |
| TLS y registro | TLSOptions, registro en archivo | Configuración TLS para las llamadas HTTPS, y un registro en archivo del tráfico. |
WhatsApp empuja el tráfico entrante hacia un webhook, que el componente aloja por ti. Telegram no necesita ningún webhook, TDLib mantiene su propia conexión y genera eventos.
| Área | Detalle |
|---|---|
| Endpoint de webhook de WhatsApp | StartServer y StopServer alojan el webhook de Meta dentro de tu propio proceso, configurado mediante ServerOptions: IP, puerto, certificado SSL, ruta del endpoint y token de verificación. |
| Verificación del webhook | OnBeforeSubscribe se dispara con la petición de verificación de Meta, así que el endpoint responde al handshake de suscripción. |
| Mensajes entrantes de WhatsApp | OnMessageReceived entrega cada mensaje entrante, con un argumento var aMarkAsRead para enviar el acuse de lectura. |
| Estado de entrega | OnMessageSent informa del estado de los mensajes que has enviado. |
| Payloads en crudo | OnRawMessage expone el JSON del webhook exactamente como lo publicó Meta. |
| Actualizaciones de Telegram | No hace falta ningún webhook. TDLib mantiene su propia conexión con Telegram, y los mensajes nuevos llegan como eventos: OnMessageText, OnMessageDocument, OnMessagePhoto y OnMessageVideo. |
| Otros eventos de Telegram | OnNewChat, OnNewCallbackQuery y OnMessageSponsored cubren los chats nuevos, los callbacks de teclado y los mensajes patrocinados. |
| Eventos en crudo de Telegram | OnEvent entrega cada actualización de TDLib como JSON en crudo. |
APIs oficiales, y el mismo código fuente en todos los compiladores compatibles.
| Área | Detalle |
|---|---|
| Telegram | El TDLib oficial (Telegram Database Library), la propia librería cliente de Telegram. |
| La WhatsApp Business Cloud API, parte de la Graph API de Meta, sobre HTTPS. | |
| Plataformas de Telegram | A través de la librería nativa TDLib: Windows, macOS, Linux de 64 bits, Android e iOS. |
| Plataformas de WhatsApp | HTTPS puro, así que quedan cubiertas todas las plataformas de Delphi. |
| Compiladores | Delphi y C++ Builder 7 a 13. |
| Ediciones | El cliente de Telegram también se entrega dentro de sgcWebSockets desde Standard en adelante, el cliente de WhatsApp desde Professional en adelante, y All-Access lo incluye todo. |
| Licencias | Independiente. El runtime sgcWebSockets Core viene incluido y se entrega el código fuente completo. |