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 AccessToken e PhoneNumberId, collega il server WebHook a un TsgcWebSocketHTTPServer, quindi usa SendMessage per i messaggi in uscita e OnInboundMessage per le risposte.

uses
  sgcLibs;

var
  WA: TsgcWhatsApp_Client;
begin
  WA := TsgcWhatsApp_Client.Create(nil);
  WA.CloudOptions.AccessToken     := 'EAAG...';
  WA.CloudOptions.PhoneNumberId   := '123456789012345';
  WA.CloudOptions.VerifyToken     := 'my-webhook-secret';

  WA.OnInboundMessage := procedure(Sender: TObject;
    const aFrom, aText: string)
  begin
    Memo1.Lines.Add(aFrom + ': ' + aText);
  end;

  WA.Active := True;

  WA.SendTextMessage('+34666555444', 'ciao da Delphi');
end;
// uses: sgcLibs
TsgcWhatsApp_Client *WA = new TsgcWhatsApp_Client(this);
WA->CloudOptions->AccessToken   = "EAAG...";
WA->CloudOptions->PhoneNumberId = "123456789012345";

WA->Active = true;
WA->SendTextMessage("+34666555444", "ciao da Delphi");

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

SendTextMessage, SendTemplateMessage, SendMediaMessage, SendInteractiveMessage, SendLocationMessage e SendContactMessage coprono i principali tipi di contenuto della Cloud API.

Listener Webhook

Il componente integra un TsgcWebSocketHTTPServer per ospitare il webhook di verifica + consegna richiesto da Meta. OnInboundMessage e OnStatusUpdate consegnano eventi tipizzati.

Autenticazione

Autenticazione OAuth Bearer tramite CloudOptions.AccessToken; la verifica del token avviene automaticamente confrontandolo con CloudOptions.VerifyToken al primo probe GET del webhook.

Parametri dei template

SendTemplateMessage accetta parametri nominati/posizionali e codice di lingua, e il componente imposta la struttura tipizzata richiesta da Meta.

Upload di media

Il componente gestisce l'upload dei media in più passaggi della Cloud API (upload → ottieni media-id → riferimento nell'invio) quando chiami SendMediaMessage con un percorso di file locale.

Webhook protetto da TLS

Configura le SSLOptions del server integrato per HTTPS — Meta richiede che il Webhook sia raggiungibile via TLS. WatchDog gestisce il re-binding della porta in caso di rotazione del certificato.

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.

Pronto a inviare messaggi WhatsApp?

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