Bot przestał umawiać rozmowy. Winny był jeden przełącznik
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
- Uzupełnienie danych aplikacji: adres strony, link do polityki prywatności i domena. Bez tego Google nie pozwala zmienić statusu.
- 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.
- 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”.