API WhatsApp Cloud dla .NET

· Komponenty

Począwszy od sgcWebSockets 2022.6.0 obsługiwane jest WhatsApp Cloud API dla .NET.

Wysyłaj i odbieraj wiadomości za pomocą hostowanej w chmurze wersji platformy WhatsApp Business. Cloud API pozwala na implementację WhatsApp Business API bez kosztów utrzymywania własnych serwerów i umożliwia łatwiejsze skalowanie komunikacji biznesowej. Cloud API obsługuje do 80 wiadomości na sekundę łącznie (wysyłanie i odbieranie, włączając wiadomości tekstowe i medialne).

WhatsApp Business API pozwala średnim i dużym firmom na komunikację z klientami na dużą skalę. Za pomocą API firmy mogą budować systemy łączące tysiące klientów z agentami lub botami, umożliwiając zarówno programową, jak i ręczną komunikację. Ponadto API można integrować z wieloma systemami backendowymi, takimi jak platformy CRM i marketingowe.

Features 

Firmy będą szybciej otrzymywać wszystkie nowe funkcje w Cloud API. Już teraz WhatsApp Business Cloud API posiada wszystkie funkcje dostępne w WhatsApp Business API.

Przydatne funkcje WhatsApp Cloud API:

Get Started 

Aby wysłać i odebrać pierwszą wiadomość za pomocą numeru testowego, wykonaj następujące kroki:

1. Skonfiguruj zasoby deweloperskie i dostęp do platformy

Z pulpitu aplikacji kliknij aplikację, którą chcesz połączyć z WhatsApp. Przewiń w dół, znajdź produkt „WhatsApp" i kliknij Skonfiguruj.

Następnie zobaczysz opcję wyboru istniejącego Business Managera (jeśli go masz) lub — jeśli chcesz — proces wdrożenia może automatycznie go utworzyć (możesz dostosować swój profil biznesowy później, jeśli zajdzie taka potrzeba). Dokonaj wyboru i kliknij Kontynuuj.

Po kliknięciu Kontynuuj proces wdrożenia wykonuje następujące czynności:

2. Wyślij wiadomość testową

Otwórz swoje IDE i utwórz nowy projekt. Upuść komponent TsgcWhatsapp_Client i uzupełnij następujące właściwości:

Po poprawnym skonfigurowaniu tych 2 właściwości wywołaj metodę SendTest, aby wysłać swoją pierwszą wiadomość na numer telefonu za pomocą platformy WhatsApp Business.

TsgcWhatsapp_Client oClient = new TsgcWhatsapp_Client();
oClient.WhatsappOptions.PhoneNumberId = "107809351952205";
oClient.WhatsappOptions.Token = "EAAO4OpgZAs98BAGj3nCFGr...ZB2t8mmLB2LRXJkte2Y5PMNh2";
oClient.SendTest("34605889421");

3. Skonfiguruj webhook

Aby otrzymywać powiadomienia o odebranej wiadomości lub zmianie statusu wiadomości, musisz skonfigurować punkt końcowy Webhooks dla swojej aplikacji. Konfiguracja Webhooks nie wpływa na status twojego numeru telefonu ani na wysyłanie i odbieranie wiadomości.

Aby zacząć, najpierw utwórz punkt końcowy — skonfiguruj właściwość ServerOptions komponentu WhatsApp Client i ustaw następujące właściwości:

Po skonfigurowaniu serwera możesz użyć metody StartServer, aby uruchomić serwer i akceptować przychodzące żądania.

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

Gdy punkt końcowy jest gotowy, przejdź do pulpitu aplikacji.

W pulpicie aplikacji znajdź produkt WhatsApp i kliknij Konfiguracja. Następnie znajdź sekcję webhooks i kliknij Skonfiguruj webhook. Po kliknięciu pojawi się okno dialogowe z prośbą o podanie dwóch informacji:

Po wpisaniu informacji kliknij Zweryfikuj i zapisz.

Wróć do pulpitu aplikacji i kliknij WhatsApp > Konfiguracja w lewym panelu bocznym. W sekcji Webhooks kliknij Zarządzaj. Otworzy się okno dialogowe ze wszystkimi obiektami, o których możesz otrzymywać powiadomienia. Aby odbierać wiadomości od użytkowników, kliknij Subskrybuj dla wiadomości.

4. Odbierz wiadomość testową

Za każdym razem, gdy zostanie odebrana nowa wiadomość, zostanie wywołane zdarzenie klienta OnMessageReceived.

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


Teraz, gdy webhook jest skonfigurowany, wyślij wiadomość na użyty numer testowy. Powinieneś natychmiast otrzymać powiadomienie Webhooks z treścią twojej wiadomości!

Poniżej znajdziesz publiczne demo online bota WhatsApp — wystarczy wysłać dowolną wiadomość tekstową, aby zacząć.

WhatsApp Bot

Built with sgcWebSockets library, send any text message and the bot will show a list of options or echo your text message. https://www.esegece.com/demo/whatsapp

Poniżej znajdziesz skompilowane demo WhatsApp dla systemu Windows.