Chiama un servizio collegato
I servizi collegati vengono invocati dalle azioni lato client dell’assistente (un modulo collegato al proxy o un’azione di template personalizzata) usando l’helper executeProxyRequest:
executeProxyRequest(id, body, callback, params)id: il Service ID che hai registrato.body: il payload JSON da inviare. Viene usato come corpo della richiesta perPOSTePUT;
le richieste GET e DELETE vengono inviate senza corpo.
callback: riceve la risposta dell’endpoint così la tua azione può mostrarla.params(facoltativo): valori che compilano i segnaposto{{params.x}}nell’URL e negli
header del servizio. Vedi Passa valori dinamici.
Da un modulo
Per un modulo il cui scopo è chiamare un endpoint, collega il suo invio a sendProxyForm, che serializza i campi e chiama executeProxyRequest per te:
sendProxyForm(proxyId, event, callback)Passa il Service ID come proxyId. I campi inviati diventano il corpo della richiesta e la risposta viene aggiunta alla conversazione. Vedi Moduli dell’assistente per creare il modulo e Personalizzazione avanzata per collegarne il gestore.
Da un’azione personalizzata
In un helper di template personalizzato puoi chiamare direttamente executeProxyRequest(id, body, callback), ad esempio per recuperare dati quando l’utente fa clic su un pulsante, e usare la risposta per aggiornare la conversazione. L’helper è documentato in Personalizzazione avanzata.
Documenti correlati
- Personalizzazione avanzata: helper, azioni e template.
- Moduli dell’assistente: raccogli gli input necessari alla chiamata di un servizio.