Cliente de la WhatsApp Cloud API — sgcWebSockets | eSeGeCe

Cloud API de WhatsApp

Envía mensajes de plantilla, texto, media e interactivos a través de la WhatsApp Cloud API desde Delphi/C++Builder. Incluye un listener Webhook HTTPS integrado para los eventos entrantes.

TsgcWhatsApp_Client

Cliente Delphi/C++Builder para la WhatsApp Business Cloud API. Envía mensajes por HTTPS y aloja un endpoint Webhook para los eventos de entrega y estado.

Clase del componente

TsgcWhatsApp_Client

Protocolo

WhatsApp Cloud API

Plataformas

Windows, macOS, Linux, iOS, Android

Edición

Standard / Professional / Enterprise

Configura el token, envía mensajes, aloja el Webhook

Establece WhatsAppOptions.Token y PhoneNumberId, llama a un método SendMessage... para enviar, y luego StartServer y engancha OnMessageReceived para recibir respuestas.

uses
  sgcLibs;

var
  WhatsApp: TsgcWhatsApp_Client;
begin
  WhatsApp := TsgcWhatsApp_Client.Create(nil);
  WhatsApp.WhatsAppOptions.PhoneNumberId := '123456789012345';
  WhatsApp.WhatsAppOptions.Token := 'EAAG...';

  WhatsApp.SendMessageText('+34666555444', 'hello from Delphi');

  WhatsApp.OnMessageReceived := WhatsAppMessageReceived;
  WhatsApp.StartServer;
end;

procedure TForm1.WhatsAppMessageReceived(Sender: TObject;
  const aMessage: TsgcWhatsApp_Receive_Message;
  var aMarkAsRead: Boolean);
begin
  Memo1.Lines.Add(aMessage.RawMessage);
  aMarkAsRead := True;
end;
// include: sgcLibs.hpp

TsgcWhatsApp_Client *WhatsApp = new TsgcWhatsApp_Client(this);
WhatsApp->WhatsAppOptions->PhoneNumberId = "123456789012345";
WhatsApp->WhatsAppOptions->Token = "EAAG...";

WhatsApp->SendMessageText("+34666555444", "hello from Delphi");

WhatsApp->OnMessageReceived = WhatsAppMessageReceived;
WhatsApp->StartServer();

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

Qué incluye

Combina un cliente HTTPS de la Cloud API con un servidor HTTPS Webhook integrado, de modo que un único proceso Delphi gestiona el tráfico saliente y entrante.

Enviar mensajes

SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation y SendMessageContact cubren los principales tipos de contenido de la Cloud API.

Listener de Webhook

El componente arranca su propio servidor HTTPS integrado (StartServer/StopServer, configurado mediante ServerOptions) para alojar el webhook de verificación y entrega que exige Meta. OnMessageReceived y OnMessageSent entregan eventos tipados, y OnRawMessage expone el JSON sin procesar.

Autenticación

Autenticación OAuth Bearer mediante WhatsAppOptions.Token; la verificación del webhook se comprueba automáticamente contra ServerOptions.WebhookOptions.Token, y OnBeforeSubscribe da a tu aplicación una oportunidad más para aceptar o rechazar la suscripción.

Parámetros de plantilla

SendMessageTemplate acepta parámetros nombrados/posicionales, un código de idioma y el componente arma la estructura tipada que requiere Meta.

Subida de media

Llama a SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo o SendFileSticker con la ruta de un archivo local, el componente lo sube mediante UploadMedia y referencia automáticamente el media id devuelto. DownloadMedia y DeleteMedia gestionan los recursos que ya están en los servidores de Meta.

Webhook protegido con TLS

Configura ServerOptions.SSLOptions para el webhook entrante, que Meta exige que sea accesible por TLS. El TLSOptions de nivel superior cubre por separado las llamadas HTTPS salientes hacia la Graph API.

Especificaciones y referencias

Fuentes oficiales de la API que este componente implementa.

Documentación y Demos

Enlace directo a la referencia del componente, descarga el proyecto demo listo para ejecutar y consigue la prueba gratuita.

Ayuda en línea — API_Whatsapp Referencia completa de propiedades, métodos y eventos de este componente.
Proyecto demo — Demos\50.Other\05.WhatsApp Proyecto de ejemplo listo para ejecutar. Se incluye dentro del paquete sgcWebSockets Ready-to-run example project. Ships inside the sgcWebSockets package — download the trial below.mdash; descarga la prueba a continuación.
Documento técnico (PDF) Características, inicio rápido, ejemplos de código para Delphi y C++ Builder y referencias a fuentes primarias Features, quick start, code samples for Delphi & C++ Builder and primary-source references — this component only.mdash; solo de este componente.
Manual de usuario (PDF) Manual completo que cubre todos los componentes de la librería.
La mejor opción: All-AccessTodos los productos de eSeGeCe, con Premium Support incluido, desde €1,059 al año.
Ver precios de All-Access

¿Listo para enviar mensajes de WhatsApp?

Descarga la prueba gratuita e integra la WhatsApp Cloud API en tus aplicaciones Delphi.