Przejdź do treści
UsługiPortfolioBlogO mnieKontaktEnglish

Blog4 min czytania

Bot przestał umawiać rozmowy. Winny był jeden przełącznik

7 dni

po tylu dniach Google unieważnia token aplikacji w trybie testowym

Krótko

Asystent na mojej stronie umawia rozmowy telefoniczne prosto w moim kalendarzu Google. 22 października przestał to robić i odpisywał „błąd techniczny”. Przyczyną był jeden przełącznik w ustawieniach Google. Opisuję, jak to znalazłem, co poprawiłem i co sprawdzam od teraz przy każdym takim projekcie.

Asystent działa prosto. Gdy ktoś napisze, że chce porozmawiać, i poda imię, telefon oraz termin między 15:00 a 21:00, w moim kalendarzu pojawia się 30-minutowe wydarzenie, a na telefon dostaję powiadomienie. Żeby strona mogła wpisywać coś do kalendarza, Google wydaje jej klucz dostępu, tak zwany token. Strona trzyma go na serwerze i używa przy każdej rezerwacji.

Objaw

Zamiast potwierdzenia asystent napisał, że rozmowa nie mogła zostać zapisana z powodu błędu technicznego, i poprosił o inny termin. To drugie było gorsze od samego błędu. Inny termin też by nie przeszedł, bo problem nie miał nic wspólnego z godziną.

Diagnoza: logi, nie zgadywanie

Pierwszy krok to logi serwera z chwili tej rozmowy. Był w nich jeden konkretny błąd: invalid_grant. Google odpowiada tak, gdy token jest nieważny, czyli wygasł albo został cofnięty. Kod działał bez zmian, przestał działać klucz.

Pytanie brzmiało więc: dlaczego klucz, który miał działać bez końca, wygasł? Odpowiedź była w ustawieniach projektu w Google Cloud. Aplikacja, przez którą strona łączy się z kalendarzem, miała status Testowanie. W tym trybie Google unieważnia tokeny po 7 dniach. To zabezpieczenie dla aplikacji w trakcie budowy. Przy działającej stronie oznacza, że co tydzień coś po cichu się psuje.

Naprawa w trzech krokach

  1. Uzupełnienie danych aplikacji: adres strony, link do polityki prywatności i domena. Bez tego Google nie pozwala zmienić statusu.
  2. Zmiana statusu na „W wersji produkcyjnej”. W tym trybie token nie wygasa po tygodniu. Przestaje działać dopiero wtedy, gdy ktoś sam cofnie dostęp na koncie Google.
  3. Nowy token. Klucz wydany jeszcze w trybie testowym i tak by wygasł, więc po zmianie statusu zalogowałem się ponownie i wgrałem nowy na serwer. Potem sprawdziłem, że strona znowu ma dostęp do kalendarza.

Co, jeśli kalendarz padnie z innego powodu

Sama naprawa przyczyny to za mało. Usługa zewnętrzna może przestać odpowiadać z wielu powodów, więc zmieniłem też zachowanie asystenta przy awarii:

  • nie prosi już o inny termin, bo to nic nie zmienia,
  • imię, telefon i proponowany termin przychodzą do mnie jako pilne powiadomienie, więc zgłoszenie nie ginie,
  • klient dostaje uczciwą informację, że oddzwonię, a gdyby i powiadomienie nie przeszło, dostaje mój numer i e-mail.

Czego mnie to nauczyło

Moja własna notatka do tego projektu mówiła, że token „nie wygasa”. Była prawdziwa tylko połowicznie, bo zależała od ustawienia, o którym nie pisała. Poprawiłem ją. Od teraz przy każdym asystencie, który zapisuje coś w kalendarzu albo innej usłudze Google, status produkcyjny sprawdzam przed oddaniem, a nie po pierwszej awarii.

Jeśli masz na stronie formularz, czat albo rezerwacje połączone z inną usługą i nie wiesz, czy na pewno działają, napisz. Sprawdzę, co dzieje się po kliknięciu „wyślij”.