Client WhatsApp Cloud API — sgcWebSockets | eSeGeCe

API Cloud WhatsApp

Invia messaggi template, di testo, media e interattivi tramite la WhatsApp Cloud API da Delphi/C++Builder. Include un listener Webhook HTTPS integrato per gli eventi in entrata.

TsgcWhatsApp_Client

Client Delphi/C++Builder per la WhatsApp Business Cloud API. Invia messaggi su HTTPS, ospita un endpoint Webhook per eventi di consegna e stato.

Classe del componente

TsgcWhatsApp_Client

Protocollo

WhatsApp Cloud API

Piattaforme

Windows, macOS, Linux, iOS, Android

Edizione

Standard / Professional / Enterprise

Imposta il token, invia messaggi, ospita il Webhook

Imposta WhatsAppOptions.Token e PhoneNumberId, richiama un metodo SendMessage... per inviare, poi avvia StartServer e collega OnMessageReceived per ricevere le risposte.

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;
}

Cosa contiene

Combina un client HTTPS della Cloud API con un server Webhook HTTPS integrato, così un unico processo Delphi gestisce traffico in uscita e in entrata.

Invio di messaggi

SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation e SendMessageContact coprono i principali tipi di contenuto della Cloud API.

Listener Webhook

Il componente avvia un proprio server HTTPS integrato (StartServer/StopServer, configurato tramite ServerOptions) per ospitare il webhook di verifica e consegna richiesto da Meta. OnMessageReceived e OnMessageSent consegnano eventi tipizzati, mentre OnRawMessage espone il JSON non elaborato.

Autenticazione

Autenticazione OAuth Bearer tramite WhatsAppOptions.Token; l'handshake di verifica del webhook viene controllato automaticamente confrontandolo con ServerOptions.WebhookOptions.Token, e OnBeforeSubscribe offre alla tua applicazione un'ulteriore possibilità di accettare o rifiutare la sottoscrizione.

Parametri dei template

SendMessageTemplate accetta parametri nominati/posizionali e un codice di lingua, e il componente costruisce la struttura tipizzata richiesta da Meta.

Upload di media

Richiama SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo o SendFileSticker con il percorso di un file locale: il componente lo carica tramite UploadMedia e fa riferimento automaticamente al media id restituito. DownloadMedia e DeleteMedia gestiscono gli asset già presenti sui server di Meta.

Webhook protetto da TLS

Configura ServerOptions.SSLOptions per il webhook in entrata — Meta richiede che sia raggiungibile via TLS. Le TLSOptions di primo livello coprono separatamente le chiamate HTTPS in uscita verso la Graph API.

Specifiche e riferimenti

Fonti autorevoli per l'API che questo componente implementa.

Documentazione e demo

Collegamenti diretti al riferimento del componente, progetto demo pronto all'uso e download della versione di prova.

Guida online — API_Whatsapp Riferimento completo di proprietà, metodi ed eventi di questo componente.
Progetto demo — Demos\50.Other\05.WhatsApp Progetto di esempio pronto all'uso. Incluso nel pacchetto sgcWebSockets — scarica la versione di prova qui sotto.
Documento tecnico (PDF) Funzionalità, guida rapida, esempi di codice per Delphi e C++ Builder e riferimenti alle fonti primarie — solo questo componente.
Manuale utente (PDF) Manuale completo che copre ogni componente della libreria.
La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Pronto a inviare messaggi WhatsApp?

Scarica la versione di prova gratuita e integra la WhatsApp Cloud API nelle tue applicazioni Delphi.