Wix e agente vocale AI: dal modulo del sito alla chiamata

Con un'automazione di Wix ogni modulo inviato dal tuo sito crea un lead in Aptiva e fa partire la chiamata dell'agente vocale AI. La chiamata parte appena il contatto arriva ad Aptiva; quanto tempo passa fra l'invio del modulo e quel momento lo decide l'automazione di Wix.

L'automazione chiama le API di Aptiva con l'azione di Wix «Invia una richiesta HTTP». Le richieste sono due: una crea il lead, una avvia la chiamata. Il meccanismo è lo stesso della guida sul webhook, con una differenza: Wix non permette di impostare header, quindi la chiave API va nell'indirizzo.

Che cosa ti serve#

1. Un modulo sul tuo sito Wix che chieda almeno il numero di telefono. Se non ce l'hai, crealo prima di cominciare.
2. La chiave API di Aptiva, che leggi nel pannello: menu utente in basso a sinistra, voce «Mostra API Key».
3. L'ID dell'agente che farà la chiamata: è il numero accanto al suo nome nella pagina «Agenti», nella forma #42. L'agente deve essere in uscita, con un numero attivo.

Ingrandisci

Nel pannello, alla pagina Wix delle integrazioni, c'è la stessa procedura con le schermate di Wix e i valori pronti da copiare.

Perché la chiave API sta nell'indirizzo#

Di solito la chiave API viaggia nell'header X-API-Key della richiesta. L'azione di Wix «Invia una richiesta HTTP» non permette di aggiungere header. Per questi strumenti Aptiva accetta la chiave anche nell'indirizzo, nel parametro api_key:

https://api.aptiva.cloud/external/api/leads/create?api_key=<LA_TUA_CHIAVE>

È una forma prevista, non un ripiego. Aptiva nasconde il valore del parametro nei propri registri. Ricorda però che l'indirizzo, con la chiave, resta scritto nell'automazione: chi può modificare le automazioni del sito può leggerla.

L'automazione, passo per passo#

1. Il trigger: il modulo inviato#

In Wix crea una nuova automazione e scegli il trigger:

• «Modulo inviato», se vuoi chiamare chi invia un modulo preciso: scegli il modulo;
• «Creazione di un nuovo contatto», se il modulo crea già un contatto in Wix e vuoi chiamare ogni contatto nuovo.

2. La richiesta che crea il lead#

Dopo il trigger aggiungi un'azione e cerca «Invia una richiesta HTTP». Configurala così:

• metodo: POST;
• indirizzo: https://api.aptiva.cloud/external/api/leads/create?api_key=<LA_TUA_CHIAVE>, con la tua chiave al posto di <LA_TUA_CHIAVE>;
• corpo: scegli i campi uno per uno, con l'opzione dei campi personalizzati, e collega ciascun nome di Aptiva al campo del modulo.

I nomi vanno scritti esattamente così, maiuscole comprese: Aptiva rifiuta i campi che non conosce. Per lo stesso motivo il corpo non va annidato sotto data: se Wix mostra l'opzione che annida il corpo, tienila spenta. Non usare l'opzione che invia tutti i dati dell'automazione: conterrebbe campi che Aptiva non conosce.

Poi salva i dati di risposta. Aptiva risponde con l'identificativo del lead creato, in questa forma:

{
  "id": 1285
}

Incolla questo esempio nella struttura della risposta, guarda l'anteprima e salva. Da qui l'automazione conosce id e lo può usare nel passo successivo.

3. La richiesta che avvia la chiamata#

Aggiungi un'altra azione «Invia una richiesta HTTP», dopo quella che crea il lead:

• metodo: POST;
• indirizzo: https://api.aptiva.cloud/external/api/calls/start/{LEAD_ID}?agent_id={AGENT_ID}&api_key=<LA_TUA_CHIAVE>.

Nell'indirizzo sostituisci tre cose:

1. {LEAD_ID} con la variabile id salvata dal passo 2;
2. {AGENT_ID} con l'ID numerico del tuo agente, per esempio 43;
3. <LA_TUA_CHIAVE> con la tua chiave, come nel passo 2.

Se la persona ha appena chiesto di essere chiamata, puoi aggiungere in fondo all'indirizzo &force=true: la chiamata parte subito anche se il contatto era già stato chiamato. Senza, con l'impostazione predefinita dei richiami, un contatto già chiamato prende il posto successivo della cadenza. Per un contatto nuovo la chiamata parte subito in ogni caso.

4. La prova#

Attiva l'automazione e compila il modulo del sito con il tuo numero di telefono, non con quello di un cliente: la chiamata è vera. Il tuo telefono squilla, e nel pannello trovi il lead fra i contatti e la chiamata fra le chiamate.

Se qualcosa non va#

Se il lead non compare in Aptiva, controlla:

1. la chiave nell'indirizzo, copiata per intero, nelle due richieste;
2. i nomi dei campi, scritti come nella tabella, e nessun campo in più;
3. il telefono: un numero senza prefisso internazionale è letto come italiano, uno non valido fa rifiutare la richiesta;
4. l'email vuota: se il modulo la rende facoltativa, Aptiva rifiuta una stringa vuota.

Se il lead compare ma la chiamata non parte, controlla la seconda richiesta: la variabile al posto di {LEAD_ID} e l'ID di un agente in uscita attivo. I codici d'errore che Aptiva restituisce sono nella guida introduttiva alle API.

Aptiva chiama i contatti che le indichi e presume che tu abbia il consenso di ciascuno: raccoglierlo spetta a te. Nel modulo conviene scrivere che la persona sarà chiamata subito; i testi pronti sono nella guida sul consenso alle chiamate.

Prossimi passi#

1. Scrivi lo script dell'agente: che cosa dire a chi ha appena compilato il modulo, quali domande fare.
2. Rivedi i richiami che Aptiva fa da sola verso chi non risponde, nella guida su quante volte e quando Aptiva richiama un lead.
3. Per gli altri strumenti guarda la mappa delle integrazioni.