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.
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.
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.
TsgcWhatsApp_Client
Windows, macOS, Linux, iOS, Android
Standard / Professional / Enterprise
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;
}
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.
SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation ve SendMessageContact, başlıca Cloud API içerik türlerini kapsar.
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.
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.
SendMessageTemplate, adlandırılmış/konumsal parametreleri ve dil kodunu kabul eder; bileşen, Meta'nın gerektirdiği tipli yapıyı oluşturur.
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.
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.
Bu bileşenin uyguladığı API için yetkili kaynaklar.
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ç |