Make: Moduł My Apps

0:00Cześć!

0:00W tej lekcji pokażę Ci, w jaki sposób możesz tworzyć własne moduły w Integromacie

0:04wykorzystując tą oto dokumentację i można ją nawet porównać do jakiejś rozbudowanej

0:09biblioteki bądź frameworka wykorzystywanego przez programistów.

0:12Natomiast jednocześnie takie podstawowe tworzenie modułów nie wymaga nawet

0:16skomplikowanej wiedzy programistycznej, tylko co najwyżej oswojenia się z

0:20obiektami JSON oraz umiejętności posługiwania się protokołem HTTP.

0:24Tutaj w pierwszej kolejności zaznaczę, że aby utworzyć aplikację przechodzimy do

0:28panelu My Apps, a następnie wybieramy opcję Create a new app.

0:33Jednak zanim to zrobimy, chciałbym

0:34powiedzieć Ci, dlaczego w ogóle chcemy tworzyć własne aplikacje.

0:38Otóż może to nas interesować w trzech scenariuszach.

0:41Pierwszy uwzględnia sytuację, w której jesteśmy programistami.

0:44Stworzyliśmy jakąś aplikację, a następnie chcemy stworzyć integrację w Integromacie.

0:48Coś takiego, jak widzisz, wykorzystałem

0:50już wielokrotnie do stworzenia aplikacji, które sam projektuję.

0:53Drugim scenariuszem, w przypadku których własne moduły mogą okazać się przydatne,

0:57jest sytuacja, w której masz często powtarzany scenariusz.

1:01Tutaj, tak jak pokazywałem, możesz

1:02zaprojektować w taki sposób, aby używać go wielokrotnie.

1:06W takiej sytuacji możesz nawet przygotować

1:08moduł, który umożliwi Ci łatwe uruchomienie tego scenariusza i

1:12przekazanie na niego odpowiednio sformatowanych danych.

1:15No i ostatnim scenariuszem, którego osobiście jeszcze nie wykorzystywałem,

1:18jest projektowanie aplikacji, które wykorzystują API jakichś usług bądź

1:22aplikacji, które jest dostępne dla użytkowników, ale jednocześnie te usługi

1:27czy aplikacje nie są dostępne z poziomu Integromatu.

1:29W takiej sytuacji możemy stworzyć

1:31własną, nieoficjalną integrację, która będzie dostępna tylko dla nas.

1:35I swoją drogą, jeżeli jesteśmy już w temacie dostępności, to jak widzisz

1:39niektóre moje aplikacje są oznaczone jako publiczne, a inne jako prywatne.

1:43Dodatkowo chciałbym tutaj podkreślić jeden mały fakt.

1:45Mianowicie pomimo tego, że np.

1:47integracja EasyBanner jest dostępna

1:49publicznie, nadal jest ona dostępna tylko w ramach zaproszenia.

1:53Aby nasza aplikacja była dostępna globalnie w samym Integromacie, wymagane

1:57jest przejście całego i długiego procesu review ,który składa się

2:01z etapu automatycznego oraz ręcznego. W tym procesie weryfikowana jest bardzo

2:05długa chesklist'a lista oczekiwań Integromat'u względem nas projektantów aplikacji.

2:09Do tego, aby nasz moduł mógł zostać

2:11zaakceptowany i tym samym udostępniony wszystkim użytkownikom.

2:15Dla mnie osobiście nie ma z tym

2:17najmniejszego problemu, ponieważ większość modułów tworzę na własne potrzeby lub też

2:21po prostu sprzedaję, udostępniając również link do zaproszenia.

2:25Wracając jednak do projektowania naszej

2:27aplikacji, to na samym początku chciałbym skupić się na tym scenariuszu, w którym

2:31projektujemy aplikację jako programiści i chcemy podłączyć ją do Integromatu.

2:35Ponieważ nie będziemy tego robić krok po

2:37kroku, aczkolwiek dla osób, które są tym zainteresowane dodam tylko, że jedyne co

