← Blog

SMS z Google Sheets: wysyłka z arkusza przez Apps Script

Zespół Przypominamy.com · · 3 min czytania

Arkusz sprawdza się przy krótkiej liście przypomnień, którą człowiek chce przejrzeć przed wysłaniem. Przygotowany skrypt dodaje menu do Google Sheets, wysyła do 20 zaznaczonych wierszy i zapisuje wynik przy każdym numerze. Poniżej przejdziesz od pustego arkusza do kontrolowanej próby na własnym telefonie.

Kiedy wybrać arkusz, a kiedy automatyzację

Wybierz arkusz do jednorazowych powiadomień o odbiorze zamówienia lub ręcznie przygotowanej listy wizyt. Ten skrypt nie synchronizuje CRM i nie uruchamia cyklicznych kampanii. Jeśli wiadomość ma wychodzić po każdym zdarzeniu, sprawdź scenariusz Make lub workflow n8n.

1. Przygotuj kolumny i numer testowy

Utwórz prywatny arkusz. W pierwszym wierszu wpisz nagłówki od A do G:

numer | tresc | operacja | status | id_sms | migawka | poczatek

Kolumnę A sformatuj jako zwykły tekst, aby zachować znak plus. W A2 wpisz własny numer w formacie +48600100200, a w B2 gotową treść, np. „Twoje zamowienie jest gotowe do odbioru”. Przykładowy numer zastąp swoim i zweryfikuj go w panelu. Kolumny C–G pozostaw puste: służą skryptowi do kontroli wysyłki. Szablony {{imie}} nie są obsługiwane w tej wersji skryptu.

2. Wklej skrypt i zapisz osobisty klucz

Pobierz Code.gs. Otwórz Rozszerzenia → Apps Script, wklej kod, zapisz projekt i odśwież arkusz. Z menu Przypominamy.com → Zapisz mój klucz API podaj klucz z zakresami send i read. Pierwsze uruchomienie wymaga autoryzacji Google.

Klucz trafia do User Properties użytkownika, a nie do komórki. To nie zastępuje kontroli dostępu do skryptu: edytor może zmienić wykonywany kod. Udostępniaj arkusz tylko zaufanym osobom. Pełna instrukcja instalacji opisuje również usunięcie klucza.

3. Sprawdź koszt i potwierdź wysyłkę

Zaznacz jeden wiersz danych i wybierz wysyłkę z menu. Dialog pokaże liczbę SMS i szacowany koszt netto według konta. Potwierdzenie uruchamia rzeczywistą wysyłkę, także na koncie testowym. Skrypt obsługuje polskie numery; doładowanie i stawki sprawdzisz w cenniku.

Wynik przyjęcia pojawia się w D, identyfikator wiadomości w E. Przyjęcie przez API nie oznacza doręczenia. Końcowy status sprawdź w historii wiadomości. Ten skrypt nie pobiera automatycznie raportów doręczeń do arkusza.

Co zrobić po przerwaniu połączenia

Skrypt zapisuje identyfikator operacji i migawkę danych przed żądaniem. Po utracie odpowiedzi zachowaj kolumny C–G i ponów ten sam wiersz. Zmiana treści lub numeru blokuje ponowienie; po 23 godzinach nierozstrzygnięta próba wymaga ręcznego sprawdzenia historii. Nie kasuj identyfikatora po timeoutcie, ponieważ nowa operacja może oznaczać kolejny SMS.

Nie sortuj pojedynczych kolumn ani nie edytuj danych podczas wysyłki. Blokada skryptu ogranicza równoległe wykonania, ale nie blokuje ręcznej edycji. Nową wiadomość przygotuj w nowym wierszu. Przed pracą na liście klientów przetestuj brak numeru, odmowę wysyłki i ponowne uruchomienie zakończonego wiersza.

Najczęstsze pytania

Czy trzeba instalować dodatek Google Workspace?

Nie. To skrypt do samodzielnego wklejenia w Apps Script, a nie dodatek z Marketplace.

Czy arkusz odbiera odpowiedzi SMS?

Nie. Skrypt zapisuje wynik wysyłki. Odbiór odpowiedzi wymaga osobnego uruchomienia numeru odbiorczego i dodatkowej integracji.

Dokumentacja narzędzia

Interfejs i dostępność funkcji sprawdzaj na swoim koncie narzędzia.