Jak połączyć aplikację zbudowaną z AI z narzędziami, których już używasz

Częsty moment w życiu aplikacji zbudowanej z AI: działa, używasz jej przez tydzień, a potem zauważasz, że kopiujesz z niej dane.

Może wklejasz nowe rejestracje klientów do Arkusza Google, który czyta Twój handlowiec. Może ręcznie przekazujesz przesłane formularze na kanał Slacka. Może kalendarz Twojego zespołu żyje w jednym miejscu, a Twoje rezerwacje w innym, i to Ty jesteś ludzkim klejem między nimi.

To moment, by połączyć aplikację z resztą Twoich narzędzi. Nie potrzebujesz programisty. Potrzebujesz jasnego obrazu, co powinno z czym rozmawiać, i kilku decyzji co do jak. To przewodnik, jak wpasować ją w zestaw narzędzi, którego już używasz.

Szczera prawda o integracjach

Większość ludzi myśli o integracjach jak o funkcji, którą dodajesz, jak tryb ciemny albo pasek wyszukiwania. Tak nie jest. Integracje to porozumienia między dwoma systemami co do tego, kto jest właścicielem jakich danych i co powinno się stać, gdy coś się zmieni.

Zanim poprosisz swojego kreatora AI, by „połączył ze Slackiem”, odpowiedz na trzy pytania:

Jakie zmiany w mojej aplikacji powinny coś wyzwolić gdzie indziej? (Nowa rejestracja, aktualizacja statusu, wgrany plik.)
Co powinno się stać gdzie indziej, gdy te zmiany zachodzą? (Wysłać wiadomość, dodać wiersz, wysłać mail.)
Czy coś musi wpłynąć z powrotem do mojej aplikacji? (Czasem odpowiedź brzmi nie, co jest dużo łatwiejsze.)

Im jaśniej masz te trzy rzeczy, tym prostsza integracja. Powodem, dla którego integracje robią się bałaganiarskie, zwykle nie jest technologia — to to, że nikt nie zdecydował z wyprzedzeniem, który system jest „właścicielem” danej informacji. Jeśli Twoja aplikacja i Twój Arkusz Google oba uważają się za źródło prawdy dla maili klientów, będziesz uzgadniał je w nieskończoność.

Trzy sposoby łączenia rzeczy

Są zasadniczo trzy wzorce podpinania aplikacji do innych narzędzi. Wybierz ten, który pasuje, i nie przemyśliwuj reszty.

1. Wychodzące powiadomienia (jednokierunkowo na zewnątrz)

To najprostszy i pokrywa więcej przypadków, niż ludzie oczekują. Twoja aplikacja coś robi. Wysyła gdzieś wiadomość. Gotowe.

Przykłady:

Nowe przesłanie formularza trafia na kanał Slacka.
Nowy klient wyzwala mail powitalny przez Twoje narzędzie mailowe.
Wgrany plik dostaje kopię w udostępnionym folderze Google Drive.

Powiedz swojemu kreatorowi AI: „Gdy tworzony jest nowy projekt, wyślij wiadomość na kanał Slacka z nazwą projektu, nazwą klienta i linkiem do strony projektu”. To pojedyncza instrukcja i większość kreatorów podłączy to webhookiem albo wbudowaną integracją ze Slackiem.

Ten wzorzec działa, bo nic nie wpływa z powrotem. Slack nie próbuje aktualizować Twojej aplikacji. Twoja aplikacja wystrzeliwuje i zapomina. Jeśli Slack nie działa przez godzinę, Twoja aplikacja wciąż działa dobrze — po prostu nie dostajesz powiadomień, aż wróci.

2. Zaplanowane synchronizacje (jednokierunkowo do środka lub na zewnątrz, na zegarze)

Gdy masz narzędzie, które ktoś inny aktualizuje, a Twoja aplikacja musi wiedzieć o zmianach, najłatwiejszym wzorcem jest zaplanowana synchronizacja. Raz na godzinę, raz dziennie Twoja aplikacja zaciąga najnowsze dane.

Przykłady:

Raz dziennie zaciągnij nowe wiersze z Arkusza Google do aplikacji jako szkice elementów do przeglądu.
Raz na godzinę odśwież listę nadchodzących rezerwacji z kalendarza.

Powód, dla którego to o tyle łatwiejsze niż integracje w czasie rzeczywistym: kolejność nie ma znaczenia. Jeśli synchronizacja zawiedzie dziś, jutrzejsza nadrobi wszystko. Nie musisz obsługiwać każdego przypadku skrajnego tak, jak musiałbyś przy połączeniu na żywo.

Większość kreatorów AI potrafi ustawić zaplanowane zadanie jedną instrukcją: „Każdego ranka o 8:00 pobierz nowe odpowiedzi z tego formularza Google i utwórz rekord dla każdej z nich w tabeli Przesłania”.

3. Webhooki (wzorzec czasu rzeczywistego)

Trzeci wzorzec, i ten, z którym trzeba uważać, to webhooki. Webhook to mała wiadomość, którą inne narzędzie wysyła Twojej aplikacji za każdym razem, gdy coś się dzieje. To wersja na żywo zaplanowanej synchronizacji.

