Zapisuj wiadomości WhatsApp w Google Sheets i wysyłaj z arkusza

Jak każda wiadomość WhatsApp trafia do wiersza?

Meta wysyła każdą wiadomość z numeru na adres docelowy webhooka, który ustawisz. Tutaj jest to węzeł Webhook w n8n, który odpowiada też na żądanie weryfikacji od Meta. Kolejny węzeł to Google Sheets z operacją Append Row, mapujący pola z payloadu na kolumny: numer nadawcy, nazwę profilu, tekst, identyfikator wiadomości WhatsApp, znacznik czasu i identyfikator numeru telefonu odbiorcy.

Jeśli chcesz, by ponowne dostarczenia były nieszkodliwe, użyj Append or Update Row z kluczem w postaci identyfikatora wiadomości zamiast zwykłego dopisywania. Meta dostarcza wiadomość ponownie, gdy uzna, że dostarczenie się nie udało, a klucz na identyfikatorze zamienia drugie dostarczenie w aktualizację tego samego wiersza.

Na numerze Coexistence odpowiedzi wpisane w aplikacji WhatsApp Business trafiają do tego samego webhooka jako zdarzenia smb_message_echoes. Zapisz je z kolumną kierunku, a arkusz będzie zawierał obie strony rozmowy.

Gdzie przeszkadza limit Sheets?

Przy zapisach na użytkownika. Google Sheets API pozwala na 300 żądań zapisu na minutę na projekt i 60 na minutę na użytkownika na projekt, a poświadczenie n8n to jeden użytkownik. Przepływ dopisujący jeden wiersz na wiadomość może więc obsłużyć około jednej wiadomości na sekundę w sposób ciągły.

Dla większości numerów sklepowych to aż nadto. Przestaje wystarczać po wysyłce szablonu do wielu odbiorców, gdy kilkaset osób odpowiada w ciągu kilku minut. API odpowiada wtedy kodem 429 Too Many Requests i bez ponowień wiersze giną.

Są dwa rozwiązania, każde wystarczy. Włącz ponowienia z oczekiwaniem w węźle Google Sheets, co zgadza się z zaleceniem samego Google, by wycofywać się wykładniczo. Albo grupuj: niech n8n zbiera wiadomości przez trzydzieści sekund i dopisuje je jednym żądaniem, co zamienia wiele zapisów w jeden.

Jak wysyłać szablony z arkusza?

Za pomocą Apps Script, z menu Rozszerzenia w arkuszu. Funkcja odczytuje wiersze, które nie zostały jeszcze wysłane, dla każdego wywołuje endpoint wiadomości Cloud API przez UrlFetchApp i zapisuje w wierszu zwrócony identyfikator wiadomości oraz czas. Wyzwalacz czasowy może uruchamiać ją co kilka minut, a możesz też odpalać ją ręcznie z własnego menu.

Token dostępu przechowuj we właściwościach skryptu, a nie w kodzie, żeby osoby mające wgląd w skrypt go nie widziały.

Pamiętaj o limitach. Zwykłe konto Google ma 20 000 wywołań URL Fetch dziennie, a konto Workspace 100 000, a każde wykonanie kończy się po sześciu minutach. Przetwarzaj wiersze porcjami i oznaczaj każdy jako wysłany, zanim przejdziesz dalej, żeby przerwane uruchomienie wznowiło pracę od miejsca zatrzymania, zamiast wysyłać dwa razy.

function sendPending() {
  const token = PropertiesService.getScriptProperties().getProperty("WHATSAPP_TOKEN");
  const sheet = SpreadsheetApp.getActive().getSheetByName("Send");
  const rows = sheet.getDataRange().getValues();
  for (let i = 1; i < rows.length; i++) {
    const [phone, name, sentAt] = rows[i];
    if (sentAt) continue;
    const res = UrlFetchApp.fetch("https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/messages", {
      method: "post",
      contentType: "application/json",
      headers: { Authorization: "Bearer " + token },
      payload: JSON.stringify({
        messaging_product: "whatsapp", to: String(phone), type: "template",
        template: { name: "order_ready", language: { code: "en" },
          components: [{ type: "body", parameters: [{ type: "text", text: name }] }] },
      }),
    });
    sheet.getRange(i + 1, 3).setValue(new Date());
  }
}

Typowe błędy

• Dopisywanie bez klucza na identyfikatorze wiadomości. Ponowienia Meta zapisują wtedy tę samą wiadomość w dwóch wierszach.
• Zapisywanie jednego wiersza na wiadomość przez jedno poświadczenie podczas fali odpowiedzi. Limit 60 zapisów na minutę na użytkownika zwraca 429 i wiersze przepadają.
• Wysyłanie z arkusza dowolnego tekstu do osób, które nie pisały od 24 godzin. Poza tym oknem dociera tylko zatwierdzony szablon.

Najczęściej zadawane pytania

Czytaj dalej