2:42musimy zrobić po zaprojektowaniu aplikacji, to po prostu udostępnić ją pod

2:46określonym adresem oraz utworzyć specjalny endpoint w naszej aplikacji, umożliwiający

2:51połączenie z pomocą wybranego przez nas procesu.

2:54Dla przykładu w moim przypadku

2:56uwzględniamy tutaj klucz API i mamy specjalny endpoint, na który kierowane

3:00jest zapytanie w momencie tworzenia połączenia i oczekiwanie Integromatu

3:04sprowadza się tutaj do tego, aby z tego

3:06adresu URL otrzymać status 200, sygnalizujący, że w tym przypadku klucz

3:11API został poprawnie odnaleziony i zatwierdzony.

3:14Poza tym wszystkie pozostałe kroki będą tutaj wspólne dla każdego scenariusza

3:18wykorzystania możliwości tworzenia modułu w Integromacie.

3:21No i teraz tak naprawdę w temacie tworzenia aplikacji tak naprawdę

3:25najbardziej interesują Cię te trzy zakładki.

3:27Pierwszym z nich będzie połączenie, o

3:29którym już powiedziałem i ono akurat będzie wykorzystywane tylko w przypadku,

3:32gdy łączysz Integromat z własną aplikacją, bądź też łączysz się z gotowym API.

3:37W przypadku tworzenia modułów, który

3:39będzie stworzony po to, aby wywoływać Twoje scenariusze w Integromacie.

3:43Zakładka połączenia nie jest tutaj wymagana.

3:45Następną zakładką jest opcja tworzenia webhook'ów, które

3:48w tym przypadku po prostu nazywamy,

3:50a następnie ustalamy, czy chodzi tutaj o dedykowany adres URL czy współdzielony.

3:55Różnica pomiędzy nimi jest taka, że w przypadku współdzielonego adresu URL

4:00musimy wskazać tutaj połączenie i webhook generowany jest przez aplikację, a w

4:04sytuacji, gdy mamy dedykowany adres URL, tutaj nie musimy podawać połączenia, o ile

4:09webhook nie jest rejestrowany przez naszą aplikację.

4:12W praktyce webhook generowany jest analogicznie jak natywny webhook Integromatu,

4:16którego adres możemy po prostu ręcznie skopiować i wkleić do aplikacji, która go

4:21wymaga lub nawet wywołać ręcznie z poziomu Insomni czy Postman'a.

4:25Natomiast jednocześnie, jeżeli aplikacja to wspiera, możemy tutaj ustawić

4:29połączenie, a następnie skonfigurować webhook tak, aby był podłączany oraz

4:33odłączany automatycznie bez konieczności ręcznego wklejania.

4:37Poza tym możemy tutaj określić strukturę danych, które do nas wracają oraz

4:42parametry, które należy podać w momencie tworzenia takiego webhook'a.

4:46Ja osobiście zwykle nie korzystam z tego pola.

4:48Natomiast takie parametry możemy spotkać

4:50chociażby w przypadku WebFlow, gdzie mamy tutaj webhook powiązane ze zdarzeniami.

4:55W momencie jego tworzenia nie tylko określamy jego nazwę, ale również podajemy

5:00dodatkowe informacje, które pozwalają podłączyć go do odpowiedniego projektu.

5:04Zatem jak widzisz, coś takiego również może okazać się przydatne.

5:07Natomiast na potrzeby tworzenia prostych

5:09automatyzacji w zupełności nie jest potrzebne.

5:12Jeżeli chodzi o webhook'i, również nie będziemy się tutaj za bardzo skupiać.

5:16Ze względu na to, że ten moduł będzie

5:18przydatny nam tylko wtedy, gdy rzeczywiście będziemy pracować z aplikacją

5:21udostępniającą API zaprojektowane przez nas lub też ewentualnie w pojedynczych

5:26przypadkach będziemy podpinać się pod API usług, które faktycznie

5:30podobnie jak WebFlow, oferują możliwość podłączenia webhook'ów.

5:33W każdym razie z mojego punktu widzenia

