Effettuare una chiamata prima di elaborare un messaggio

Un webhook pre-messaggio effettua una chiamata a un servizio o un'applicazione esterna ogni volta che un cliente invia un input. Il servizio esterno può elaborare il messaggio prima che lo faccia l'assistente.

Aggiungi un webhook pre-messaggio al tuo assistente se desideri che il webhook venga attivato prima che ogni messaggio in arrivo venga elaborato dal tuo assistente.

Se si utilizza un canale personalizzato, il webhook pre-messaggio funziona solo con la versione 2 dell'API /message, stateless e stateful. Per ulteriori informazioni, vedi la Guida di riferimento API. Tutte le integrazioni di canale integrate utilizzano questa API.

È possibile utilizzare i webhook pre-messaggio per i seguenti casi d'uso:

  • Tradurre le informazioni fornite dal cliente nella lingua utilizzata dall'assistente.

  • Verificare ed eliminare eventuali informazioni personali identificabili, come un indirizzo e-mail o un numero di previdenza sociale che un cliente potrebbe inviare.

È possibile utilizzare questo webhook in coordinamento con il webhook post-messaggio. Ad esempio, il webhook post-messaggio può tradurre la risposta nella lingua del cliente o aggiungere nuovamente informazioni che sono state rimosse per motivi di privacy. Per ulteriori informazioni, consultare Fare una chiamata dopo l'elaborazione di un messaggio.

Per gli ambienti in cui si utilizzano endpoint privati, tenere presente che un webhook invia traffico su Internet.

Utilizzare un webhook di dialogo se si desidera eseguire un'azione una tantum quando è necessario durante una conversazione. Ad esempio, le condizioni sono soddisfatte quando l'assistente raccoglie tutti i dettagli richiesti, come il numero di conto, l'ID utente e il segreto del conto. Per ulteriori informazioni, vedere Esecuzione di una chiamata programmatica dalla finestra di dialogo.

Definizione del webhook

È possibile definire un URL webhook da utilizzare per la preelaborazione di ogni messaggio in arrivo.

Prima di iniziare

La chiamata programmatica al servizio esterno deve soddisfare i seguenti requisiti:

  • Non impostare e testare il proprio webhook in un ambiente di produzione in cui l'assistente viene distribuito e interagisce con i clienti.
  • La chiamata deve essere una richiesta POST HTTP.
  • Il corpo di richiesta deve essere un oggetto JSON (Content-Type: application/json).
  • La chiamata deve rientrare entro 30 secondi o meno.

Se il servizio esterno supporta solo le richieste GET o se è necessario specificare dinamicamente i parametri URL in fase di esecuzione, si può pensare di creare un servizio intermedio che accetti una richiesta POST con un payload JSON che contenga i valori in fase di esecuzione. Il servizio intermedio può quindi fare una richiesta al servizio di destinazione, passando questi valori come parametri URL, e restituire la risposta alla finestra di dialogo.

Scelta del metodo di distribuzione

Selezionare il metodo di distribuzione utilizzato per visualizzare i passaggi corretti per impostare un webhook pre-messaggio.

Per identificare il tipo di distribuzione in uso, fare clic sul menu Gestisci menu Gestisci. Se si vede Passare all'esperienza classica, si sta utilizzando la nuova esperienza. Se si vede Passare alla nuova esperienza, si sta utilizzando l'esperienza classica.

Utilizzate i seguenti link per conoscere le procedure in base al vostro tipo di distribuzione: