Variabele

Onthoudt een waarde onder een naam, om ze verderop in het plan te hergebruiken door die naam tussen dubbele accolades te schrijven. Dit is de basis van de geavanceerde modules.

In het kort

Uitgangen	één, zonder label
Velden	Naam, Type, dan Waarde of Elementen (één per regel)
Voorgestelde types	Tekst en Lijst, Tekst standaard
Standaard beschikbare variabelen	8, zonder iets te moeten configureren
Levensduur	de lopende oproep, en enkel die
Hoofdlettergebruik van de naam	zonder belang: `{{DATETIME}}` en `{{datetime}}` duiden hetzelfde aan

De hulptekst die in het venster wordt getoond, is: « Definieert een variabele, herbruikbaar via {{naam}} in de andere modules. »

Hoe het werkt

Wat een variabele is

Een variabele is een etiket geplakt op een waarde. U geeft haar een naam, bijvoorbeeld taal, en een waarde, bijvoorbeeld nl. Overal elders in het plan komt {{taal}} schrijven neer op nl schrijven.

Het belang zit niet in het besparen van typwerk: het is dat de waarde van de ene oproep naar de andere kan veranderen. Het nummer van de beller, wat hij op het toetsenbord heeft ingetoetst, de naam gevonden in uw Odoo zijn variabelen. U bouwt één enkel plan dat zich anders gedraagt naargelang wat het onderweg ontdekt.

Een variabele leeft zolang een oproep duurt. Twee gelijktijdige oproepen hebben elk hun eigen variabelen, zonder elkaar te hinderen, en er wordt niets bewaard van de ene oproep naar de volgende.

Waar u het schrijft

Overal waar een veld tekst aanvaardt: de URL en de body van een API-verzoek, de Args van een Odoo-query, de bestemmeling en de tekst van een Notificatie, de tekst van een Caller ID, de operanden van een Conditie (Als), de expressie van een Switch / Case, het bericht van een Debug, de bestemming van een Bellen. Het veld Waarde van deze module aanvaardt het ook: een variabele kan worden opgebouwd vanuit een andere.

Een onbekende naam wordt niet gemeld: hij wordt door leegte vervangen, zonder de minste waarschuwing. Dit is de meest voorkomende verklaring voor een bericht dat halfgeschreven aankomt.

De variabelen die zonder enige configuratie beschikbaar zijn

Naam	Wat ze bevat
`caller`	het nummer van de beller, zoals het ons wordt doorgegeven
`caller_name`	de naam van de beller, wanneer de operator die doorgeeft
`callee`	het nummer gekozen binnen de installatie
`did`	het nummer dat de oproep heeft ontvangen
`tenant`	de korte naam van uw installatie
`domain`	het SIP-domein van uw installatie
`datetime`	de datum en het uur, in de tijdzone van uw installatie
`datetime_utc`	dezelfde datum en hetzelfde uur, in universele tijd

Daar komen, naarmate het plan vordert, nog bij: die welke u met deze module instelt, die van een DTMF-invoer, de zes van Odoo, contactopzoeking, en de extracties van een API-verzoek of een Odoo-query.

Een negende variabele, caller_e164, bevat de mogelijke schrijfwijzen van het nummer van de beller. Ze dient voor het filter van een Odoo-query en heeft elders weinig nut.

Wat u moet invullen

Veld	Wat wordt verwacht	Als u het leeg laat
Naam	een korte naam, in niet-geaccentueerde letters, cijfers en liggend streepje	de variabele wordt niet aangemaakt, de module doet niets en de oproep zet haar weg voort
Type	Tekst voor een unieke waarde, Lijst voor een reeks	Tekst
Waarde	de inhoud, die zelf `{{een_andere}}` kan bevatten	de variabele bestaat, met een lege waarde
Elementen (één per regel)	één waarde per regel, in Lijst	de lijst is leeg; lege regels worden genegeerd

Stap voor stap

Plaats de module Variabele en verbind de vorige node met haar ingang.
Open hem en voer de Naam in, bijvoorbeeld taal. Onthoud ze precies zo, u zult ze elders nodig hebben.
Kies het Type. Tekst in de grote meerderheid van de gevallen; Lijst als u een reeks wilt die u verderop test met de operator « is in (lijst) » van een Conditie (Als).
Vul de Waarde in, of de Elementen, één per regel.
Klik op Opslaan.
Verbind de uitgang van de module met het vervolg van het plan: een uitgang die nergens naartoe leidt, hangt de oproep op.
Voeg verderop in het plan {{taal}} in waar u het nodig hebt, bij voorkeur door het te kopiëren vanuit het paneel Beschikbare variabelen.
Plaats meteen erna een module Debug, met als bericht taal={{taal}}. U leest dan de werkelijke waarde in plaats van ze te veronderstellen.
Klik op Opslaan, en dan op Wijzigingen toepassen in de bovenste balk.
Bel uw nummer, open dan het Debuglogboek van het plan en controleer de geschreven waarde.

Als het niet werkt

Mijn variabele wordt verderop in het plan leeg weergegeven. Twee oorzaken, in deze volgorde. De oproep is niet door de module gegaan die haar instelt, omdat hij een andere tak heeft genomen. Of de naam tussen de accolades komt niet overeen met die van de module, op één letter na. Een onbekende naam wordt zonder foutmelding door leegte vervangen.

Ik heb een accent of een koppelteken in de naam gezet, en er komt niets uit. Enkel niet-geaccentueerde letters, cijfers en het liggend streepje worden herkend. Hernoem de variabele, en corrigeer dan alle plaatsen die ze gebruiken.

Mijn lijst wordt op één regel weergegeven, gescheiden door komma's. Dit is het verwachte gedrag: een Lijst die in een tekst wordt ingevoegd, wordt met komma's weergegeven. Een lijst dient om getest te worden, met de operator « is in (lijst) » van een Conditie (Als), eerder dan om te worden weergegeven.

De oproep wordt net na de module verbroken. Zijn enige uitgang is nergens mee verbonden. Een module waarvan de gebruikte uitgang nergens naartoe leidt, beëindigt de oproep.

De waarde klopt op het scherm maar niet aan de telefoon. Het opgeslagen plan is nog niet in dienst. Klik op Wijzigingen toepassen in de bovenste balk, en bel dan opnieuw.

Hoe het belplan wordt opgebouwd, uitgelegd in beelden

Bekijk de pagina Belplannen