5:35jest to zaawansowana opcja, którą można pominąć.

5:38Jednocześnie też gorąco zachęcam Cię do tego, aby w momencie projektowania własnej

5:42aplikacji, gdy tylko coś nie będzie dla Ciebie jasne, to w takich sytuacjach warto

5:46sięgnąć do dokumentacji i zobaczyć opisy, które przygotował tutaj zespół Integromat'u,

5:51które w mojej opinii stanowią naprawdę dobrą dokumentację, ponieważ za każdym

5:55razem, gdy do niej sięgam, otrzymuję odpowiedź na moje zapytanie.

5:59Jedyną rzeczą jest tak naprawdę skorzystanie z wyszukiwarki i wpisanie

6:03słowa kluczowego, na którego temat chcemy dowiedzieć się więcej.

6:06Wracając jednak do możliwości tworzenia aplikacji.

6:09Kolejną zakładką jest zakładka modułów,

6:12która jak sama nazwa wskazuje umożliwia tworzenie nowych modułów.

6:15Tutaj w pierwszym kroku możemy wskazać ich typ i zwykle wybieramy tutaj akcję.

6:20Natomiast równie dobrze możemy tutaj wybrać opcję polling lub webhook, w

6:24przypadku którego podłączamy wcześniej zdefiniowany webhook.

6:27Natomiast w przypadku polling'u

6:29mamy tutaj do czynienia z akcją, którą możemy spotkać np.

6:33w WooCommerce.

6:34W momencie, gdy obserwujemy jakieś zdarzenia takie jak np.

6:37nowe zamówienia.

6:39Dodatkowo mamy tutaj również opcję search, która również jest dostępna tutaj.

6:43Oddzielona grupą dokładnie o takiej nazwie.

6:46Co prawda na nasze potrzeby nie musimy grupować

6:49w ten sposób naszych akcji, natomiast jest to wskazane, aby akcje

6:52odpowiedzialne za wyszukiwanie zasobów były umieszczone w tej grupie.

6:56Idąc dalej możemy tutaj skonfigurować

6:58połączenie, które jest wymagane dla danej akcji.

7:01Następnie mamy tutaj pole na nazwę i ta nazwa nie może zawierać spacji, więc jest

7:07bardziej wykorzystywana w celach programistycznych.

7:09Natomiast dla użytkownika możemy tutaj

7:11podać etykietę, która będzie wyświetlać się dokładnie na tej liście.

7:15Tak samo możemy podać pole opisu, które również zostanie wyświetlone na liście.

7:19Po dodaniu takiej akcji ponownie

7:21przechodzimy do kolejnego interfejsu, w przypadku którego musimy skonfigurować

7:26sposób połączenia a w zasadzie przesyłania danych.

7:29Zatem jak widzisz, konfiguruje tutaj

7:31obiekt połączenia zawierający informacje na temat tego, na jaki endpoint zostają

7:36wysłane dane oraz to jaką metodą jest to zrobione.

7:39Następnie mamy tutaj parametry query string oraz samo ciało zapytania i

7:44ewentualnie nagłówki oraz określenie struktury odpowiedzi.

7:48Następnie w drugiej zakładce, analogicznie jak pokazywałem wcześniej możemy ustawić

7:52parametry wymagane w przypadku konfiguracji tego modułu.

7:56Natomiast również w tym przypadku nie zdarzyło mi się z nich jeszcze skorzystać.

8:00Znacznie bardziej użyteczną zakładką jest

8:02zakładka Parameters, która umożliwia zdefiniowanie struktury,

8:06która pojawia się po wybraniu konkretnego modułu.

8:09Czyli np. jeżeli tutaj usuwamy sobie produkt, to możemy określić, że wymaganym

8:14parametrem jest tutaj podanie jego identyfikatora.

8:16Aby takie pole zostało tutaj wyświetlone,

8:19musimy po prostu określić obiekt JSON zawierający nazwę tego pola i jego typ,

8:24etykietę oraz to, czy ewentualnie jest wymagana.

