WhatsApp Cloud API Client — sgcWebSockets | eSeGeCe

WhatsApp Cloud API

Delphi/C++Builder üzerinden WhatsApp Cloud API aracılığıyla şablon, metin, medya ve etkileşimli mesajlar gönderin. Gelen olaylar için yerleşik bir HTTPS Webhook dinleyicisi içerir.

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

Platformlar

Windows, macOS, Linux, iOS, Android

Sürüm

Standard / Professional / Enterprise

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

WhatsAppOptions.Token ve PhoneNumberId değerlerini ayarlayın, göndermek için bir SendMessage... metodu çağırın, ardından yanıt almak için StartServer'ı başlatın ve OnMessageReceived olayını bağlayın.

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

İç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

SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation ve SendMessageContact, başlıca Cloud API içerik türlerini kapsar.

Webhook dinleyicisi

Bileşen, Meta'nın gerektirdiği doğrulama ve teslim webhook'unu barındırmak için kendi gömülü HTTPS sunucusunu (ServerOptions üzerinden yapılandırılan StartServer/StopServer) başlatır. OnMessageReceived ve OnMessageSent tipli olaylar sunar, OnRawMessage ham JSON'u olduğu gibi gösterir.

Kimlik doğrulama

WhatsAppOptions.Token aracılığıyla OAuth Bearer kimlik doğrulaması kullanılır; webhook doğrulama el sıkışması ServerOptions.WebhookOptions.Token değerine karşı otomatik olarak kontrol edilir ve OnBeforeSubscribe, uygulamanıza aboneliği kabul veya reddetmek için bir şans daha tanır.

Şablon parametreleri

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

Medya yükleme

Yerel bir dosya yoluyla SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo veya SendFileSticker çağırın; bileşen dosyayı UploadMedia aracılığıyla yükler ve dönen medya kimliğine otomatik olarak başvurur. DownloadMedia ve DeleteMedia, Meta'nın sunucularında zaten bulunan varlıkları yönetir.

TLS korumalı Webhook

Gelen webhook için ServerOptions.SSLOptions değerini yapılandırın; Meta, webhook'un TLS üzerinden erişilebilir olmasını zorunlu kılar. Üst düzey TLSOptions ise Graph API'ye yapılan giden HTTPS çağrılarını ayrı olarak kapsar.

Spesifikasyonlar ve referanslar

Bu bileşenin uyguladığı API için yetkili 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ı.
Demo Projesi — Demos\50.Other\05.WhatsApp Çalışmaya hazır örnek proje. sgcWebSockets paketinin içinde gelir. Aşağıdan denemeyi indirin.
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.
Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.
En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

WhatsApp mesajları göndermeye hazır mısınız?

Ücretsiz denemeyi indirin ve WhatsApp Cloud API'yi Delphi uygulamalarınıza entegre edin.