WhatsApp Cloud API Client — sgcWebSockets

BİR BAKIŞTA

TsgcWhatsApp_Client

WhatsApp Business Cloud API için Delphi/C++Builder istemcisi. HTTPS üzerinden mesaj gönderin, teslim ve durum olayları için bir Webhook uç noktası barındırın.

Bileşen sınıfı

TsgcWhatsApp_Client

Protokol

WhatsApp Cloud API

Platformlar

Windows, macOS, Linux, iOS, Android

Sürüm

Standard / Professional / Enterprise

HIZLI BAŞLANGIÇ

Belirteç ayarlayın, mesaj gönderin, Webhook barındırın

AccessToken ve PhoneNumberId ayarlayın, WebHook sunucusunu bir TsgcWebSocketHTTPServer'a bağlayın, ardından giden için SendMessage ve yanıtlar için OnInboundMessage kullanın.

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");

TEKNİK ÖZELLİKLER

İçinde neler var

Bir HTTPS Cloud API istemcisini yerleşik bir Webhook HTTPS sunucusuyla birleştirir, böylece tek bir Delphi süreci giden ve gelen trafiği yönetir.

Mesaj gönderme

SendTextMessage, SendTemplateMessage, SendMediaMessage, SendInteractiveMessage, SendLocationMessage ve SendContactMessage, başlıca Cloud API içerik türlerini kapsar.

Webhook dinleyicisi

Bileşen, Meta tarafından gereken doğrulama + teslim webhook'unu barındırmak için bir TsgcWebSocketHTTPServer gömer. OnInboundMessage ve OnStatusUpdate tipli olaylar sunar.

Kimlik doğrulama

CloudOptions.AccessToken aracılığıyla OAuth Bearer kimlik doğrulaması. İlk webhook GET yoklamasında doğrulama belirteci kontrolü, CloudOptions.VerifyToken değerine karşı otomatik olarak gerçekleşir.

Şablon parametreleri

SendTemplateMessage, adlandırılmış/konumsal parametreleri ve dil kodunu kabul eder; bileşen, Meta'nın gerektirdiği tipli yapıyı ayarlar.

Medya yükleme

Bir yerel dosya yoluyla SendMediaMessage çağırdığınızda bileşen, çok adımlı Cloud API medya yüklemesini (yükle → media-id al → gönderimde başvur) yönetir.

TLS korumalı Webhook

HTTPS için gömülü sunucunun SSLOptions değerini yapılandırın. Meta, Webhook'un TLS üzerinden erişilebilir olmasını gerektirir. WatchDog, sertifika rotasyonunda bağlantı noktasının yeniden bağlanmasını yönetir.

STANDARTLAR

Spesifikasyonlar ve referanslar

Bu bileşenin uyguladığı API için yetkili kaynaklar.

KAYNAKLAR

Belgeler ve Demolar

Bileşen referansına doğrudan bağlanın, çalışmaya hazır demo projesini alın ve denemeyi indirin.

	Çevrimiçi Yardım — API_Whatsapp Bu bileşen için tam özellik, metot ve olay referansı.	Aç
	Demo Projesi — Demos\50.Other\05.WhatsApp Çalışmaya hazır örnek proje. sgcWebSockets paketinin içinde gelir. Aşağıdan denemeyi indirin.	Aç
	Teknik Belge (PDF) Özellikler, hızlı başlangıç, Delphi ve C++ Builder için kod örnekleri ve birincil kaynak referansları. Yalnızca bu bileşen.	Aç
	Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.	Aç