8:28Oczywiście opcji, które mamy tutaj do dyspozycji jest znacznie więcej i

8:32szczegóły na ich temat znajdziemy w samej dokumentacji.

8:35Natomiast tymczasem to, co musisz jeszcze wiedzieć na temat konfiguracji modułów

8:39jest zakładka Interfejs, w ramach której możesz zdefiniować strukturę obiektu, w

8:43której użytkownik może spodziewać się po wykonaniu tego modułu.

8:47Coś takiego okazuje się niesamowicie

8:49przydatne na potrzeby sytuacji, w której mapujemy dane.

8:53Mianowicie, jeżeli taki interfejs zostanie zdefiniowany od razu po podłączeniu tego

8:58modułu, będziemy mieć dostęp do zdefiniowanych w tej zakładce właściwości.

9:02Z poziomu tego okienka mapowania wartości.

9:05Inaczej mówiąc obiekty, które zdefiniujesz

9:07tutaj zostaną wyświetlone jako domyślne wartości dostępne w mapowaniu.

9:12Oczywiście coś takiego nie jest wymagane,

9:14ponieważ po wykonaniu modułu otrzymujemy dane, które możemy podłączyć, natomiast z

9:18całą pewnością ułatwia to korzystanie z tego modułu.

9:22Dodatkowo to na co muszę zwrócić Twoją

9:24uwagę to fakt, że tutaj nie musisz tworzyć samodzielnie.

9:27Wystarczy, że posiadasz obiekt JSON,

9:30który chcesz przerobić na taki interfejs i po kliknięciu generuj otrzymujesz

9:34strukturę, którą możesz wkleić do tamtego pola.

9:37Dzięki temu możesz zaoszczędzić mnóstwo czasu przy projektowaniu własnych modułów.

9:42No i teraz ostatnią zakładką, którą tutaj mamy jest zakładka Samples umożliwiająca

9:47przekazanie przykładowego obiektu, który może zostać zwrócony z Twojego modułu.

9:52Jest to dodatkowe ułatwienie w momencie korzystania z tego modułu ze względu na

9:56to, że w takiej sytuacji oprócz możliwości mapowania

9:59poszczególnych właściwości.

10:01Będziesz mieć również podgląd tych

10:03domyślnych wartości, które zostały zdefiniowane właśnie w tym miejscu.

10:07I tak naprawdę w tym momencie doszliśmy do

10:09momentu, w którym wiesz wszystko na temat przygotowywania własnych modułów.

10:13Mamy tutaj jeszcze dodatkowe zakładki,

10:15takie jak zdalne procedury, które również są zaawansowanym tematem oraz możliwość

10:19grupowania poszczególnych modułów wykorzystując ich nazwy.

10:23Takie grupowanie również ułatwia

10:24późniejsze wchodzenie w interakcję z Twoim modułem.

10:27To na co muszę jeszcze zwrócić Twoją uwagę

10:29przed zakończeniem tej lekcji, to to, aby zachęcić Cię do tego, aby przejrzeć

10:33aplikacje, które zostały zdefiniowane tutaj.

10:36Szczerze mówiąc, nie jestem pewien, dlaczego akurat wyświetlają się tutaj

10:39niektóre aplikacje, natomiast z całą pewnością warto sobie podejrzeć np.

10:43to, w jaki sposób Dropbox obsługuje

10:46kwestię podstawowych ustawień, połączenia, czy konfiguracji poszczególnych modułów.

10:50Wielokrotnie zdarzyło mi się skorzystać z

10:52przeglądania tych akcji do tego, aby konfigurować własne moduły.

10:56Wystarczy po prostu odszukać analogiczną akcję, którą chcemy wykonać, a następnie

11:01podejrzeć, w jaki sposób jest ona zrealizowana w przypadku np.

11:04Dropboxa. Zatem jeżeli chodzi o teorię tworzenia

11:07własnych modułów Integromacie, to byłoby już na tyle.

11:10Zatem dziękuję Ci za uwagę i zapraszam do kolejnej lekcji.