Richieste web e webhook

GetMyBot si integra con sistemi esterni tramite HTTP in entrambe le direzioni: le richieste in entrata avviano le reazioni, mentre le azioni in uscita chiamano API di terze parti. Questo collega il bot a CRM, gateway di pagamento, form sul sito e qualsiasi servizio.

Webhook in entrata (trigger)

Il trigger «Richiesta web in entrata (webhook)» avvia una reazione tramite una richiesta HTTP dall'esterno:

  • Percorso — indirizzo del ricevitore (l'URL completo è formato dall'indirizzo del bot e dal percorso).
  • Token segreto — protegge l'endpoint da accessi non autorizzati.
  • Metodo — POST / GET / PUT / ANY.

I dati della richiesta (campi del form o corpo) entrano nel contesto di esecuzione e sono accessibili nelle azioni tramite {{ctx.campo}}. In questo modo un sito o un servizio può «spingere» un evento al bot — ad esempio, il pagamento è andato a buon fine → invia all'utente l'accesso.

Richiesta web in uscita (azione)

L'azione «Richiesta web» esegue una richiesta HTTP dalla reazione:

  • metodo (GET/POST/PUT/DELETE), intestazioni, corpo (JSON o form);
  • codici di successo, timeout e numero di retry in caso di errore;
  • salvataggio della risposta nel parametro o in ctx tramite JSONPath;
  • modalità asincrona (non bloccare la reazione) e avvio di reazioni in caso di successo/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 dati regolarmente a un unico servizio è più comodo configurare l'integrazione «Webhook» (URL + firma HMAC) — vedi Integrazioni.

Sicurezza

Gli endpoint in entrata sono protetti da un token segreto; le richieste in uscita passano attraverso la protezione anti-SSRF (non è possibile accedere alla rete interna) e la dimensione della risposta è limitata.

Passo successivo