Introduzione
Le notifiche vocali permettono di raggiungere i clienti attraverso chiamate telefoniche automatizzate quando WhatsApp non è disponibile o preferibile. Questa guida copre l’implementazione completa delle notifiche vocali nell’API Lovi.📞 Funzionalità Base
Invio Notifica Vocale Semplice
Chiamata Base:Parametri Richiesti
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
contact.number | string | Numero telefono destinatario (solo numeri) | "34666033135" |
message | string | Testo da convertire in voce | "Il tuo ordine è pronto" |
voice | string | Identificatore voce da utilizzare | "it-IT-Standard-A" |
language | string | Codice lingua BCP-47 | "it-IT" |
🎵 Configurazione Voce
Voci Disponibili
Italiano:it-IT-Standard-A(Femminile, standard)it-IT-Standard-B(Maschile, standard)it-IT-Wavenet-A(Femminile, alta qualità)it-IT-Wavenet-B(Maschile, alta qualità)it-IT-Neural2-A(Femminile, neurale)it-IT-Neural2-B(Maschile, neurale)
es-ES-Standard-A(Spagnolo)fr-FR-Standard-A(Francese)de-DE-Standard-A(Tedesco)en-GB-Standard-A(Inglese britannico)en-US-Standard-A(Inglese americano)
Configurazioni Avanzate
Personalizzazione Voce:📋 Template Vocali
Creazione Template Vocale
Template Semplice:Utilizzo Template Vocali
Invio con Template:⏰ Programmazione Notifiche Vocali
Invio Programmato
Programmazione Semplice:📞 Gestione Chiamate
Stati Chiamata
| Stato | Descrizione |
|---|---|
queued | In coda per l’invio |
ringing | Squillando |
answered | Risposta dal destinatario |
completed | Chiamata completata con successo |
busy | Linea occupata |
no_answer | Nessuna risposta |
failed | Chiamata fallita |
Monitoraggio Chiamate
Stato Chiamata:🎯 Casi d’Uso
Assistenza Sanitaria
Promemoria Appuntamenti Medici:E-commerce
Conferma Ordini:Servizi di Emergenza
Allerte di Sicurezza:⚙️ Configurazioni Avanzate
Interattività
Chiamate Interattive:Callback e Webhook
Configurazione Callback:📊 Analisi e Ottimizzazione
Metriche Vocali
Statistiche Performance:Ottimizzazione Qualità
Test Qualità Voce:🚨 Limitazioni e Sicurezza
Limitazioni Tecniche
- Lunghezza Messaggio: Max 5000 caratteri
- Durata Chiamata: Max 10 minuti
- Rate di Chiamata: 10 chiamate simultanee per account
- Numeri Supportati: Solo numeri verificati
Considerazioni di Sicurezza
Privacy Dati:- Ottieni consenso esplicito prima delle chiamate
- Fornisci opt-out chiaro
- Registra tutte le interazioni vocali
- Elimina registrazioni dopo il periodo di retention