Webhooki są potężne i tak buduje się poważne integracje. Są też miejscem, gdzie aplikacje zbudowane z AI najczęściej zbaczają z toru, bo ufasz innej usłudze, że prześle Ci dane poprawnie, i ufasz swojej aplikacji, że obsłuży to, co dostanie.

Używaj webhooków, gdy:

Potrzebujesz odpowiedzi w sekundy, nie minuty.
Narzędzie źródłowe je oferuje (większość nowoczesnych narzędzi tak).
Jesteś gotów przetestować przypadki awarii — co się stanie, jeśli webhook dotrze dwa razy? Co, jeśli nigdy nie dotrze?

Rozsądna instrukcja webhooka: „Dodaj endpoint webhooka pod /webhooks/stripe, który przyjmuje zdarzenia płatności. Gdy dotrze udana płatność, znajdź pasującego klienta po mailu i zaktualizuj jego status na »Opłacone«”. Potem to przetestuj. Wyślij fikcyjną płatność. Wyślij prawdziwą. Wyślij dwie z rzędu.

Pytanie o Zapiera

Wielu ludzi, gdy chcą coś połączyć, sięga najpierw po Zapiera albo Make’a. Jest ku temu dobry powód — te narzędzia to integracje jako produkt. Dają wizualny kreator, gdzie łączysz „gdy w narzędziu A dzieje się X, zrób Y w narzędziu B”.

Możesz jak najbardziej używać Zapiera ze swoją aplikacją zbudowaną z AI. Najczystszy wzorzec to:

Twoja aplikacja wysyła webhook do Zapiera, gdy dzieje się coś interesującego.
Zapier zajmuje się rozprowadzaniem — wiadomości na Slacku, powiadomienia mailowe, wiersze w arkuszu, aktualizacje CRM.

Po co kierować przez Zapiera zamiast prosić kreatora AI, by połączył z każdym narzędziem bezpośrednio? Dwa powody. Po pierwsze, gdy jutro zdecydujesz, że chcesz też tworzyć kartę w Trello, dodajesz to w Zapierze w dwie minuty zamiast prosić kreatora AI o ponowne wdrożenie. Po drugie, jeśli narzędzie po drugiej stronie zmieni swoje API (a robią to), Zapier obsłuży to bez potrzeby dotykania Twojej aplikacji.

Kompromisem jest koszt. Zapier szybko robi się drogi przy dużym wolumenie. Jeśli wysyłasz mniej niż kilkaset zdarzeń miesięcznie, Zapier to prawdopodobnie właściwy wybór. Jeśli wysyłasz dziesiątki tysięcy, poproś kreatora AI o integrację bezpośrednią.

Co przetestować, zanim temu zaufasz

Integracje zawodzą po cichu. To ich najgorsza cecha. Twój formularz może przestać synchronizować się z arkuszem, a Ty nie dowiesz się tego aż do tygodnia później, gdy ktoś zauważy, że arkuszowi brakuje dwunastu wierszy.

Trzy testy do przeprowadzenia na każdej integracji, którą dodasz:

Czy naprawdę działa od początku do końca? Nie weryfikuj tylko, że Twoja aplikacja wystrzeliła wiadomość. Przejdź do narzędzia docelowego i potwierdź, że wiadomość dotarła i wygląda dobrze.
Co się dzieje, gdy cel nie działa albo jest błędny? Wstrzymaj swojego zapa w Zapierze. Prześlij dane. Czy Twoja aplikacja obsługuje to z gracją, czy zwraca błąd i odmawia zapisania danych lokalnie? (Chcesz z gracją.)
Czy jest sposób, by ponowić albo wysłać ponownie? Jeśli coś pójdzie nie tak, czy możesz ponownie uruchomić integrację dla konkretnego rekordu? Jeśli odpowiedź brzmi nie, zbudowałeś jednokierunkową zapadnię.

Jeśli Twój kreator AI nie podaje odpowiedzi na te z własnej woli, zapytaj. „Skąd mam wiedzieć, czy wiadomość na Slacku nie udało się wysłać?” to rozsądna rzecz do zapytania, a odpowiedź powinna brzmieć coś w stylu „błędy są logowane tutaj, a ponowić możesz z tej strony”.

Rozsądny punkt startu

Jeśli dopiero zaczynasz dodawać integracje, oto pragmatyczna kolejność:

Jedno wychodzące powiadomienie — wybierz to jedno najbardziej użyteczne. „Gdy pojawi się nowy lead, opublikuj na Slacku” albo „Gdy projekt zostanie oznaczony jako Ukończony, wyślij mail do klienta”.
Jedna zaplanowana synchronizacja — zwykle wyciągająca dane z Twojej aplikacji do miejsca, gdzie Twój zespół już pracuje (udostępniony arkusz, CRM).
Potem, tylko jeśli naprawdę tego potrzebujesz, webhook dla jednego konkretnego przypadku czasu rzeczywistego.

Większość aplikacji nigdy nie potrzebuje więcej niż to. Te, które potrzebują, prowadzą prawdziwe biznesy, a zanim osiągniesz tę skalę, będziesz dokładnie wiedział, których połączeń brakuje.

Jeśli wpatrujesz się w aplikację zbudowaną z AI i czujesz, że to wyspa, wybierz tę jedną integrację, która zaoszczędziłaby Ci najwięcej kopiowania i wklejania w tym tygodniu, i zacznij od niej. Reszta stanie się oczywista, gdy ta jedna zacznie działać.