Client WhatsApp Cloud API — sgcWebSockets

EN BREF

TsgcWhatsApp_Client

Client Delphi/C++Builder pour l'API WhatsApp Business Cloud. Envoie des messages via HTTPS, héberge un endpoint Webhook pour les événements de livraison et de statut.

Classe du composant

TsgcWhatsApp_Client

Protocole

WhatsApp Cloud API

Plateformes

Windows, macOS, Linux, iOS, Android

Édition

Standard / Professional / Enterprise

DÉMARRAGE RAPIDE

Configure le token, envoie des messages, héberge le Webhook

Configure AccessToken et PhoneNumberId, lie le serveur WebHook à un TsgcWebSocketHTTPServer, puis SendMessage pour l'envoi et OnInboundMessage pour les réponses.

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', 'hello from 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", "hello from Delphi");

FONCTIONNALITÉS TECHNIQUES

Ce qu'il contient

Combine un client HTTPS Cloud API avec un serveur Webhook HTTPS intégré pour qu'un seul processus Delphi gère le trafic sortant et entrant.

Envoi de messages

SendTextMessage, SendTemplateMessage, SendMediaMessage, SendInteractiveMessage, SendLocationMessage et SendContactMessage couvrent les principaux types de contenu de l'API Cloud.

Écouteur Webhook

Le composant intègre un TsgcWebSocketHTTPServer pour héberger le webhook de vérification + livraison exigé par Meta. OnInboundMessage et OnStatusUpdate livrent des événements typés.

Authentification

Authentification OAuth Bearer via CloudOptions.AccessToken ; la vérification du verify-token se fait automatiquement contre CloudOptions.VerifyToken lors du premier probe GET du webhook.

Paramètres de template

SendTemplateMessage accepte des paramètres nommés/positionnels, un code de langue et le composant configure la structure typée que Meta exige.

Upload de média

Le composant gère l'upload de média multi-étapes de l'API Cloud (upload → obtenir media-id → référencer dans l'envoi) quand tu appelles SendMediaMessage avec un chemin de fichier local.

Webhook sécurisé TLS

Configure les SSLOptions du serveur intégré pour HTTPS — Meta exige que le Webhook soit accessible via TLS. WatchDog gère la reliure de port lors de la rotation des certificats.

STANDARDS

Spécifications et références

Sources de référence pour l'API que ce composant implémente.

RESSOURCES

Documentation et démos

Accès direct à la référence du composant, récupère le projet de démo prêt à l'emploi et télécharge l'essai.

	Aide en ligne — API_Whatsapp Référence complète des propriétés, méthodes et événements de ce composant.	Ouvrir
	Projet de démo — Demos\50.Other\05.WhatsApp Projet d'exemple prêt à l'emploi. Livré avec le paquet sgcWebSockets — télécharge l'essai ci-dessous.	Ouvrir
	Document technique (PDF) Fonctionnalités, démarrage rapide, exemples de code pour Delphi et C++ Builder et références aux sources primaires — ce composant uniquement.	Ouvrir
	Manuel utilisateur (PDF) Manuel complet couvrant tous les composants de la bibliothèque.	Ouvrir

API WhatsApp Cloud