.NET WhatsApp Cloud API

· Bileşenler

sgcWebSockets 2022.6.0 sürümünden itibaren WhatsApp Cloud API, .NET için desteklenmektedir.

WhatsApp Business Platform'un bulutta barındırılan bir sürümünü kullanarak mesaj gönderin ve mesaj 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çeklendirmenizi sağlar. Cloud API, gönderme ve alma toplamında saniyede 80 mesaja kadar destek verir (metin ve medya mesajları dahil).

WhatsApp Business API, orta ve büyük ölçekli işletmelerin müşterileriyle geniş ölçekte iletişim kurmasına olanak tanır. API'yi kullanarak işletmeler, binlerce müşteriyi temsilciler veya botlarla birbirine bağlayan sistemler oluşturabilir; bu da hem programatik hem de manuel iletişimi mümkün kılar. Ayrıca API'yi CRM ve pazarlama platformları gibi çok sayıda arka uç sistemiyle entegre edebilirsiniz.

Özellikler 

İşletmeler tüm yeni özelliklere Cloud API üzerinde daha hızlı erişir. Şu anda WhatsApp Business Cloud API, WhatsApp Business API ile birlikte sunulan tüm özelliklerle gelir.

WhatsApp Cloud API'nin faydalı özellikleri:

Başlarken 

Bir test numarası kullanarak ilk mesajı gönderip almak için aşağıdaki adımları tamamlayın:

1. Geliştirici Varlıklarını ve Platform Erişimini Ayarlayın

App Dashboard'dan, WhatsApp'a bağlamak istediğiniz uygulamaya tıklayın. Aşağı kaydırarak "WhatsApp" ürününü bulun ve Set up düğmesine 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şturmasını sağlama seçeneğini göreceksiniz (gerekirse işletmenizi daha sonra özelleştirebilirsiniz). Bir seçim yapın ve Continue düğmesine tıklayın.

Continue düğmesine tıkladığınızda, onboarding süreci aşağıdaki işlemleri 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 doğru şekilde yapılandırıldıktan sonra, Whatsapp Business Platform'u kullanarak bir telefon numarasına İlk mesajınızı göndermek için SendTest metodunu çağırın.

TsgcWhatsapp_Client oClient = new TsgcWhatsapp_Client();
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ı almak 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önderip almanıza müdahale etmez.

Başlamak için önce uç noktayı oluşturmanız gerekir; bu nedenle ilk olarak WhatsApp Client bileşeninin ServerOptions özelliğini yapılandırın ve aşağıdaki özellikleri ayarlayın:

Sunucuyu yapılandırdıktan sonra, sunucuyu başlatmak ve gelen istekleri kabul etmek için StartServer metodunu kullanabilirsiniz.

TsgcWhatsapp_Client oClient = TsgcWhatsapp_Client.Create();
oClient.ServerOptions.WebhookOptions.Endpoint = "/webhook";
oClient.ServerOptions.WebhookOptions.Token = "MySecretToken";
oClient.StartServer();

Uç noktanız hazır olduğunda, App Dashboard'ınıza gidin.

App Dashboard'ınızda WhatsApp ürününü bulun ve Configuration düğmesine tıklayın. Ardından webhooks bölümünü bulun ve Configure a webhook düğmesine tıklayın. Tıklamanın ardından ekranınızda bir iletişim kutusu belirir ve sizden iki öğe ister:

Bilgileri ekledikten sonra Verify and Save düğmesine tıklayın.

App Dashboard'a geri dönüp sol taraftaki panelde WhatsApp > Configuration öğesine tıklayın. Webhooks altında Manage düğmesine tıklayın. Hakkında bildirim alabileceğiniz tüm nesneleri içeren bir iletişim kutusu açılır. Kullanıcılarınızdan mesaj almak için messages için Subscribe düğmesine tıklayın.

4. Bir test mesajı alın

Yeni bir mesaj her alındığında, istemci olayı OnMessageReceived çağrılır.

void OnWhatsAppMessageReceived(TsgcWhatsApp_Client Sender, TsgcWhatsApp_Receive_Message Message, ref bool MarkAsRead)
{
  DoLog("Message Received: [" + Message.From + "] " + Message.Text);
  MarkAsRead = true;
}


Webhook'unuz artık ayarlandığına göre, kullandığınız test numarasına bir mesaj gönderin. Mesajınızın içeriğiyle birlikte anında bir Webhooks bildirimi almalısınız!

Aşağıda herkese açık çevrimiçi bir WhatsApp Bot Demosu bulabilirsiniz; başlamak için herhangi bir metin mesajı gönderin.

WhatsApp Bot

sgcWebSockets kütüphanesi ile oluşturulmuştur; herhangi bir metin mesajı gönderin, bot bir seçenek listesi gösterecek veya metin mesajınızı yansıtacaktır. https://www.esegece.com/demo/whatsapp

Aşağıda Windows için derlenmiş WhatsApp Demosunu bulabilirsiniz.