Wysyłaj wiadomości o zamówieniach ze Shopify przez WhatsApp

Jak Shopify Flow wysyła wiadomość w WhatsApp?

Za pomocą akcji Send HTTP request, która wysyła żądanie POST na dowolny adres URL z nagłówkami i treścią, w której można używać zmiennych Liquid z wyzwalacza.

Utwórz przepływ na wyzwalaczu utworzenia zamówienia i dodaj Send HTTP request. Adres URL to endpoint wiadomości w Cloud API dla phone number id połączonego numeru. Dodaj nagłówek Authorization, którego wartością jest Bearer, a po nim token dostępu numeru, zapisany jako sekret we Flow i przywoływany jako zmienna sekretna. Wartości sekretów nigdy nie są widoczne w interfejsie Flow i są usuwane z logów uruchomień, czyli tam, gdzie token powinien być. Treścią żądania jest wiadomość z szablonu, z numerem telefonu klienta w polu `to` i szczegółami zamówienia jako parametrami szablonu.

Flow uznaje odpowiedź 2XX lub 3XX za sukces. Meta odpowiada na poprawne żądanie identyfikatorem wiadomości, więc udane uruchomienie oznacza, że Meta przyjęła wiadomość.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

Dlaczego wiadomość o zamówieniu musi być szablonem?

Ponieważ to sklep pisze jako pierwszy. 24-godzinne okno obsługi klienta w Meta otwiera się dopiero wtedy, gdy klient napisze do numeru. Potwierdzenie zamówienia, informacja o wysyłce czy przypomnienie o porzuconym koszyku są wysyłane wcześniej, więc dowolny tekst zostanie odrzucony i przejdzie tylko zatwierdzony wcześniej szablon.

Utwórz szablon raz, w kategorii utility dla aktualizacji zamówień i wysyłki, i poczekaj na zatwierdzenie, zanim włączysz przepływ. Nazwa i język w treści żądania muszą dokładnie odpowiadać zatwierdzonemu szablonowi, a liczba parametrów musi zgadzać się z jego miejscami na zmienne.

Jest też kwestia zgody. Meta wymaga zgody, zanim firma napisze do kogoś w WhatsApp: osoba podała swój numer i zgodziła się na otrzymywanie wiadomości od tej firmy. Zwykle zbiera się ją polem wyboru w koszyku z takim oświadczeniem, a przepływ powinien to sprawdzić przed wysłaniem.

Co zrobić, jeśli plan sklepu nie zawiera Send HTTP request?

Użyj zamiast tego webhooka administracyjnego Shopify. W sekcji Ustawienia, Powiadomienia, Webhooki sprzedawca może utworzyć webhook dla zdarzenia, takiego jak utworzenie zamówienia, w formacie JSON, wysyłany na adres URL. Skieruj go do odbiornika: węzła Webhook w n8n albo trasy w PHP, Pythonie lub Node. Odbiornik odczytuje zamówienie, sprawdza zgodę i wykonuje to samo wywołanie szablonu do Cloud API.

Niezależnie od tego, którą drogą wysyłasz, odpowiedzi wyglądają tak samo. Gdy klient odpowie na wiadomość o zamówieniu, odpowiedź trafia do aplikacji WhatsApp Business na telefonie sklepu, ponieważ numer działa w Coexistence, a 24-godzinne okno na dowolny tekst jest już otwarte. Jeśli ustawiono adres docelowy webhooka dla numeru, odpowiedź dociera także do Twojego systemu. Sama wiadomość o zamówieniu też jest widoczna w aplikacji, więc osoba odpowiadająca widzi, na co klient reaguje.

Typowe błędy

• Wysyłanie dowolnego tekstu po utworzeniu zamówienia. Klient nie napisał wcześniej, więc Meta go odrzuca; musi to być zatwierdzony szablon.
• Pozostawienie obsługi błędów na Retry dla odpowiedzi 4XX. Flow może przez 24 godziny ponawiać żądanie, którego Meta nigdy nie przyjmie.
• Wpisanie tokenu w nagłówku jako zwykłego tekstu. Zapisz go jako sekret we Flow, aby nie pojawiał się w interfejsie ani w logach.

Najczęściej zadawane pytania

Czytaj dalej