Questa guida fornisce una panoramica dettagliata di tutte le possibili risposte (response) che possono essere inviate ad ai4call. Ogni risposta è un oggetto JSON con vari campi che controllano il comportamento del sistema.
Struttura Base della Risposta
{ "text": string, "action": string, "key": string, "next_url": string, "min_length": number, "max_length": number, "accept_timeout": number, "max_repeat": number, "repeat_delay": number, "accepted_commands": array, "extension": string, "language": string, "timezone": string }
Campi Comuni
1. text (string, obbligatorio)
- Descrizione: Il testo che ai4call riprodurrà all’utente usando la tecnologia Text-to-Speech (TTS).
- Limite: Massimo 4096 caratteri.
- Esempio:
"Benvenuto al nostro servizio clienti. Come posso aiutarti oggi?"
2. action (string, obbligatorio)
- Descrizione: Specifica l’azione che ai4call deve eseguire dopo aver riprodotto il testo.
- Valori possibili:
"ASR_string"
: Riconoscimento vocale generico"ASR_number"
: Riconoscimento di numeri"ASR_DTMF"
: Riconoscimento vocale o input DTMF"ASR_date"
: Riconoscimento di date"ASR_time"
: Riconoscimento di orari"ASR_command"
: Riconoscimento di comandi specifici"DTMF"
: Solo input DTMF"redirect"
: Reindirizzamento della chiamata"hangup"
: Chiusura della chiamata"none"
: Nessuna azione, solo riproduzione del testo- Esempio:
"action": "ASR_DTMF"
Esempi di Risposte Complete
1. Richiesta di Scelta Iniziale
{ "text": "Benvenuto al nostro servizio clienti. Premi 1 per prenotazioni, 2 per assistenza tecnica.", "action": "ASR_DTMF", "key": "scelta_menu", "next_url": "https://your-server.com/handle-menu-choice", "min_length": 1, "max_length": 1, "accept_timeout": 5000, "max_repeat": 3, "repeat_delay": 8000, "language": "it", "timezone": "Europe/Rome" }
Note Importanti
- Personalizzazione: Ogni risposta può essere altamente personalizzata per adattarsi alle esigenze specifiche del vostro flusso di chiamata.
- Gestione degli Errori: Utilizzate
max_repeat
erepeat_delay
per gestire situazioni in cui l’utente non fornisce un input valido. - Flessibilità: La combinazione di azioni ASR e DTMF permette di creare interfacce vocali intuitive che si adattano alle preferenze dell’utente.
- Sicurezza: Assicuratevi che le
next_url
siano protette e accessibili solo da ai4call per mantenere la sicurezza del vostro sistema. - Testing: È consigliabile testare approfonditamente ogni risposta per garantire un’esperienza utente fluida in tutti gli scenari possibili.
Utilizzando queste risposte in modo creativo e strategico, potete creare flussi di chiamata altamente interattivi e personalizzati con ai4call.