Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduzione

Le notifiche vocali ti permettono di effettuare chiamate automatizzate con agenti virtuali. Questo endpoint ti consente di inviare chiamate vocali con agenti alimentati dall’AI ai tuoi contatti, fornendo un’esperienza vocale personalizzata.

​
📞 Invia notifica vocale

Per inviare una notifica vocale tramite l’API di Lovi, effettua una richiesta POST all’endpoint vocale con i parametri necessari e l’autenticazione.
Metodo: POST Formato: JSON

​
Endpoint

POST https://cloud.lovi.ai/functions/v1/notify/voice?access_key={YOUR_ACCESS_KEY}

​
Parametri di query

ParametroObbligatorioDescrizione
access_keySìLa tua chiave di accesso API unica.
unflattenNoSe impostato su true, il corpo deve contenere variabili piatte (nessun oggetto annidato). Se impostato su false o omesso, il corpo può contenere oggetti annidati.
URL di esempio: 
POST https://cloud.lovi.ai/functions/v1/notify/voice?access_key=your-api-key&unflatten=true
ChiaveValoreObbligatorioDescrizione
Content-Typeapplication/jsonSìIndica che il corpo della richiesta è in formato JSON.
Nota: L’autenticazione è gestita tramite il parametro access_key nell’URL, non tramite gli header.

​
Corpo della richiesta

Il corpo della richiesta contiene i dettagli della notifica vocale.

​
Struttura con oggetti annidati (unflatten=false o omesso)

{
  "contact": {
    "number": "34666033135",
    "first_name": "María",
    "last_name": "González",
    "email": "maria@email.com",
    "titulacion": "Técnico en Enfermería",
    "fuente_cliente": "Web Principal"
  },
  "recipient_id": "34911670470",
  "agent_id": "uuid-agente-voz",
  "notification_type": "marketing",
  "campaign_name": "Llamada Informativa Q4",
  "name_event": "info-curso-enfermeria",
  "datetime_sending": "2024-12-25T09:00:00",
  "timezone": "Europe/Madrid"
}

​
Struttura con variabili piatte (unflatten=true)

{
  "contact.number": "34666033135",
  "contact.first_name": "María",
  "contact.last_name": "González",
  "contact.email": "maria@email.com",
  "contact.titulacion": "Técnico en Enfermería",
  "contact.fuente_cliente": "Web Principal",
  "recipient_id": "34911670470",
  "agent_id": "uuid-agente-voz",
  "notification_type": "marketing",
  "campaign_name": "Llamada Informativa Q4",
  "name_event": "info-curso-enfermeria",
  "datetime_sending": "2024-12-25T09:00:00",
  "timezone": "Europe/Madrid"
}

​
Parametri obbligatori

ParametroTipoDescrizioneEsempio
contact.numberStringNumero di telefono senza ’+’ o spazi"34666033135"
recipient_idStringID o numero di telefono del destinatario"34911670470"
agent_idStringIdentificatore unico dell’agente vocale"uuid-agente-voz"
notification_typeStringTipo per le analisi"marketing", "transactional"
campaign_nameStringNome identificativo della campagna"Voice Campaign Q4"

​
Parametri opzionali

ParametroTipoDescrizioneEsempioDefault
contact.first_nameStringNome del contatto"María"-
contact.last_nameStringCognome del contatto"González"-
contact.emailStringEmail del contatto"maria@email.com"-
name_eventStringEvento per attivare flussi"info-curso-enfermeria"-
datetime_sendingDateTimeData/ora programmata (ISO 8601)"2024-12-25T09:00:00"Immediato
timezoneStringFuso orario per la programmazione"Europe/Madrid""UTC"
Campi personalizzati del contatto: Puoi includere qualsiasi campo aggiuntivo nell’oggetto contact per la personalizzazione (es. titulacion, fuente_cliente, ecc.).

​
Risposta

Quando la richiesta ha successo, la risposta conterrà: 
{
  "success": true,
  "message": "Voice notification queued successfully",
  "notification_id": "uuid-notification",
  "scheduled_time": "2024-12-25T09:00:00Z"
}

​
Funzionalità specifiche per la voce

  • Agenti alimentati dall’AI: Usa agenti virtuali con sintesi vocale naturale
  • Personalizzazione: Includi dati del contatto personalizzati per chiamate personalizzate
  • Programmazione: Programma le chiamate per orari specifici con supporto fuso orario
  • Trigger di eventi: Attiva flussi di conversazione specifici con name_event

​
Migliori pratiche

  • Tempistica: Programma le chiamate durante l’orario lavorativo per un miglior coinvolgimento
  • Personalizzazione: Includi informazioni di contatto rilevanti per un miglior flusso di conversazione
  • Selezione dell’agente: Scegli gli agenti appropriati in base al caso d’uso (vendite, supporto, ecc.)
  • Conformità: Assicurati che le chiamate siano conformi alle normative locali e ai requisiti di consenso

​
📚 Suggerimenti per lo sviluppo vocale

  • Includi sempre agent_id per le notifiche vocali
  • Usa le funzionalità di programmazione per rispettare i fusi orari
  • Testa con agenti di sviluppo prima della produzione
  • Monitora i tassi di completamento delle chiamate e regola la tempistica di conseguenza