WhatsApp Business Platform'un bulutta barındırılan bir sürümünü kullanarak mesaj gönderin ve alın. Cloud API, kendi sunucularınızı barındırma maliyeti olmadan WhatsApp Business API'lerini uygulamanıza olanak tanır ve ayrıca işletme mesajlaşmanızı daha kolay ölçeklendirmenize olanak tanır. Cloud API, birleşik gönderme ve almada saniyede 80 mesaja kadar destekler (metin ve medya mesajları dahil).
WhatsApp Business API, orta ve büyük ölçekli işletmelerin müşterileriyle büyük ölçekte iletişim kurmasına olanak tanır. API'yi kullanarak işletmeler, binlerce müşteriyi acentelerle veya botlarla bağlayan sistemler oluşturabilir ve hem programatik hem de manuel iletişimi mümkün kılabilir. Ayrıca, API'yi CRM ve pazarlama platformları gibi çok sayıda arka uç sistemiyle entegre edebilirsiniz.
İşletmeler tüm yeni özellikleri Cloud API'de daha hızlı alacaktır. Şu anda, WhatsApp Business Cloud API, WhatsApp Business API'de kullanılabilen tüm özelliklerle birlikte gelir.
WhatsApp Cloud API'sinin kullanışlı özellikleri:
Bir test numarası kullanarak ilk mesajı gönderip almak için aşağıdaki adımları tamamlayın:
1. Developer Assets ve Platform Access'i kurun
Hesabınız için iki faktörlü kimlik doğrulamayı etkinleştirin
Meta Uygulaması Oluştur: Şuraya gidin: developers.facebook.com > My Apps > Create App. "Business" türünü seçin ve ekranınızdaki yönergeleri izleyin.
App Dashboard'dan, WhatsApp'a bağlamak istediğiniz uygulamaya tıklayın. "WhatsApp" ürününü bulmak için aşağı kaydırın ve Set up öğesine tıklayın.
Ardından, mevcut bir Business Manager seçme (varsa) veya isterseniz onboarding sürecinin sizin için otomatik olarak bir tane oluşturma seçeneğini göreceksiniz (gerekirse business'inizi daha sonra özelleştirebilirsiniz). Bir seçim yapın ve Continue'a tıklayın.
Continue'ya tıkladığınızda, onboarding süreci aşağıdaki eylemleri gerçekleştirir:
2. Bir Test Mesajı Gönderin
Şimdi IDE'nizi açıp yeni bir proje oluşturabilirsiniz. Bir TsgcWhatsapp_Client bileşeni yerleştirin ve aşağıdaki özellikleri doldurun:
Bu 2 özellik düzgün şekilde yapılandırıldıktan sonra, Whatsapp Business Platform kullanarak bir telefon numarasına İlk mesajınızı göndermek için SendTest yöntemini çağırın.
oClient := TsgcWhatsapp_Client.Create(nil);
oClient.WhatsappOptions.PhoneNumberId := '107809351952205';
oClient.WhatsappOptions.Token := 'EAAO4OpgZAs98BAGj3nCFGr...ZB2t8mmLB2LRXJkte2Y5PMNh2';
oClient.SendTest('34605889421');
3. Bir Webhook Yapılandırın
Bir mesaj aldığınızda veya bir mesajın durumu değiştiğinde uyarılmak için, uygulamanız için bir Webhooks uç noktası ayarlamanız gerekir. Webhooks'u ayarlamak telefon numaranızın durumunu etkilemez ve mesaj göndermenize veya almanıza engel olmaz.
Başlamak için önce uç noktayı oluşturmanız gerekir, bu nedenle önce WhatsApp Client bileşeninin ServerOptions özelliğini yapılandırın ve aşağıdaki özellikleri yapılandırın:
Sunucuyu yapılandırdıktan sonra, sunucuyu başlatmak ve gelen istekleri kabul etmek için StartServer yöntemini kullanabilirsiniz.
oClient := TsgcWhatsapp_Client.Create(nil);
oClient.ServerOptions.WebhookOptions.Endpoint := '/webhook';
oClient.ServerOptions.WebhookOptions.Token := 'MySecretToken';
oClient.StartServer();
Uç noktanız hazır olduğunda, App Dashboard'unuza gidin.
App Dashboard'unuzda WhatsApp ürününü bulun ve Configuration öğesine tıklayın. Ardından, webhooks bölümünü bulun ve Configure a webhook öğesine tıklayın. Tıklamadan sonra ekranınızda bir iletişim kutusu görünür ve sizden iki öğe ister:
Bilgileri ekledikten sonra, Verify and Save öğesine tıklayın.
App Dashboard'a geri dönün, sol taraftaki panelde WhatsApp > Configuration öğesine tıklayın. Webhooks altında Manage'a tıklayın. Bildirim alabileceğiniz tüm nesnelerle birlikte bir iletişim kutusu açılır. Kullanıcılarınızdan mesaj almak için messages için Subscribe'a tıklayın.
4. Bir test mesajı alın
Her yeni mesaj alındığında, istemci olayı OnMessageReceived çağrılır.
procedure OnMessageReceived(Sender: TObject; const aMessage: TsgcWhatsapp_Receive_Message; var aMarkAsRead: Boolean);
begin
DoLog('Received: ' + aMessage.Messages._Message[0].Id);
end;
Webhook'unuz artık kurulduğuna göre, kullandığınız test numarasına bir mesaj gönderin. Mesajınızın içeriğiyle hemen bir Webhooks bildirimi almalısınız!
WhatsApp API, daha önce (son 24 saat içinde) sizinle iletişime geçmemiş telefonlara serbest metin mesajları göndermeye izin vermez. Geliştirici hesap numaranıza hiç mesaj göndermemiş bir telefona metin mesajı göndermenin tek yolu, bir Template (önceden Meta tarafından onaylanmış) göndermektir. Serbest metin mesajlarını test etmek için bu sınırlamayı geçersiz kılmak amacıyla, önce hedef numaradan geliştirici hesap numaranıza bir WhatsApp mesajı gönderin, ardından 24 saat boyunca serbest metin mesajları gönderebilirsiniz.
OnBeforeSendMessage
Bu olay, mesaj WhatsApp sunucularına gönderilmeden önce çağrılır. RawMessage parametresi aracılığıyla dahili mesaja erişebilirsiniz.
OnBeforeSubscribe
Bu olay, sunucu bir topic'e abone olmadan önce çağrılır. Aboneliğe izin vermek veya reddetmek için Accept parametresini kullanın. Varsayılan olarak, sunucu istenen tüm olaylara abone olacaktır.
OnRawMessage
Bu olay, sunucu henüz ayrıştırılmamış yeni bir mesaj aldığında çağrılır, böylece ham mesaja erişirsiniz.
OnMessageReceived
Bu olay, sunucu yeni bir mesaj alıp ayrıştırdıktan sonra çağrılır. MarkAsRead parametresini True olarak ayarlarsanız, gönderici çift onay alır.
OnMessageSent
Bu olay, sunucu daha önce gönderilen mesaj hakkında yeni bir durum mesajı her aldığında çağrılır. Mesajın gönderilip gönderilmediğini, teslim edilip edilmediğini veya okunup okunmadığını bilmek için Status özelliğini okuyun.