In questa esercitazione, vedremo più da vicino come si possono integrare Tilda e AppMaster. Supponiamo che un certo modulo sia stato creato in Tilda e che il nostro compito sia quello di garantire che i dati, una volta compilati, arrivino a AppMaster, vengano elaborati e memorizzati nel database.
Creare webhook in AppMaster
Tilda invia dati a servizi di terze parti tramite un webhook. Pertanto, vale la pena iniziare con la creazione del webhook necessario e, prima di tutto, preparare il processo aziendale per il suo funzionamento.
Una caratteristica di questo processo è che non si sa in anticipo quali dati esatti verranno ottenuti. Il webhook lavorerà con "raw" richieste che devono essere elaborate correttamente. Per farlo, si utilizzerà il blocco Get Request Body . Vediamo quali dati provengono generalmente da Tilda, convertiamoli in String, scriviamoli nel log e visualizziamoli in risposta alla richiesta.
Nella sezione degli endpoint, creiamo subito un nuovo webhook. È importante notare che il tipo di richiesta deve essere Raw perché non ha parametri di input codificati ed è pronto ad accettare qualsiasi dato. È inoltre necessario disabilitare Middleware Token Auth perché per compilare un modulo in Tilda non è necessario passare attraverso l'autorizzazione in AppMaster e l'invio dei dati è aperto a tutti.
Tilda impostazione del modulo
Il passo successivo consiste nel collegare Tilda al webhook creato. Per farlo, nelle impostazioni dei moduli del sito, è sufficiente specificare l'URL, anche se, se necessario, è possibile utilizzare opzioni aggiuntive. Ad esempio, per una maggiore protezione, si può anche passare una chiave speciale, nel corpo della richiesta o nell'intestazione.
Se tutto è stato fatto correttamente, apparirà un messaggio corrispondente con la possibilità di collegare immediatamente questo webhook a tutti i moduli del sito.
Non resta che pubblicare la pagina con il modulo e testarlo in azione.
Aprendo i log di AppMaster, si può verificare che i dati del modulo siano stati effettivamente ricevuti.
Messaggio: “Email=test%40gmail.com&Name=John+Smith&Phone=%2B1-202-202-22-22&Comments=Hello%2C+world%21%0AThis+is+my+comment&tranid=6355139%3A3971256761&formid=form513738662”
È possibile vedere tutte le informazioni compilate nel modulo. Allo stesso tempo, diventa chiaro che i dati vengono ricevuti nel formato x-www-form-urlencoded formato, rispettivamente, non possono più essere elaborati come un insieme di dati grezzi, ma come una raccolta di singoli campi.
AppMaster modello di database
Non resta che creare il gestore giusto. Ed è meglio iniziare con un modello di database in cui saranno memorizzate tutte le informazioni.
Per un modulo standard, è sufficiente un semplice modello con 4 campi:
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
Successivamente, è necessario tornare al processo aziendale creato e modificarlo tenendo conto delle informazioni ricevute sulla composizione della richiesta.
I nomi dei campi della tabella da compilare saranno utilizzati come parametri di input. I dati provenienti da essi saranno utilizzati per creare un modello (Make Tilda) e poi scritti nel database (DB: Create Tilda).
L'ultima cosa da fare è modificare l'endpoint creato in precedenza per il webhook. Conosciamo il formato dei dati in arrivo e li elaboriamo, quindi l'opzione Request payload type deve essere Form. Allo stesso tempo, è necessario far corrispondere i parametri creati nel processo aziendale con i nomi esatti dei campi del modulo compilato (li abbiamo visti nei log quando abbiamo ricevuto i dati della richiesta come dati grezzi). In questo esempio, sono quasi uguali, ma differiscono nel caso del primo carattere.
Ora è possibile pubblicare l'applicazione creata e testarla in azione. Se si ripete la compilazione e l'invio del modulo in Tilda, allora i dati saranno inviati a AppMaster, scritti nel database, e questo può essere verificato usando Swagger.
