Wysyłaj aktualizacje zamówień z WooCommerce na WhatsApp

Jak zamówienie w WooCommerce wywołuje wiadomość na WhatsApp?

Przez webhook WooCommerce i odbiornik. W WooCommerce wejdź w Ustawienia, Zaawansowane, Webhooki i dodaj webhook z tematem zamówienia, na przykład zamówienie utworzone lub zamówienie zaktualizowane, wraz z adresem URL dostarczania i sekretem. WooCommerce wysyła wtedy zamówienie jako JSON na ten adres URL przy każdym wystąpieniu zdarzenia.

Treść żądania ma stałą strukturę, więc nie da się skierować jej bezpośrednio do Cloud API. Pośrodku działa odbiornik: węzeł Webhook w n8n, trasa w PHP sklepu lub dowolna mała usługa. Odczytuje zamówienie, wybiera numer telefonu klienta i szczegóły potrzebne w wiadomości, a następnie wykonuje jedno żądanie HTTPS do endpointu wiadomości Cloud API dla połączonego numeru, przekazując token dostępu numeru jako token bearer.

Temat order.updated nie jest przypisany do jednego statusu, więc odbiornik powinien odczytać pole status zamówienia i wysyłać wiadomość raz dla każdej zmiany, na której Ci zależy. WooCommerce domyślnie dostarcza webhooki w tle przez wp-cron, więc wiadomość może dotrzeć z niewielkim opóźnieniem względem zamówienia.

Skąd odbiornik wie, że żądanie pochodzi ze sklepu?

Z podpisu WooCommerce. Każde dostarczenie zawiera nagłówek X-WC-Webhook-Signature, czyli zakodowany w base64 skrót HMAC-SHA256 surowej treści żądania, obliczony przy użyciu sekretu ustawionego w webhooku. Odbiornik oblicza ten sam skrót dla otrzymanej treści, porównuje oba wyniki i odrzuca wszystko, co się nie zgadza.

To sekret Twojego sklepu, więc w odróżnieniu od podpisu Meta przy przychodzących wiadomościach WhatsApp można go zweryfikować. Porównuj w stałym czasie i licz skrót z surowej treści, zanim sparsuje ją jakikolwiek framework, ponieważ ponownie zakodowany JSON daje inny skrót.

Odpowiadaj szybko kodem 2xx. WooCommerce uznaje za błąd każdą odpowiedź inną niż 2xx, 301 lub 302, a po więcej niż pięciu błędach z rzędu wyłącza webhook. Odbiornik niedostępny podczas wdrożenia albo wolny, bo czeka na Meta przed odpowiedzią, może wyłączyć wiadomości sklepu, zanim ktokolwiek to zauważy.

Co sklep może wysłać i kiedy?

Zatwierdzony szablon, za każdym razem gdy sklep pisze pierwszy. 24-godzinne okno obsługi klienta Meta otwiera się dopiero wtedy, gdy klient napisze na numer, więc potwierdzenie zamówienia lub informacja o wysyłce są inicjowane przez firmę, a dowolny tekst zostanie odrzucony. Utwórz szablon użytkowy dla każdej aktualizacji, poczekaj na zatwierdzenie i wysyłaj go według nazwy i języka, przekazując numer zamówienia i pozostałe dane jako parametry.

Meta wymaga też zgody: klient podał swój numer i zgodził się na kontakt tej firmy przez WhatsApp. Najprościej zapisać ją jako pole wyboru w koszyku zapisane przy zamówieniu, a odbiornik powinien to sprawdzić przed wysłaniem.

Gdy klient odpowie, rozmowa przebiega już jak zwykły Coexistence. Odpowiedź pojawia się w aplikacji WhatsApp Business na telefonie sklepu, okno jest otwarte dla dowolnego tekstu, a zespół odpowiada z aplikacji tak jak dotychczas.

Typowe błędy

• Wykonywanie wywołania Cloud API przed odpowiedzią dla WooCommerce. Wolna lub nieudana wysyłka liczy się jako błąd webhooka, który po więcej niż pięciu błędach zostaje wyłączony.
• Liczenie skrótu ze sparsowanego JSON zamiast z surowej treści. Podpis nigdy się nie zgadza i każde prawdziwe dostarczenie jest odrzucane.
• Wysyłanie przy każdym dostarczeniu order.updated. Temat nie jest przypisany do jednego statusu, więc bez śledzenia, o której zmianie już powiadomiono, klienci dostają duplikaty.

Najczęściej zadawane pytania

Czytaj dalej