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_repeaterepeat_delayper 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_urlsiano 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.







