WhatsApp Cloud API-client — sgcWebSockets | eSeGeCe

WhatsApp Cloud API

Verstuur template-, tekst-, media- en interactieve berichten via de WhatsApp Cloud API vanuit Delphi/C++Builder. Inclusief een ingebouwde HTTPS Webhook-listener voor inkomende events.

TsgcWhatsApp_Client

Delphi/C++Builder-client voor de WhatsApp Business Cloud API. Verstuur berichten via HTTPS en host een Webhook-endpoint voor delivery- en status-events.

Componentklasse

TsgcWhatsApp_Client

Platforms

Windows, macOS, Linux, iOS, Android

Editie

Standard / Professional / Enterprise

Stel token in, verstuur berichten, host Webhook

Stel WhatsAppOptions.Token en PhoneNumberId in, roep een SendMessage...-methode aan om berichten te versturen, en gebruik vervolgens StartServer met OnMessageReceived om antwoorden te ontvangen.

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

Wat zit erin

Combineert een HTTPS Cloud API-client met een ingebouwde Webhook HTTPS-server, zodat één Delphi-proces zowel uitgaand als inkomend verkeer afhandelt.

Berichten versturen

SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation en SendMessageContact dekken de belangrijkste Cloud API-inhoudstypes.

Webhook-listener

Het component start zijn eigen embedded HTTPS-server (StartServer/StopServer, ingesteld via ServerOptions) om de verificatie- en delivery-webhook te hosten die Meta vereist. OnMessageReceived en OnMessageSent leveren getypeerde events, OnRawMessage geeft toegang tot de ruwe JSON.

Authenticatie

OAuth Bearer-authenticatie via WhatsAppOptions.Token; de verificatiehandshake van de webhook wordt automatisch gecontroleerd tegen ServerOptions.WebhookOptions.Token, en OnBeforeSubscribe geeft je app nog een laatste kans om het abonnement te accepteren of te weigeren.

Template-parameters

SendMessageTemplate accepteert benoemde/positionele parameters en een taalcode; het component bouwt de getypeerde structuur op die Meta vereist.

Media-upload

Roep SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo of SendFileSticker aan met een lokaal bestandspad; het component uploadt het bestand via UploadMedia en verwijst automatisch naar het teruggegeven media-id. DownloadMedia en DeleteMedia beheren assets die al op de servers van Meta staan.

TLS-beveiligde Webhook

Configureer ServerOptions.SSLOptions voor de inkomende webhook — Meta vereist dat deze via TLS bereikbaar is. De top-level TLSOptions regelt afzonderlijk de uitgaande HTTPS-aanroepen naar de Graph API.

Specificaties & referenties

Officiële bronnen voor de API die dit component implementeert.

Documentatie & demo's

Deep-link naar de componentreferentie, pak het kant-en-klare demoproject en download de proefversie.

Online help — API_Whatsapp Volledige referentie van eigenschappen, methodes en events voor dit component.
Demoproject — Demos\50.Other\05.WhatsApp Kant-en-klaar voorbeeldproject. Wordt meegeleverd in het sgcWebSockets-pakket — download hieronder de proefversie.
Technisch document (PDF) Functies, snelstart, codevoorbeelden voor Delphi & C++ Builder en primaire bronverwijzingen — alleen voor dit component.
Gebruikershandleiding (PDF) Uitgebreide handleiding die elk component in de bibliotheek behandelt.
De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Klaar om WhatsApp-berichten te versturen?

Download de gratis proefversie en integreer de WhatsApp Cloud API in je Delphi-toepassingen.