Richieste web e webhook
Avvia il bot da un evento del sito e interroga altri servizi da una reazione. Impostazioni delle richieste in entrata e in uscita.
In questa pagina
Un sito può informare il bot di una nuova richiesta; il bot può a sua volta interrogare il sito sullo stato di un ordine. Sono due direzioni diverse:
| Direzione | Chi avvia lo scambio | Esempio |
|---|---|---|
| Webhook in entrata | Un altro servizio informa GetMyBot e avvia una reazione | Sul sito arriva una richiesta e il bot avvisa un responsabile |
| Richiesta web in uscita | La reazione interroga un altro servizio e riceve una risposta | Il bot richiede prezzo o stato dell'ordine al sito |
Un webhook è una notifica automatica da un servizio a un altro. Entrambe le direzioni usano HTTP, lo stesso protocollo con cui il browser accede ai siti. Per le connessioni già pronte vedi Integrazioni.
Webhook in entrata (trigger)
Il trigger «Richiesta web in entrata (webhook)» avvia una reazione tramite una richiesta HTTP dall'esterno:
- Indirizzo: attiva il trigger e salva la reazione. Dopo il salvataggio GetMyBot genera l'URL del webhook e lo mostra in questo campo. Puoi copiarlo, ma non modificarlo.
- Token segreto: impedisce agli estranei di avviare la reazione tramite l'indirizzo.
- Metodo:
POST/GET/PUT/ANY.
I campi della richiesta arrivata vengono salvati nei dati temporanei della reazione (ctx). Se il servizio invia order_id, per esempio, le azioni possono leggerlo con {{ctx.order_id}}. Dopo la configurazione invia una richiesta di prova e controlla che la reazione riceva i campi necessari.
Richiesta web in uscita (azione)
L'azione «Richiesta web» esegue una richiesta HTTP dalla reazione:
- metodo (
GET,HEAD,OPTIONS,POST,PUT,PATCHoDELETE), intestazioni e corpo (JSON o testo); - codici di successo, timeout e numero di tentativi in caso di errore;
- salvataggio della risposta in un parametro dell'utente o nei dati temporanei (
ctx); JSONPath indica il campo della risposta da leggere; - modalità asincrona: il bot continua la reazione senza attendere la risposta del servizio. Una reazione distinta può gestire successo o errore.
Azioni correlate: «Carica URL» (scarica il testo di una pagina in ctx) e «Richiesta alla sorgente» / «Scrittura nella sorgente» per connettori salvati — vedi Sorgenti e chiavi.
Integrazione webhook
Per inviare regolarmente dati allo stesso servizio, configura l'integrazione «Webhook». Indica l'URL e una firma HMAC, che permette al destinatario di verificare il mittente. Vedi Integrazioni.
Sicurezza
Imposta un token segreto per il webhook in entrata, così gli estranei non potranno avviare la reazione. Le richieste in uscita non possono raggiungere gli indirizzi privati della rete interna tramite la piattaforma. Questa protezione si chiama SSRF. Anche la dimensione della risposta è limitata.
Passo successivo
- Trigger — trigger del webhook in entrata.
- Azioni —
Richiesta web,Carica URL. - Sostituzioni e formule — dati della richiesta in
ctx.