Knowledge base GetMyBot

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:

DirezioneChi avvia lo scambioEsempio
Webhook in entrataUn altro servizio informa GetMyBot e avvia una reazioneSul sito arriva una richiesta e il bot avvisa un responsabile
Richiesta web in uscitaLa reazione interroga un altro servizio e riceve una rispostaIl 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, PATCH o DELETE), 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