TsgcWhatsApp_Client, WhatsApp için Meta Graph API'si olan WhatsApp Business Cloud API'yi konuşur. Metin, medya, konumlar, kişiler, tepkiler, etkileşimli listeler ve düğmeler ile onaylanmış şablonlar gönderin, ardından yanıtları ve teslimat durumunu yerleşik webhook sunucusu üzerinden alın. Delphi ve C++ Builder'da aynı bileşen ve aynı API.
Meta uygulamanızdan Phone Number ID'yi ve erişim token'ını WhatsAppOptions içine kopyalayın, SendMessage... metotlarını çağırın, ardından yanıtları alan webhook'u barındırmak için StartServer'ı çağırın.
TsgcWhatsApp_Client
WhatsApp Business Cloud API (Meta Graph API)
Saf HTTPS, tüm Delphi platformları
Delphi, C++ Builder
sgcWebSockets içinde de var. WhatsApp istemcisi ayrıca sgcWebSockets sürümlerinin içinde Professional sürümünden itibaren gelir. sgcSocial bağımsız pakettir, sgcWebSockets Core çalışma zamanı pakete dahildir.
WhatsAppOptions.PhoneNumberId ve Token'ı ayarlayın, bir metin gönderin, ardından Meta'nın gelen mesajları teslim edebilmesi için webhook sunucusunu başlatın. TsgcWhatsApp_Client, sgcLibs biriminde tanımlanır.
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');
// webhook server: receive messages and status updates
WhatsApp.ServerOptions.Port := 443;
WhatsApp.ServerOptions.SSL := True;
WhatsApp.ServerOptions.SSLOptions.CertFile := 'cert.pem';
WhatsApp.ServerOptions.SSLOptions.KeyFile := 'key.pem';
WhatsApp.ServerOptions.SSLOptions.Port := 443;
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");
// webhook server: receive messages and status updates
WhatsApp->ServerOptions->Port = 443;
WhatsApp->ServerOptions->SSL = true;
WhatsApp->ServerOptions->SSLOptions->CertFile = "cert.pem";
WhatsApp->ServerOptions->SSLOptions->KeyFile = "key.pem";
WhatsApp->ServerOptions->SSLOptions->Port = 443;
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;
}En sık başvurduğunuz üyeler.
WhatsAppOptions.PhoneNumberId ve WhatsAppOptions.Token, ikisi de Meta uygulamanızdan gelir. Her çağrı, Graph API'ye düz bir HTTPS isteğidir.
SendMessageText metin gönderir, SendMessageReaction bir mesaj kimliğine tepki verir ve MarkMessageRead okundu bilgisini gönderir.
SendMessageImage, SendMessageDocument, SendMessageAudio, SendMessageVideo ve SendMessageSticker, genel bir URL'de barındırılan medyaya referans verir.
SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo ve SendFileSticker önce yerel dosyayı yükler, ardından gönderir.
SendMessageLocation, ad ve adresle koordinatlar gönderir. SendMessageContact, kişi kartları gönderir.
Seçim listeleri için SendMessageInteractiveList, yanıt düğmeleri için SendMessageInteractiveButtons.
SendMessageTemplate; şablon adını, dil kodunu ve parametreleri alır.
UploadMedia, DownloadMedia ve DeleteMedia, Cloud API medya deposuyla doğrudan çalışır.
StartServer ve StopServer, ServerOptions üzerinden yapılandırılan Meta webhook'unu barındırır. OnBeforeSubscribe doğrulama isteğini yanıtlar, OnMessageReceived bir var aMarkAsRead argümanıyla gelen mesajları iletir, OnMessageSent teslimat durumunu bildirir ve OnRawMessage ham JSON'ı açığa çıkarır.
TLSOptions, HTTPS istemcisini yapılandırır; OnBeforeSendMessage giden mesajları inceler ve dosya günlüklemesi, sorun giderme için trafiği kaydeder.
| sgcSocial Genel BakışHer iki bileşen, sürümler ve lisanslama bir bakışta. | Aç | |
| Özellik Matrisi: WhatsAppBu bileşenin her yeteneği tablo halinde. | Aç | |
| WhatsApp API Derinlemesine İncelemeÇevrimiçi yardım ve PDF bağlantılarıyla API referans sayfası. | Aç | |
| Blog: WhatsApp Delphi BileşeniCloud API istemcisinin adım adım anlatımı. | Aç | |
| Blog: WhatsApp API ile Yerel Dosya GöndermeSendFile metotlarıyla yerel medya yükleme. | Aç |