Webhook

I webhook permettono all’assistente di interagire con sistemi esterni e integrarli nel tuo workflow. Con i webhook, l’assistente può recuperare informazioni aggiornate (ad es. dati cliente, prodotti disponibili o slot liberi) oppure inviare/trasmettere informazioni raccolte (ad es. dopo che un utente ha completato una transazione/prenotazione).

Come configurare i webhook

I webhook possono essere configurati direttamente all’interno di una funzione/azione attivando l’interruttore webhook e fornendo l’URL del webhook come mostrato di seguito:

Il bot vocale invierà quindi i parametri estratti come corpo della richiesta in una POST.

Post‑processing

Se il webhook è usato per recuperare dati, a volte è necessario trasformare i dati, ad es. filtrare elementi o formattare valori.

Se è necessario un post‑processing, il campo Post hook JS function call può essere usato per specificare il nome di una funzione da chiamare subito dopo che il webhook ha recuperato i dati.

Il parametro della funzione sarà il corpo della risposta del webhook: un oggetto JSON annidato se il corpo è un JSON valido; altrimenti una stringa (se il corpo non è stato parsato come JSON).

Esecuzione programmatica dei webhook

I webhook possono anche essere eseguiti programmaticamente da qualsiasi snippet di codice JavaScript in qualsiasi momento come segue:

function myFunction(params) {
    response = webhook("https://mydomain.com/apiEndpoint", {"sample": "data"});
    return response;
}

Parametri