La maggior parte delle automazioni parte da un evento nel tuo salone. Due trigger no: Webhook avvia un'automazione quando un altro sistema invia una richiesta al suo URL, per esempio un modulo sul tuo sito web. Manuale la avvia quando fai clic su Esegui.
Prima di iniziare
- Ti serve il ruolo Super amministratore o Proprietario.
- Il tuo salone deve avere un abbonamento attivo.
- Crea un'automazione da zero. Vedi Crea un'automazione da zero.
Avvia un'automazione da un webhook
- 1
Passaggio 1 di 4
Scegli il trigger Webhook
Fai clic sul passaggio Avvia automazione. Fai clic sul campo Trigger, scegli Altro, poi Webhook.
Vedrai:La finestra mostra un URL del webhook con un pulsante di copia.
- 2
Passaggio 2 di 4
Proteggi l'URL con una condizione
L'URL del webhook è pubblico. Chiunque lo abbia può avviare l'automazione, quindi aggiungi una Condizione che solo il tuo sistema può soddisfare, per esempio un header segreto.
Usa la scheda Builder, oppure scrivi un'espressione nella scheda Espressione, come
{{ $request.headers.authorization === "Bearer your-secret" }}. I nomi degli header sono in minuscolo. L'automazione parte solo quando l'intera condizione è vera.Fai clic su Salva, poi su Salva in alto nell'editor. Le modifiche al trigger hanno effetto solo dopo aver salvato l'automazione.
- 3
Passaggio 3 di 4
Usa i dati della richiesta nei tuoi passaggi
La richiesta è disponibile nel gruppo di variabili Richiesta:
{{ $request.body.phoneNumber }}: un campo del corpo della richiesta{{ $request.query.source }}: un parametro di query, da?source=...nell'URL{{ $request.headers.authorization }}: un header{{ $request.method }}: il metodo HTTP
Per esempio, usa
{{ $request.body.emailAddress }}come destinatario di un passaggio Invia notifica. - 4
Passaggio 4 di 4
Invia una richiesta
Dal tuo altro sistema, invia all'URL del webhook una richiesta POST con un corpo JSON o di modulo.
Vedrai:La risposta ha stato 202 e un
executionId. È vuoto quando la condizione non è stata soddisfatta. L'esecuzione compare nella Cronologia dell'automazione.
Limiti ed errori del webhook
- Ogni webhook accetta fino a 60 richieste al minuto e 1.000 all'ora. Le richieste oltre il limite vengono rifiutate.
- Se l'automazione è disattivata, la richiesta viene rifiutata con un messaggio che indica che l'automazione non è attiva.
- Se l'abbonamento del tuo salone non è attivo, la richiesta viene rifiutata.
- I cookie e gli header di sessione di Softalon non vengono passati all'automazione.
Avvia un'automazione manualmente
- 1
Passaggio 1 di 2
Scegli il trigger Manuale
Fai clic sul passaggio Avvia automazione. Fai clic sul campo Trigger, scegli Altro, poi Manuale. Salva il passaggio e l'automazione.
- 2
Passaggio 2 di 2
Eseguila
Nella pagina Automazioni, apri il menu sulla scheda dell'automazione e fai clic su Esegui. L'opzione compare solo per le automazioni con il trigger Manuale, e l'automazione deve essere attiva.
Vedrai:Un messaggio Workflow avviato. L'esecuzione compare nella Cronologia.
Un'esecuzione manuale non ha un evento, quindi sono disponibili solo le variabili Altro, come il nome del tuo salone. I destinatari devono essere indirizzi fissi, come la tua email.
Domande frequenti
No. L'URL del webhook accetta solo richieste POST.