Variabile
Memorizza un valore sotto un nome, per riutilizzarlo più avanti nel piano scrivendo questo nome tra doppie parentesi graffe. È la base dei moduli avanzati.
In breve
| Uscite | una sola, senza etichetta |
| Campi | Nome, Tipo, poi Valore o Elementi (uno per riga) |
| Tipi proposti | Testo e Elenco, Testo di default |
| Variabili disponibili di serie | 8, senza dover configurare nulla |
| Durata di vita | la chiamata in corso, e solo quella |
| Maiuscole/minuscole nel nome | irrilevanti: {{DATETIME}} e {{datetime}} indicano la stessa cosa |
Il testo di aiuto mostrato nella finestra è: « Definisce una variabile, riutilizzabile tramite {{nome}} negli altri moduli. »
Come funziona
Cos'è una variabile
Una variabile è un'etichetta attaccata a un valore. Le date un nome, ad esempio lingua, e un valore, ad esempio it. Ovunque altrove nel piano, scrivere {{lingua}} equivale a scrivere it.
L'interesse non è risparmiare battitura: è che il valore può cambiare da una chiamata all'altra. Il numero del chiamante, ciò che ha composto sulla tastiera, il nome trovato nel vostro Odoo sono variabili. Costruite un piano unico che si comporta in modo diverso a seconda di ciò che scopre lungo il percorso.
Una variabile vive per la durata di una chiamata. Due chiamate simultanee hanno ciascuna le proprie, senza disturbarsi a vicenda, e nulla viene conservato da una chiamata alla successiva.
Dove scriverla
Ovunque un campo accetti del testo: l'URL e il corpo di una Richiesta API, gli Args di una Richiesta Odoo, il destinatario e il testo di una Notifica, il testo di un Caller ID, gli operandi di una Condizione (Se), l'espressione di uno Switch / Case, il messaggio di un Debug, la destinazione di un Chiama. Anche il campo Valore di questo modulo lo accetta: una variabile può essere costruita a partire da un'altra.
Un nome sconosciuto non viene segnalato: viene sostituito dal vuoto, senza il minimo avviso. È la spiegazione più frequente di un messaggio che arriva scritto a metà.
Le variabili disponibili senza configurare nulla
| Nome | Cosa contiene |
|---|---|
caller | il numero del chiamante, così come ci viene trasmesso |
caller_name | il nome del chiamante, quando l'operatore lo trasmette |
callee | il numero composto all'interno dell'installazione |
did | il numero chiamato che ha ricevuto la chiamata |
tenant | il nome breve della vostra installazione |
domain | il dominio SIP della vostra installazione |
datetime | la data e l'ora, nel fuso orario della vostra installazione |
datetime_utc | la stessa data e ora, in tempo universale |
Si aggiungono, man mano che il piano procede: quelle che impostate con questo modulo, quella di un Inserimento DTMF, le sei di Odoo, risoluzione contatto, e le estrazioni di una Richiesta API o di una Richiesta Odoo.
Una nona variabile, caller_e164, contiene le possibili forme di scrittura del numero del chiamante. Serve al filtro di una Richiesta Odoo e non ha molto uso altrove.
Cosa inserire
| Campo | Cosa è previsto | Se lo lasciate vuoto |
|---|---|---|
| Nome | un nome breve, in lettere non accentate, cifre e trattino basso | la variabile non viene creata, il modulo non fa nulla e la chiamata prosegue il suo cammino |
| Tipo | Testo per un valore unico, Elenco per una lista | Testo |
| Valore | il contenuto, che può a sua volta contenere {{un_altro}} | la variabile esiste, con un valore vuoto |
| Elementi (uno per riga) | un valore per riga, in Elenco | la lista è vuota; le righe bianche vengono ignorate |
Procedura
- Posizionate il modulo Variabile e collegate il nodo precedente al suo ingresso.
- Apritelo e inserite il Nome, ad esempio
lingua. Ricordatelo esattamente, vi servirà altrove. - Scegliete il Tipo. Testo nella grande maggioranza dei casi; Elenco se volete una lista da verificare più avanti con l'operatore « è in (elenco) » di una Condizione (Se).
- Compilate il Valore, oppure gli Elementi uno per riga.
- Cliccate su Salva.
- Collegate l'uscita del modulo al seguito del piano: un'uscita che non porta da nessuna parte riaggancia la chiamata.
- Più avanti nel piano, inserite
{{lingua}}dove ne avete bisogno, preferibilmente copiandola dal pannello Variabili disponibili. - Posizionate un modulo Debug subito dopo, con come messaggio
lingua={{lingua}}. Leggerete il valore reale invece di supporlo. - Cliccate su Salva, poi su Applica le modifiche nella barra superiore.
- Chiamate il vostro numero, poi aprite il Registro di debug del piano e verificate il valore scritto.
Se non funziona
La mia variabile si mostra vuota più avanti nel piano. Due cause, in quest'ordine. La chiamata non è passata attraverso il modulo che la imposta, perché ha preso un altro ramo. Oppure il nome scritto tra parentesi graffe non corrisponde a quello del modulo, anche solo per una lettera. Un nome sconosciuto viene sostituito dal vuoto, senza errore.
Ho messo un accento o un trattino nel nome, e non esce nulla. Sono riconosciuti solo lettere non accentate, cifre e il trattino basso. Rinominate la variabile, poi correggete tutti i punti che la usano.
La mia lista si mostra su una sola riga, separata da virgole. È il comportamento previsto: un Elenco inserito in un testo viene restituito con le virgole. Un elenco serve a essere verificato, con l'operatore « è in (elenco) » di una Condizione (Se), piuttosto che a essere mostrato.
La chiamata si interrompe subito dopo il modulo. La sua uscita unica non è collegata a nulla. Un modulo la cui uscita presa non porta da nessuna parte termina la chiamata.
Il valore è corretto a schermo ma non al telefono. Il piano salvato non è ancora in servizio. Cliccate su Applica le modifiche nella barra superiore, poi richiamate.
Come si costruisce il piano di chiamata, spiegato con le immagini
Vedi la pagina Piani di numerazione