Wysyłaj i odbieraj wiadomości za pomocą hostowanej w chmurze wersji platformy WhatsApp Business. Cloud API umożliwia implementację interfejsów API WhatsApp Business bez konieczności hostowania własnych serwerów, a także ułatwia skalowanie komunikacji biznesowej. Cloud API obsługuje do 80 wiadomości na sekundę w trybie łączonym wysyłania i odbierania (łącznie wiadomości tekstowych i multimedialnych).
WhatsApp Business API umożliwia średnim i dużym firmom komunikację z klientami na dużą skalę. Korzystając z API, firmy mogą budować systemy łączące tysiące klientów z agentami lub botami, co umożliwia zarówno programową, jak i ręczną komunikację. Ponadto API można integrować z wieloma systemami zaplecza, takimi jak platformy CRM i marketingowe.
Firmy będą szybciej otrzymywać wszystkie nowe funkcje w Cloud API. Obecnie WhatsApp Business Cloud API zawiera wszystkie funkcje dostępne w WhatsApp Business API.
Przydatne funkcje WhatsApp Cloud API:
Aby wysłać i odebrać pierwszą wiadomość przy użyciu numeru testowego, wykonaj następujące kroki:
1. Skonfiguruj zasoby deweloperskie i dostęp do platformy
Utwórz aplikację Meta: Przejdź do developers.facebook.com > Moje aplikacje > Utwórz aplikację. Wybierz typ „Biznes" i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.
Z poziomu pulpitu aplikacji należy kliknąć aplikację, którą chcesz połączyć z WhatsApp. Przewiń w dół, aby znaleźć produkt „WhatsApp" i kliknij Konfiguruj.
Następnie zostanie wyświetlona opcja wyboru istniejącego Business Managera (jeśli użytkownik go posiada) lub — opcjonalnie — automatycznego utworzenia nowego podczas procesu wdrażania (konfigurację firmy można dostosować później). Należy dokonać wyboru i kliknąć Kontynuuj.
Po kliknięciu przycisku Continue proces wdrożenia wykonuje następujące działania:
2. Wyślij wiadomość testową
Teraz można otworzyć środowisko IDE i utworzyć nowy projekt. Należy upuścić komponent TsgcWhatsapp_Client i wypełnić następujące właściwości:
Po prawidłowym skonfigurowaniu obu właściwości należy wywołać metodę SendTest, aby wysłać pierwszą wiadomość na numer telefonu za pośrednictwem platformy WhatsApp Business.
oClient := TsgcWhatsapp_Client.Create(nil);
oClient.WhatsappOptions.PhoneNumberId := '107809351952205';
oClient.WhatsappOptions.Token := 'EAAO4OpgZAs98BAGj3nCFGr...ZB2t8mmLB2LRXJkte2Y5PMNh2';
oClient.SendTest('34605889421');
3. Skonfiguruj webhook
Aby otrzymywać powiadomienia o odebraniu wiadomości lub zmianie jej statusu, należy skonfigurować punkt końcowy Webhooks dla aplikacji. Konfiguracja Webhooks nie wpływa na status numeru telefonu i nie zakłóca wysyłania ani odbierania wiadomości.
Aby rozpocząć, należy najpierw utworzyć punkt końcowy, konfigurując właściwość ServerOptions komponentu klienta WhatsApp i ustawiając następujące właściwości:
Po skonfigurowaniu serwera można użyć metody StartServer, aby uruchomić serwer i zacząć akceptować przychodzące żądania.
oClient := TsgcWhatsapp_Client.Create(nil);
oClient.ServerOptions.WebhookOptions.Endpoint := '/webhook';
oClient.ServerOptions.WebhookOptions.Token := 'MySecretToken';
oClient.StartServer();
Po przygotowaniu punktu końcowego należy przejść do panelu aplikacji.
Na pulpicie nawigacyjnym aplikacji znajdź produkt WhatsApp i kliknij Konfiguracja. Następnie znajdź sekcję webhooków i kliknij Skonfiguruj webhook. Po kliknięciu na ekranie pojawi się okno dialogowe, w którym należy podać dwie informacje:
Po dodaniu informacji należy kliknąć Verify and Save.
Po powrocie do Panelu aplikacji kliknij WhatsApp > Konfiguracja w lewym panelu. W sekcji Webhooks kliknij Zarządzaj. Otworzy się okno dialogowe ze wszystkimi obiektami, o których można otrzymywać powiadomienia. Aby odbierać wiadomości od użytkowników, kliknij Subskrybuj dla opcji wiadomości.
4. Odbierz wiadomość testową
Za każdym razem, gdy zostanie odebrana nowa wiadomość, wywoływane jest zdarzenie klienta OnMessageReceived.
procedure OnMessageReceived(Sender: TObject; const aMessage: TsgcWhatsapp_Receive_Message; var aMarkAsRead: Boolean);
begin
DoLog('Received: ' + aMessage.Messages._Message[0].Id);
end;
Po skonfigurowaniu webhooka wyślij wiadomość na numer testowy, który został użyty. Powiadomienie z webhookiem zawierające treść wiadomości powinno dotrzeć natychmiast!
WhatsApp API nie zezwala na wysyłanie wiadomości tekstowych swobodnych do numerów telefonów, które nie nawiązały kontaktu z użytkownikiem w ciągu ostatnich 24 godzin. Jedynym sposobem wysłania wiadomości tekstowej do numeru, który nigdy nie kontaktował się z kontem deweloperskim, jest wysłanie szablonu (wcześniej zatwierdzonego przez Meta). Aby ominąć to ograniczenie podczas testowania wiadomości tekstowych swobodnych, należy najpierw wysłać wiadomość WhatsApp z numeru docelowego na numer konta deweloperskiego, a następnie przez 24 godziny będzie możliwe wysyłanie wiadomości tekstowych swobodnych.
OnBeforeSendMessage
To zdarzenie jest wywoływane przed wysłaniem wiadomości do serwerów WhatsApp. Dostęp do wewnętrznej wiadomości można uzyskać przez parametr RawMessage.
OnBeforeSubscribe
To zdarzenie jest wywoływane przed subskrypcją przez serwer danego tematu. Parametr Accept pozwala zezwolić lub odrzucić subskrypcję. Domyślnie serwer subskrybuje wszystkie żądane zdarzenia.
OnRawMessage
Zdarzenie jest wywoływane, gdy serwer odbiera nową wiadomość, która nie została jeszcze przetworzona, dzięki czemu uzyskuje się dostęp do surowej wiadomości.
OnMessageReceived
To zdarzenie jest wywoływane po odebraniu i przeanalizowaniu nowej wiadomości przez serwer. Ustawienie parametru MarkAsRead na True spowoduje, że nadawca otrzyma podwójny znacznik odczytu.
OnMessageSent
Zdarzenie jest wywoływane za każdym razem, gdy serwer odbiera nową wiadomość statusu dotyczącą wcześniej wysłanej wiadomości. Należy odczytać właściwość Status, aby sprawdzić, czy wiadomość została wysłana, dostarczona lub przeczytana.