Dodatek WebHooks
Wstęp
Możesz użyć dodatku WebHooks , aby wysłać dane z formularzy do dowolnej niestandardowej strony lub skryptu. Na tej stronie można wykonywać zadania integracyjne w celu przekształcania, analizowania, manipulowania i wysyłania danych przesłanych w dowolne miejsce.
Jeśli tworzysz aplikację, która wymaga aktualizacji za każdym razem, gdy przesyłany jest formularz, WebHooks jest dla Ciebie. Zaletą WebHooks jest to, że przekazywanie danych jest natychmiastowe i można przekazać wszystkie przesłane dane z formularza na raz.
Co to jest element webhook?
WebHook to po prostu powiadomienie push z iform4u na inny serwer za każdym razem, gdy ktoś prześle Twoje formularze.
Co można zrobić z webhookiem?
WebHooks ułatwia integrację dwóch systemów. Najczęstszym zastosowaniem WebHooka jest wprowadzanie potencjalnych klientów do systemu CRM. Ale jest też wiele innych rzeczy, które możesz zrobić.
Czego potrzebujesz?
Sama natura elementu WebHook zakłada, że masz pewną umiejętność pisania kodu (lub przekupywania przyjaciela lub kolegi, który to robi). Musisz mieć serwer, który może zaakceptować żądanie POST (to, które otrzymasz po przesłaniu formularza) i być w stanie napisać skrypt, który zrobi coś w odpowiedzi.
Uwaga: iform4u obsługuje integrację wielu elementów WebHooks według formularza.
Utwórz element webhook
Aby utworzyć element WebHook, należy wykonać następujące kroki:
- Przejdź do Menedżera dodatków i kliknij WebHooks .
- Kliknij przycisk Utwórz webhook.
- Pojawi się formularz służący do konfiguracji WebHooka:
- Formularz : Wybierz formularz, który będzie wysyłał powiadomienia.
- Klucz uzgadniania : jest to opcjonalny klucz, który wybierasz jako mechanizm uwierzytelniania zapobiegający spamowaniu Twojego Web Hooka. Ten klucz zostanie dołączony jako parametr postu, gdy nasze serwery zadzwonią do Ciebie. Jeśli używasz tego klucza, powinieneś porównać go ze swoją kopią, aby sprawdzić, czy zgłoszenie jest prawidłowe.
- Url : adres URL, pod którym znajduje się Twój skrypt.
- Status: Może być:
- Włączone : wysyłaj powiadomienia
- Wyłączone : nie wysyła powiadomień
- Jsona: Może być:
- Włączone : wysyłaj dane jako ciąg JSON
- Wyłączone : Wyślij dane jako ciąg zakodowany w adresie URL
- Alias: Może być:
- Włączone : Wysyłaj dane z aliasem pola jako kluczem parametru. Np. Zastępuje „tekst_0” przez „nazwa”.
- Wył .: Wyślij dane z identyfikatorem pola jako kluczem parametru
- Kliknij Utwórz.
Uwaga: Wybierz wiele formularzy, aby utworzyć ten sam element WebHook dla każdego formularza.
Wyłącz/włącz element WebHook
Aby tymczasowo zatrzymać webhook, możesz wyłączyć go i włączyć później. Aby wyłączyć webhook formularza, wykonaj następujące kroki:
- Przejdź do Menedżera dodatków i kliknij WebHooks .
- Kliknij przycisk Akcje elementu WebHook, aby wyłączyć.
- Kliknij Aktualizuj.
- Zmień status z Włączony na Wyłączony lub odwrotnie.
- Kliknij Aktualizuj.
Usuń element WebHook
Aby usunąć element WebHook, należy wykonać następujące kroki:
- Zaznacz pole wyboru elementu WebHook, który chcesz usunąć.
- Kliknij Działania zbiorcze.
- Kliknij Usuń.
- Następnie wyświetli się wyskakujące okienko z prośbą o potwierdzenie decyzji o usunięciu elementu WebHook.
Menedżer WebHooks zostanie ponownie załadowany, a wybrany element WebHook zostanie usunięty.
Wyślij dane w formacie JSON
Aby wysłać dane postu jako ciąg JSON, musisz wykonać następujące kroki:
- Przejdź do Menedżera dodatków i kliknij WebHooks .
- Kliknij przycisk Akcje elementu WebHook, aby wyłączyć.
- Kliknij Aktualizuj.
- Zmień pole Json z Włączone na Wyłączone lub odwrotnie.
- Kliknij Aktualizuj.
Korzystanie z WebHooks
Teraz, gdy już wiesz, czym są WebHooks i jak ich używać w iform4u, zobaczmy przykład.
W tym poradniku będziemy wysyłać powiadomienia z jednego z naszych formularzy na stronę: Beeceptor. Ta strona przechwytuje nasze powiadomienia i drukuje je na ekranie.
Pierwsze kroki:
- Przejdź do https://beeceptor.com/
- Wprowadź nazwę punktu końcowego i
- Naciśnij przycisk Utwórz punkt końcowy
- Skopiuj adres URL punktu końcowego
Bardzo dobry! Wiedz, że masz adres URL, który będzie służył do otrzymywania powiadomień wysyłanych przez iform4u.
Kolejne kroki:
- Przejdź do iform4u
- Przejdź do Menedżera dodatków i zainstaluj WebHooks
- Teraz kliknij WebHooks .
- Kliknij przycisk Utwórz webhook.
- Wypełnij formularz:
- Formularz: Wybierz „Lista mailingowa”
- Adres URL: wklej adres URL punktu końcowego
- Klucz uzgadniania: W tym przykładzie: mój_klucz_handshake
- Stan: WŁ
- Kliknij Utwórz
Końcowe kroki: przetestuj swoje powiadomienia
- Przejdź do Menedżera formularzy
- Kliknij formularz „Lista mailingowa”.
- Kliknij przycisk Publikuj i udostępniaj (ikona zielonej strzałki)
- Kliknij łącze do formularza udostępniania
- Zaznacz opcję Bez i naciśnij przycisk Przejdź!
- Wypełnij formularz listy mailingowej i wyślij
Jeśli Twoje zgłoszenie zostanie przyjęte, pojawi się komunikat o powodzeniu.
Teraz przejdź do Endpoint Url (i bez odświeżania strony) zobaczysz, że powiadomienie zawiera:
- Identyfikator formularza
- Nazwa formularza
- Adres IP użytkownika
- Dane dotyczące przesłania
- Klucz do uścisku dłoni
I to wszystko! Wysłałeś swoje pierwsze powiadomienie na inny serwer. Gratulacje!
Zapisanie formularza Wypełnień w zewnętrznej bazie danych
Skoro już wiemy jak wyeksportować Formularz Wypełnień w czasie rzeczywistym do aplikacji zewnętrznej, zobaczymy jak możemy przechowywać te wypełnień w bazie danych.
Jeśli posiadasz stronę internetową, możesz wykonać poniższe kroki i zapisać Formularz Wypełnień naszego Demo Form we własnej bazie danych, wystarczy zmienić adres URL WebHooka.
Na Twojej własnej stronie internetowej:
1.- Utwórz bazę danych : ' test '. Możesz to zrobić za pomocą swojego ulubionego oprogramowania, takiego jak phpMyAdmin, lub także za pomocą następującego MySQL :
CREATE DATABASE 'test';
2.- Utwórz tabelę bazy danych : „ subskrybenci ” z 4 polami: identyfikator, imię i nazwisko, adres e-mail i adres . Możesz uruchomić następujące MySQL :
CREATE TABLE `test`.`subscribers` (
`id` INT(11) NOT NULL AUTO_INCREMENT ,
`name` VARCHAR(255) NOT NULL ,
`email` VARCHAR(255) NOT NULL ,
`ip_address` VARCHAR(255) NOT NULL ,
PRIMARY KEY (`id`)) ENGINE = InnoDB;
3.- Ustaw informacje w swojej bazie danych : „test”. PliksaveToDB.php
umożliwia skonfigurowanie następujących parametrów:
define('DB_SERVER', "localhost");
define('DB_USER', "root");
define('DB_PASSWORD', "");
define('DB_DATABASE', "test");
define('DB_DRIVER', "mysql");
4.- Prześlij plik @app/custom/saveToDB.php na swój serwer.
