Widget di chat

Tutti gli endpoint utilizzati dal widget di chat integrato nel vostro sito web.

Il widget di chat integra il vostro chatbot nel vostro sito web. Questo gruppo descrive tutti gli endpoint utilizzati dal widget: verifica di disponibilità, configurazione pubblica del widget, invio di messaggi, cronologia della conversazione, recupero di nuovi messaggi (ad esempio dopo la presa in carico da parte di un collaboratore), valutazione, eventi di utilizzo, nonché input e output vocale.

`health` e `config` sono accessibili senza autenticazione affinché il widget possa inizializzarsi nel browser. Tutti gli altri endpoint richiedono il `widget_code` e il token di incorporamento del widget nell'header `X-Widget-Token`. Zentor crea il widget durante la configurazione, registra i domini autorizzati e vi fornisce il codice di incorporamento con il codice widget e il token di incorporamento. Il server rifiuta le chiamate da domini non autorizzati con 403 `WIDGET_ORIGIN_DENIED` e risponde alle chiamate per un widget disattivato con 404 `WIDGET_DISABLED`.

Si applicano inoltre le regole di accesso del vostro account (regole su IP, paesi e domini). `message` non è idempotente: ogni nuovo invio crea un nuovo messaggio e una nuova risposta.

GET/api/public/widget/healthGET/api/public/widget/config/:widget_codePOST/api/public/widget/messageGET/api/public/widget/historyPOST/api/public/widget/pollPOST/api/public/widget/ratingPOST/api/public/widget/trackPOST/api/public/widget/voice-transcribePOST/api/public/widget/voice-speak
← Riferimento API