WhatsApp Cloud API Client — sgcWebSockets | eSeGeCe

WhatsApp Cloud API

Sende Template-, Text-, Medien- und interaktive Nachrichten über die WhatsApp Cloud API aus Delphi/C++Builder. Inklusive eingebautem HTTPS-Webhook-Listener für eingehende Ereignisse.

TsgcWhatsApp_Client

Delphi/C++Builder-Client für die WhatsApp Business Cloud API. Sende Nachrichten über HTTPS und betreibe einen Webhook-Endpunkt für Zustell- und Status-Ereignisse.

Komponenten-Klasse

TsgcWhatsApp_Client

Protokoll

WhatsApp Cloud API

Plattformen

Windows, macOS, Linux, iOS, Android

Edition

Standard / Professional / Enterprise

Token setzen, Nachrichten senden, Webhook betreiben

Setze WhatsAppOptions.Token und PhoneNumberId, rufe zum Senden eine SendMessage...-Methode auf und aktiviere anschließend StartServer sowie OnMessageReceived, um Antworten zu empfangen.

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

Was drinsteckt

Kombiniert einen HTTPS-Cloud-API-Client mit einem eingebauten Webhook-HTTPS-Server, sodass ein einziger Delphi-Prozess sowohl ausgehenden als auch eingehenden Verkehr abwickelt.

Nachrichten senden

SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation und SendMessageContact decken die wichtigsten Inhaltstypen der Cloud API ab.

Webhook-Listener

Die Komponente startet einen eigenen eingebetteten HTTPS-Server (StartServer/StopServer, konfiguriert über ServerOptions), um den von Meta geforderten Verifizierungs- und Zustell-Webhook bereitzustellen. OnMessageReceived und OnMessageSent liefern typisierte Ereignisse, OnRawMessage stellt das unveränderte JSON bereit.

Authentifizierung

OAuth-Bearer-Authentifizierung über WhatsAppOptions.Token; der Verifizierungs-Handshake des Webhooks wird automatisch gegen ServerOptions.WebhookOptions.Token geprüft, und OnBeforeSubscribe gibt deiner App eine letzte Gelegenheit, das Abonnement zu akzeptieren oder abzulehnen.

Template-Parameter

SendMessageTemplate akzeptiert benannte/positionale Parameter und einen Sprachcode, und die Komponente baut die von Meta erwartete typisierte Struktur auf.

Medien-Upload

Rufe SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo oder SendFileSticker mit einem lokalen Dateipfad auf; die Komponente lädt die Datei über UploadMedia hoch und referenziert die zurückgegebene Media-ID automatisch. DownloadMedia und DeleteMedia verwalten Assets, die bereits auf Metas Servern liegen.

TLS-gesicherter Webhook

Konfiguriere ServerOptions.SSLOptions für den eingehenden Webhook — Meta verlangt, dass er über TLS erreichbar ist. Die übergeordneten TLSOptions decken separat die ausgehenden HTTPS-Aufrufe an die Graph API ab.

Spezifikationen & Referenzen

Maßgebliche Quellen für die API, die diese Komponente implementiert.

Dokumentation & Demos

Direkter Link zur Komponenten-Referenz, hol dir das sofort lauffähige Demoprojekt und lade die Testversion herunter.

Online-Hilfe — API_Whatsapp Vollständige Referenz für Eigenschaften, Methoden und Ereignisse dieser Komponente.
Demo-Projekt — Demos\50.Other\05.WhatsApp Sofort lauffähiges Beispielprojekt. Ist im sgcWebSockets-Paket enthalten — lade unten die Testversion herunter.
Technisches Dokument (PDF) Funktionen, Schnellstart, Code-Beispiele für Delphi & C++ Builder und Primärquellen — nur für diese Komponente.
Benutzerhandbuch (PDF) Umfassendes Handbuch zu allen Komponenten der Bibliothek.
Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Bereit, WhatsApp-Nachrichten zu senden?

Lade die kostenlose Testversion herunter und integriere die WhatsApp Cloud API in deine Delphi-Anwendungen.